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:
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.
To install Web-based System Monitor using the installation script:
- Run ProdDir/bin/CWDashboard.sh with the
following parameters:
- Install path for WebSphere Application Server Express, e.g.
/opt/IBM/WebSphere/Express502/AppServer
- Fully qualified host name of machine you are installing in,
e.g. hostname.ibm.com
- WebSphere Business Integration installation directory, e.g.
/home/crossworlds/IBM/WebSphereItemSync
- Path to DB2 install java directory, e.g.
opt/IBM/db2/V8.1/java
- y (for HTTP server yes)
- Stop the ICSMonitor Application Server from the command line:
/opt/IBM/WebSphere/Express502/AppServer/bin/stopServer.sh ICSMonitor
- Start the Web-based System Monitor from the command line:
/opt/IBM/WebSphere/Express502/AppServer/bin/startServer.sh ICSMonitor
- To access Web-based System Monitor:
http://hostname/ICSMonitor
- Run ProdDir/bin/CWDashboard.sh with the
following parameters:
- Install path for WebSphere Application Server Express
- Fully qualified host name of machine you are installing in
- WebSphere Business Integration Express for Item Synchronization install
directory
- Path to DB2 install java directory
- n (for no HTTP server)
- New Port number
- New SSL port number (default is 7043)
- Stop the ICSMonitor Application Server from the command line:
/opt/IBM/WebSphere/Express502/AppServer/bin/stopServer.sh ICSMonitor
- Start the Web-based System Monitor from the command line:
/opt/IBM/WebSphere/Express502/AppServer/bin/startServer.sh
- To access Web-based System Monitor:
http://hostname:portnumber/ICSMonitor
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:
- Create the ICSMonitor directory under
Tomcat_home/webapps. Where Tomcat_home
is the path of the Tomcat installation in your environment.
- Extract the WAR file contents into the ICSMonitor directory. The
CWDashboard.war file will be in the
ProdDir/WBSM directory.
- Copy the xerces.jar file from
Tomcat_home/webapps/ICSMonitor/WEB-INF/lib to
Tomcat_home/common/lib.
- Rename the xercesImpl.jar file, located in the
Tomcat_home/common/endorsed directory to
xercesImpl.jar.old.
- 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.
- 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.
- 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 the command line:
Tomcat_home/bin/startup.sh
Otherwise, the catalina.sh file is not called.
