Installing and configuring Web-based System Monitor

The Web-based System Monitor is a tool that allows you to monitor the IBM WebSphere InterChange Server Express system from the Web. It allows you to configure how you view data and also allows you to view historical data in addition to current data.

This chapter contains the following sections:

Installing Web-based System Monitor

If you installed WebSphere Application Server Express 5.0.2, the installer will automatically install and configure Web-based System Monitor on WebSphere Application Server. The application server created by the installer is called ICSMonitor.

The installation of WebSphere Application Server Express 5.0.2 does not include a Web server.

Note:
If you do not have a Web server currently installed and would like to install one, you can download IBM HTTP Server for free from IBM's Web site.You will also need to install the Web server plugin for WebSphere Application Server Express. See the WebSphere Application Server Express documentation for more information.
Therefore when the installer installs Web-based System Monitor, Web-based System Monitor is configured to use a default port number, 7089. If you would like to use a different port number and you do not currently have a Web server installed, follow the procedures in this section to configure Web-based System Monitor to use a different port number.

If you have a Web server installed and you have also installed the WebSphere Application Server Express Web server plugin, you can run a script to install Web-based System Monitor. Follow the procedures in this section to install Web-based System Monitor using an installation script.

Installing and configuring Web-based System Monitor to use a Web server

To install Web-based System Monitor using the installation script:

  1. Run ProdDir/bin/CWDashboard.sh with the following parameters:
  2. Stop the ICSMonitor Application Server from the command line:
    /opt/IBM/WebSphere/Express502/AppServer/bin/stopServer.sh ICSMonitor
     
  3. Start the Web-based System Monitor from the command line:
    /opt/IBM/WebSphere/Express502/AppServer/bin/startServer.sh ICSMonitor
     
  4. To access Web-based System Monitor:
    http://hostname/ICSMonitor
     

Configuring Web-based System Monitor to use a different port number

  1. Run ProdDir/bin/CWDashboard.sh with the following parameters:
  2. Stop the ICSMonitor Application Server from the command line:
    /opt/IBM/WebSphere/Express502/AppServer/bin/stopServer.sh ICSMonitor
     
  3. Start the Web-based System Monitor from the command line:
    /opt/IBM/WebSphere/Express502/AppServer/bin/startServer.sh 
     
  4. To access Web-based System Monitor:
    http://hostname:portnumber/ICSMonitor
     

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 ProdDir/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 catalina.sh file, located in Tomcat_home/bin.

    if ["$1" = "start"]; then ..... else "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS \ -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" \ -Dcatalina.base="$CATALINA_BASE" \ -Dcatalina.home="$CATALINA_HOME" \ -Djava.io.tmpdir="$CATALINA_TMPDIR" \ //append next lines -DDASHBOARD_HOME="$CATALINA_HOME"/webapps/ICSMonitor \ -DDASHBOARD_URL="http://Hostname:8080/ICSMonitor" \ //Don't use "localhost" here -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 \ org.apache.catalina.startup.Bootstrap "$@" start \ >> "$CATALINA_BASE"/logs/catalina.out 2>&1 &

    Where ${ORB_PORT} and ${ORB_HOST} match what is in ProductDir/bin/CWSharedEnv.sh, 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 CATALINA_HOME contains spaces, use quotes around the DASHBOARD_HOME value.
  6. If you are using DB2 for the ICS Repository, in the setclasspath.sh file append the path to the db2java.zip file to the classpath. The db2java.zip file is located by default under <DB2_Installation_Dir>/java.
  7. Change the port number in the Tomcat_home/conf/server.xml file. This step is optional.

    The default port number is 8080.

  8. Start Tomcat from the command line:
    Tomcat_home/bin/startup.sh
     

    Otherwise, the catalina.sh file is not called.

Copyright IBM Corp. 2003, 2004