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:
- 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.
- 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.
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.
- Run the CWDashboard.sh script located in the directory
ProductDir/bin/ (where ProductDir is the
installation directory of InterChange Server) with the following
parameters:
- Installation path for WebSphere Application Server 5.0.2 or
5.1
- Fully qualified host name of machine on which you are installing
- InterChange Server installation directory
- If using DB2 as the DBMS for the ICS repository, path to the
db2java.zip file
- If not using DB2 as the DBMS for the ICS repository, then use
"null" for this parameter
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
- Start the ICSMonitor Application Server:
<WebSphere_Application_Server_installation_directory>/bin/startServer.sh
ICSMonitor
- 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.
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.
- Create the ICSMonitor directory in the
webapps directory of the Tomcat installation.
- Extract the contents of the CWDashboard.war file (found
by default in the ProductDir/WBSM directory) into the
directory created in step 1.
- Edit the setclasspath.sh file, located in the
bin directory of the Tomcat installation.
- 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.
- 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.
- 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
- Change the port number in the
<Tomcat_home>/conf/server.xml
file.
This step is optional. The default port number is
8080.
- Start Tomcat from a command line.
