Configuring Tomcat to use Web-based System Monitor

If you plan to use Tomcat as your application server instead of WebSphere Application Server, follow the instructions in this section to configure Tomcat to use Web-based System Monitor.

To configure Tomcat to use Web-based System Monitor:

  1. Create the ICSMonitor 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 ICSMonitor directory. The CWDashboard.war file will be in the \WBSM directory.
  3. Copy the xerces.jar file from Tomcat_home\webapps\ICSMonitor\WEB-INF\lib to Tomcat_home\common\lib.
  4. Rename the xercesImpl.jar file, located in the Tomcat_home\common\endorsed directory to xercesImpl.jar.old.
  5. Edit the setclasspath.bat file, located in Tomcat_home\bin.

    Set the JAVA_OPTS property as follows:

    set JAVA_OPTS=-DDASHBOARD_HOME=<Tomcat_home>\webapps\ICSMonitor 
     -DDASHBOARD_URL=http://<HostName>[:PortNumber]/ICSMonitor 
     -DORBNamingProvider=CosNaming -Dorg.omg.CORBA.ORBClass=com.ibm.CORBA.iiop.ORB 
     -Dorg.omg.CORBA.ORBInitialPort=%ORB_PORT% 
     -Dorg.omg.CORBA.ORBInitialHost=%ORB_HOST% 
     -Dcom.ibm.CORBA.Debug.Output=stdout
     

    where %ORB_PORT% and %ORB_HOST% match what is in ProductDir/bin/CWSharedEnv.bat, HostName is the name of the computer on which Web-based System Monitor is running, PortNumber is the port number to be used, and Tomcat_home is the path and name of the Tomcat product directory.

    Note:
    If Tomcat_home contains spaces, use quotes around the DASHBOARD_HOME value.
  6. Change the port number in the Tomcat_home\conf\server.xml file. This step is optional.

    The default port number is 8080.

  7. Start Tomcat from the command line:
    Tomcat_home/bin/startup.bat
     

    Otherwise, the setclasspath.bat file is not called.

Copyright IBM Corp. 1997, 2003