Deploying the monitor
and control servlet on WebSphere Application Server 6.1
You can deploy the monitor
and control servlet on IBM® WebSphere® Application Server 6.1
using these steps.
Before you begin
You must install WebSphere Application Server 6.1
and Rational® Publishing Engine with
the monitor
and control servlet feature
before you can deploy the monitor
and control servlet.
Procedure
Open the administrative console in a browser. Example: http://localhost:9043/ibm/console/logon.jsp
Deploy the Rational Publishing Enginemonitor
and control servlet.
Expand Applications and select Install
New Application.
In the Path to new application section,
select Local or Remote,
depending on where the rpemc.war file is in
relation to the application server.
Click Browse and
locate the rpemc.war file. The
default location is: %RPE_HOME%\web services\rpemc\rpemc.war
In the Context root field, enter /rpemc.
Click Next. This entry is a part
of the URL used for configuring the client.
Accept the default settings in
the following windows and click Next.
Select installation options
Map modules to servers
Map virtual host for web modules
In the Summary window,
click Finish and Save directly
to the master configuration.
Configure the security roles:
Click Users and Groups > Manage Users.
Click Create and
create two users: rpe_admin and rpe_client.
To associate roles, navigate to Applications > Enterprise Applications > rpemc.war_application > Security role to user/group mapping. WebSphere Application Server displays
the two users you defined as their roles for the monitor
and control servlet:
rpe_mc_client
rpe_mc_admin
Associate the rpe_mc_client role
with the rpe_admin and rpe_client users.
Select rpe_mc_client.
Click Look up users.
In the Search String field, enter rpe* and
click Search.
In the Available column, press the CTRL key, and then select rpe_admin and rpe_client.
Click >> to add the users to the Selected column.
Click OK.
Associate the rpe_mc_admin role
with the rpe_admin user.
Select rpe_mc_admin.
Click Look up users.
In the Search String field, enter rpe* and
click Search.
In the Available column, select rpe_admin and
click >> to add the user to the Selected column.
Click OK.
Click OK and Save directly
to the master configuration.
Change the class loader policies:
Click Enterprise Applications > rpemc.war_context_path > Class loading and update detection.
In the Polling interval for updated files field,
enter a value in seconds.
For Class loader order, select Classes
loaded with application class loader first.
For WAR class loader policy,
select Single class loader for application.
Click Apply and OK.
Update the security settings:
Click Security > Secure administration, applications, and infrastructure.
In the Application security section,
select the Enable application security check
box.
In the Java 2 security section, clear
the Use Java 2 security to restrict application access
to local resources check box.
In the Authentication section, click Web security > General settings.
Select Authenticate only
when URI is protected.
Click OK and Save to
the master configuration.
Start the monitor
and control servlet application:
Click Applications > Enterprise Applications. The rpemc.war application
you added is listed as the application name you entered.
Select the monitor
and control servlet application.
Click Start. The following confirmation message displays: Application rpemc.war_application on
server server1 and node IBM-74569A1E1EFNode01 started
successfully.
Test the monitor
and control servlet:
Log out of the WebSphere Application Server administrative
console.
Note: You must log out of the administrative
console. Because basic authentication is used, only a single session
per browser can exist. If you do not log out of the WebSphere Application Server administrative
user, you cannot access the Rational Publishing Engine resources
to which only the rpe_admin has access and you receive
the following message: Error 401: Unauthorized.
Open http://server:port/rpemc/ui/index.html in
a browser.
Log in with the rpe_admin credentials. If it is configured correctly, you can view the user interface
of Rational Publishing Enginemonitor
and control servlet.
Click Refresh Jobs. The current
jobs display.
Results
After you complete the deployment, the monitor
and control servlet administration
console is available at: http://server:port/rpemc/ui/index.html.
See Managing document generation jobs in the monitor and control servlet for information on using the administration
console.