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

  1. Open the administrative console in a browser. Example: http://localhost:9043/ibm/console/logon.jsp
  2. Deploy the Rational Publishing Engine monitor and control servlet.
    1. Expand Applications and select Install New Application.
    2. 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.
    3. Click Browse and locate the rpemc.war file. The default location is: %RPE_HOME%\web services\rpemc\rpemc.war
    4. In the Context root field, enter /rpemc. Click Next. This entry is a part of the URL used for configuring the client.
    5. Accept the default settings in the following windows and click Next.
      • Select installation options
      • Map modules to servers
      • Map virtual host for web modules
    6. In the Summary window, click Finish and Save directly to the master configuration.
  3. Configure the security roles:
    1. Click Users and Groups > Manage Users.
    2. Click Create and create two users: rpe_admin and rpe_client.
    3. 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
    4. Associate the rpe_mc_client role with the rpe_admin and rpe_client users.
      1. Select rpe_mc_client.
      2. Click Look up users.
      3. 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.
      4. Click OK.
    5. Associate the rpe_mc_admin role with the rpe_admin user.
      1. Select rpe_mc_admin.
      2. Click Look up users.
      3. In the Search String field, enter rpe* and click Search.
      4. In the Available column, select rpe_admin and click >> to add the user to the Selected column.
      5. Click OK.
    6. Click OK and Save directly to the master configuration.
  4. Change the class loader policies:
    1. Click Enterprise Applications > rpemc.war_context_path > Class loading and update detection.
    2. In the Polling interval for updated files field, enter a value in seconds.
    3. For Class loader order, select Classes loaded with application class loader first.
    4. For WAR class loader policy, select Single class loader for application.
    5. Click Apply and OK.
  5. Update the security settings:
    1. Click Security > Secure administration, applications, and infrastructure.
    2. In the Application security section, select the Enable application security check box.
    3. In the Java 2 security section, clear the Use Java 2 security to restrict application access to local resources check box.
    4. In the Authentication section, click Web security > General settings.
    5. Select Authenticate only when URI is protected.
    6. Click OK and Save to the master configuration.
  6. Start the monitor and control servlet application:
    1. Click Applications > Enterprise Applications. The rpemc.war application you added is listed as the application name you entered.
    2. Select the monitor and control servlet application.
    3. Click Start. The following confirmation message displays: Application rpemc.war_application on server server1 and node IBM-74569A1E1EFNode01 started successfully.
  7. Test the monitor and control servlet:
    1. 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.
    2. Open http://server:port/rpemc/ui/index.html in a browser.
    3. Log in with the rpe_admin credentials. If it is configured correctly, you can view the user interface of Rational Publishing Engine monitor and control servlet.
    4. 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.

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.


Feedback