Deploy the monitor
and control servlet .war file
on an Apache Tomcat server using these steps.
Before you begin
You must install Apache Tomcat and
Rational® Publishing Engine with
the
monitor
and control servlet feature
before you can deploy the
monitor
and control servlet.
Procedure
- Open the Apache Tomcat Manager in
a browser: http://server:port/manager/html. Example: http://localhost:8080/manager/html.
- In the Deploy section, enter the details for the rpemc.war file.
- If the .war file
is on a different server than Apache Tomcat, enter the following information
in the Deploy directory or WAR file located on server section:
- Context Path: Enter /rpemc as
the name for the monitor
and control servlet application.
This entry is a part of the URL used for configuring the client.
- XML Configuration file URL: You
are not required to enter a value in this field.
- WAR or Directory URL: The path to rpemc.war.
Example: %RPE_HOME%\web services\rpemc\rpemc.war
- If the .war file
is on the same server as Apache Tomcat, enter the following information
in the WAR file to deploy section:
- Select WAR to upload: The path to rpemc.war.
Example: %RPE_HOME%\web services\rpemc\rpemc.war
- Click Deploy.
- Create Apache Tomcat users and roles for the monitor
and control servlet.
- Open the tomcat-users.xml file,
which is located by default in $CATALINA_HOME\conf\tomcat-users.xml.
- Add the rpe_mc_client and rpe_mc_admin roles.
<role rolename="rpe_mc_client"/>
<role rolename="rpe_mc_admin"/>
- Add at least one administrator and one client user.
Assign the administrator both roles and the client user the rpe_mc_client role. For example:
<user username="rpe_admin" password="password" roles="rpe_mc_admin,rpe_mc_client"/>
<user username="rpe_client" password="password" roles="rpe_mc_client"/>
- Optional: Add additional users. Example:
<user username="user1" password="password" roles="rpe_mc_client"/>
- Set these Java Options
in Apache Tomcat.
- In the Apache Tomcat application files, right-click
the startup file you use to start the server.
- Click Properties.
- Select the Java tab.
- In the Java options field, enter the following options:
-Dcom.ibm.rational.rpe.mc.url=http://host:port/rpemc/service
-Dcom.ibm.rational.rpe.mc.user=rpe_client
-Dcom.ibm.rational.rpe.mc.password=password
- Click OK.
- Restart Apache Tomcat.
What to do next
On the end user computers, specify the URL
of the monitor
and control servlet for
a remote server. See Setting monitor and control servlet preferences.