list
logo
Please be aware that there is newer version of documentation available for Webswing. Documentation 26.2

IBM WAS 9.0 Deployment

To deploy Webswing to WAS 9.0, follow these steps. The example below installs the distribution in /opt/webswing; use an absolute directory that is readable and writable by the WebSphere process on your system.

  1. Unzip the Webswing distribution to /opt/webswing. Do not remove this directory after deploying the WAR because Webswing uses its configuration and runtime files.
  2. In /opt/webswing/webswing.properties, set webswing.server.websocketUrl to the deployed Webswing context, for example ws://localhost:<port>/webswing-server. Replace the host, port, and context root if your WebSphere mapping differs.
  3. Go to IBM WAS Console http://localhost:9060/ibm/console
  4. Navigate in the menu to Applications>New Application>New Enterprise Application
  5. Click Choose File and select /opt/webswing/webswing-server.war.
  6. Next>Next>Next>Next>Next
  7. Configure Webswing JVM Properties in location: Servers>Server Types>WebSphere application servers>server1>Server Infrastructure, Java and Process Management, Process Definition>Java Virtual Machine>Custom Properties similarly to following:
webswing.warLocation=/opt/webswing/webswing-server.war
webswing.configFile=/opt/webswing/webswing.config
webswing.tempDirBase=/opt/webswing/tmp
webswing.rootDir=/opt/webswing

Properties 01 Properties 02

The demo configuration in the webswing-examples-eval distribution uses relative application paths. Adjust those paths for the WebSphere working directory.

In case of issues analyze the logfiles.