Installing System Monitor

The following instructions describe how to install System Monitor (WBSM) using WebSphere Application Server (WAS) 5.0.2.4 and 5.1 as the Web server. For instructions on installing System Monitor using Tomcat 4.1.24 or 4.1.27, see Installing System Monitor using Tomcat.

Installing System Monitor on WAS 5.0.2.4 or WAS 5.1:

If you installed WebSphere Application Server 5.0.2.4 or 5.1 before running the ICS installer, the installer program automatically installs and configures System Monitor. The application server created by the installer is called ICSMonitor.

To manually install System Monitor on WebSphere Application Server, follow these steps:

  1. Run the CWDashboard.bat script located in the directory WebSphereICS\bin\ with the following parameters:
  2. Start the ICSMonitor Application Server from the command line:

    C:\IBM\WebSphere\AppServer\bin\startServer.bat ICSMonitor

    Note:
    For WAS setups, stop the server if it is already running. Also stop the HTTP server too, if HTTP is being used.
  3. Start the HTTP server.
  4. Access the System Monitor by typing the URL.

    For example:

    http://HostName/ICSMonitor

    where HostName is the name of the computer on which WebSphere Application Server is installed.

Installing System Monitor using Tomcat

The following instructions describe how to install System Monitor using Tomcat.

  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 is located in the product_dir\WBSM directory.

  3. Edit the setclasspath.bat file, located in the Tomcat_home\bin directory.

    Tomcat requires that IBM JDK 1.4.2 is installed and that the property of JAVA_HOME is set. If JAVA_HOME is not set, Tomcat won't start. To set it local for Tomcat, add as the first line in setclasspath.bat:

    set JAVA_HOME=<path to jdk>
    

    For example:

    set JAVA_HOME=C:\jdk1.4.2 
    

    Set the JAVA_OPTS property as follows:

    -DDASHBOARD_HOME=Tomcat_home\webapps\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
    

    Note:
    The value for the JAVA_OPTS parameter must be one continuous line, with spaces separating the individual -D options. The values appear to have carriage returns in this document because of the formatting, but must be specified as a single line when you configure System Monitor.

    ORB_PORT and ORB_HOST must be replaced with the values found in ProductDir/bin/CWSharedEnv.bat file of the ICS you want to monitor.

    If you use DB2 for the ICS repository, append the path to the db2java.zip file to the classpath in setclasspath.bat. The db2java.zip file is located, by default, in the DB2_Installation_Dir\java directory.

    Note:
    This is required only if the ICS repository is on DB2.
  4. (Optional) Change the port number in the Tomcat_home\conf\server.xml file.

    The default port number is 8080.

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

Copyright IBM Corp. 1997, 2004