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 section contains the following topics:
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 WebSphereItemSync/bin/CWDashboard.bat with the
following parameters:
- Install path for WebSphere Application Server Express, e.g.
C:\Program Files\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.
C:\IBM\WebSphereItemSync
- Path to DB2 install java directory, e.g.
C:\IBM\SQLLIB\java
- y (for HTTP server yes)
- Stop the ICSMonitor Application Server from the command line:
C:\IBM\WebSphere\Express502\AppServer\bin\stopServer.bat ICSMonitor
- Start the Web-based System Monitor from the command line:
C:\IBM\WebSphere\Express502\AppServer\bin\startServer.bat ICSMonitor
- To access Web-based System Monitor:
http://hostname/ICSMonitor
- Run IBM/WebSphereItemSync/bin/CWDashboard.bat 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:
C:\IBM\WebSphere\Express502\AppServer\bin\stopServer.bat ICSMonitor
- Start the Web-based System Monitor from the command line:
C:\IBM\WebSphere\Express502\AppServer\bin\startServer.bat ICSMonitor
- 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 \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 setclasspath.bat file, located in
Tomcat_home\bin.
- Set the JAVA_OPTS property as follows:
set JAVA_OPTS=-DDASHBOARD_HOME=<Tomcat_home>\webapps\ICSMonitor
-DDASHBOARD_URL=http://<HostName>[:PortNumber]/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
where %ORB_PORT% and %ORB_HOST% match what is in
ProductDir/bin/CWSharedEnv.bat,
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 Tomcat_home contains spaces, use quotes around the
DASHBOARD_HOME value.
- If using DB2 for the ICS Repository, in the
setclasspath.bat 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.bat
Otherwise, the setclasspath.bat file is not
called.
