Deploying the monitor and control servlet on WebSphere Application Server 7.0

You can deploy the monitor and control servlet on IBM® WebSphere® Application Server 7.0 using these steps.

Before you begin

You must install WebSphere Application Server 7.0 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 click New Application.
    2. Click New Enterprise Application.
    3. 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.
    4. Click Browse and locate the rpemc.war file. The default location is: %RPE_HOME%\web services\rpemc\rpemc.war
    5. Select Fast Path - Prompt only when additional information is required and click Next.
    6. Accept the default settings in the following windows and click Next.
      • Select installation options
      • Map modules to servers
      • Map virtual host for web modules
    7. In Map context roots for web modules, enter the context root as /rpemc. The context root is a part of the URL used for configuring the client.
    8. 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, click Applications > Application Types > WebSphere 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 Map users.
      3. In the Search String field, enter rpe* and click Search.
      4. In the Available column, press the CTRL key, and then select rpe_admin and rpe_client. Click the Add arrow to add the users to the Selected column.
      5. Click OK.
    5. Associate the rpe_mc_admin role with the rpe_admin user.
      1. Select rpe_mc_admin.
      2. Click Map users.
      3. In the Search String field, enter rpe* and click Search.
      4. In the Available column, select rpe_admin and click the Add arrow 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 Applications > Application Types > WebSphere Enterprise Applications > rpemc.war_application > Class loading and update detection.
    2. In the Class loader order section, select Classes loaded with local class loader first (parent last).
    3. In the WAR class loader policy section, select Single class loader for application.
    4. Click Apply and OK.
  5. Update the security settings:
    1. Click Security > Global security.
    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 and SIP security > General settings.
    5. Select Authenticate only when URI is protected.
    6. Click OK and Save directly to the master configuration.
  6. Start the monitor and control servlet application:
    1. Click Applications > Application Types > WebSphere 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