Configuring Web Deployment to use Tomcat

To configure Web Deployment to use Tomcat, follow these steps:

  1. Create the Web Deployment directory under Tomcat_home\webapps (where Tomcat_home is the path of the Tomcat installation in your environment).
  2. Extract the .war file contents into the WebDeployment directory.
    Note:
    If you used the WebSphere Business Integration Server Express or Express Plus installer to install the product, the WebDeployment.war file is located in the ProductDir\WBWD directory.
  3. Edit the setclasspath.bat file, located in the Tomcat_home\bin directory, by doing the following:
    1. Set the JAVA_OPTS property as follows:

      DWD_HOME=Tomcat_home\webapps\WebDeployment
    2. If you use DB2 for the InterChange Server Express repository, append the path to the db2java.zip file to the class path in setclasspath.bat. The db2java.zip file is located, by default, in the DB2_Installation_Dir\java directory.
    Note:
    Step 5b is required only if the repository is on DB2.
  4. (Optional) Change the port number in the Tomcat_home\conf\server.xml file.

    The default port number is 8080.

By default, security is enabled in the Tomcat 4.1.24 version of Web Deployment. A user with the role of administrator must be created in the Tomcat_home\conf\server.xml file so that the administrator can gain full access to the application. For details on how to create roles and use security in Web Deployment, refer to the System Administration Guide.

Important:
Tomcat must be started by double-clicking Tomcat_home\bin\startup.bat. Web Deployment will not work if Tomcat is started using the default Start Tomcat shortcut because the shortcut does not read the environment variables set in the ProductDir\bin\setclasspath.bat file.

Copyright IBM Corp. 2004, 2005