Configuring web-based tools to use Tomcat
This section describes how to configure
the web-based tools to use Tomcat. For instructions on using WebSphere
Application Server or WebSphere Application Server Express as the
Web application server instead of Tomcat, see Configuring web-based
tools to use WebSphere Application Server or WebSphere Application
Server Express. Before proceeding, ensure that you have Tomcat version
4.1.24 or 4.1.27 installed on your system.
Note:
Tomcat 4.1.24 and 4.1.27 are not supported in double
byte character set language environments.
Configuring System
Monitor and Failed Event Manager to use Tomcat
To configure System Monitor and Failed
Event Manager to use Tomcat, follow these steps:
- 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.
Note:
If you used the WebSphere Business Integration Server
Express or Express Plus installer to install the product, the CWDashboard.war file is located in the ProductDir/WBSM directory.
- Edit the setclasspath.sh file, located in the Tomcat_home/bin directory, by doing the following:
- Set the JAVA_OPTS property as follows:
-DDASHBOARD_URL=http://HostName[:PortNumber]/ICSMonitor
-DDASHBOARD_HOME=Tomcat_home/webapps/ICSMonitor
-DFEM_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
Important:
The lines beginning with the characters -D all appear on separate lines to enable them to fit on the
page. Insert only spaces, not line breaks, between the -D lines.
- Append the path to the db2java.zip file to the class path in setclasspath.sh. The db2java.zip file is located, by default, in the DB2_Installation_Dir/java directory.
- (Optional) Change the port number in the Tomcat_home/conf/server.xml file.
The default port number is 8080.
- Start Tomcat, as follows:
Tomcat_home/bin/startup.sh
Configuring Web Deployment
to use Tomcat
To configure Web Deployment to use Tomcat, follow these
steps:
- Create the Web Deployment 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 WebDeployment directory.
The WebDeployment.war file is located in the ProductDir/WBWD directory.
Note:
If you used the WebSphere Business Integration Server
Express or Express Plus installer to install the product, the WebDeployment.war file is located in the ProductDir\WBWD directory.
- Edit the setclasspath.bat file, located in the Tomcat_home/bin directory, by doing the following:
- Set the JAVA_OPTS property as follows:
DWD_HOME=Tomcat_home/webapps/WebDeployment
- If you use DB2 for the InterChange Server Express repository,
append the path to the db2java.zip file to the class path in setclasspath.bat. The db2java.zip file is located, by default, in the DB2_Installation_Dir/java directory.
Note:
Step 5b is required only if the repository is on
DB2.
- (Optional) Change the port number in the Tomcat_home/conf/server.xml file.
The default port number is 8080.
- Start Tomcat, as follows:
Tomcat_home/bin/startup.sh
By default, security is enabled in the Tomcat 4.1.24 version
of Web Deployment. A user with the role of administrator must be
created in the Tomcat_home/conf/server.xml file so that the administrator can gain full access to the
application. For details on how to create roles and use security
in Web Deployment, refer to the System Administration Guide.
