Installing System Monitor

System Monitor is an application that runs within an application server and allows you to administer a WebSphere InterChange Server integration system over the web. System Monitor can run within WebSphere Application Server and Tomcat; for the supported versions of these application servers, see Software requirements.

Notes:

  1. If the machines running InterChange Server and System Monitor (within the application server) are not on the same subnet mask, you must add the host name of the machine running System Monitor to the /etc/hosts file on the machine running ICS.

  2. If you are using DB2 for the ICS Repository, and the DB2 server is not the same machine on which you are installing the System Monitor, you must install the DB2 client. This DB2 client must point to the ICS Repository instance.

Installing System Monitor in WebSphere Application Server 5.0.2 and 5.1

If you want to use WebSphere Application Server as the Application Server for System Monitor, you will need to install it separately. Follow the commands below to manually install System Monitor in WebSphere Application Server:

Note:
WebSphere Application Server must typically be run as root on UNIX platforms. You can run WebSphere Application Server as a non-root user, but must use the Lightweight Directory Access Protocol ( LDAP) for authentication in this case. For more information, see the documentation at http://www.ibm.com/software/webservers/appserv/infocenter.html.
  1. Run the CWDashboard.sh script located in the directory ProductDir/bin/ (where ProductDir is the installation directory of InterChange Server) with the following parameters: Here is an example command on a Solaris system using DB2:
    ProductDir/bin/CWDashboard.sh /opt/WebSphere/AppServer myhostname.ibm.com
    /opt/IBM/WebSphereICS /export/home/db2inst1/sqllib/java
    
    And here is an example command on a Solaris system using Oracle:
    ProductDir/bin/CWDashboard.sh /opt/WebSphere/AppServer myhostname.ibm.com
    /opt/IBM/WebSphereICS null
    
  2. Start the ICSMonitor Application Server: <WebSphere_Application_Server_installation_directory>/bin/startServer.sh ICSMonitor
  3. Access the System Monitor by typing the URL. For example, http://<Host_Name>/ICSMonitor

    where <Host_Name> is the name of the computer on which WebSphere Application Server is installed.

    Note:
    If you are using DB2 for the ICS Repository, you must run the db2profile before launching the System Monitor. The db2profile script is located in the sqllib directory of the database instance owner, for example, /db2i81_home_dir/db2i81/sqllib where db2i81_home_dir is the path for the db2i81 user's home directory.

Installing System Monitor in Tomcat

Do the following to install System Monitor in Tomcat, note that installation on Tomcat must be done manually:

Note:
In this section, <Tomcat_home> refers to the directory where Tomcat is installed.
  1. Create the ICSMonitor directory in the webapps directory of the Tomcat installation.
  2. Extract the contents of the CWDashboard.war file (found by default in the ProductDir/WBSM directory) into the directory created in step 1.
  3. Edit the setclasspath.sh file, located in the bin directory of the Tomcat installation.
    1. Set the JAVA_OPTS property as follows, where %ORB_PORT% and %ORB_HOST% match those in the ./bin/CWSharedEnv.sh file of the ICS you want to monitor:
      JAVA_OPTS="-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 to which the JAVA_OPTS parameter is set must be one continuous line, with spaces separating the individual -D options. The value will 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.
    2. If using DB2 for the ICS Repository, append the path to the db2java.zip file to the class path. The db2java.zip file is located by default under <DB2_Installation_Dir>/java.
  4. If you are using DB2 for the ICS Repository, you must run the db2profile before launching the System Monitor. The db2profile script is located in the sqllib directory of the database instance owner, for example, /db2i81_home_dir/db2i81/sqllib where db2i81_home_dir is the path for the db2i81 user's home directory
  5. Change the port number in the <Tomcat_home>/conf/server.xml file.

    This step is optional. The default port number is 8080.

  6. Start Tomcat from a command line.

Copyright IBM Corp. 1997, 2004