Setting up and starting a WebSphere Application Server

You can set up IBM® Rational® Project Conductor to work with IBM Websphere Application Server. This setup assumes that you are installing Rational Project Conductor on the same machine as the Websphere Application Server.

Before you begin

Ensure that the following criteria are met:

About this task

You can configure WebSphere Application Server as your application server even if you have installed Rational Project Conductor with the default Tomcat application server option. In this scenario, the steps for setting up WebSphere Application Server are the same, except that when the jazz.war file is deployed, you must navigate to the jazz.war file that is located within the Tomcat installation directory.

To set up a WebSphere Application Server:

Procedure

  1. Verify or update the WebSphere Application Server level.

    Rational Project Conductor requires WebSphere Application Server Version 6.1 with the IBM Java SDK 1.5 SR5 or later fix pack applied. Use the IBM Java SDK 1.5 SR6 SDK update that is available from http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg27009393 and select fix pack V6.1.0.25 or later. With WebSphere 6.1 and the GA IBM Java SDK, Rational Project Conductor starts to report "proxy errors" after some number of operations.

    You must obtain the corresponding WebSphere Application Server interim fixes for fixes to IBM Java SDK 1.5 SR9 or IBM Java SDK 1.6 SR4 that are necessary for Rational Project Conductor to run correctly. Otherwise, some services in the server might not start correctly. The interim fixes are available under their corresponding WebSphere Application Server APARs. For IBM Java SDK 1.5/WebSphere Application Server 6.1, the APAR is PK85942 and you can download the files from ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/. Install at least WebSphere Application Server 6.1 fix pack 25 before installing the JRE interim fix.

  2. Update the JVM arguments which can be set to control some aspects of the server behavior. The following list contains the specifics of setting these JVM properties in the administrative console, substitute JazzInstallDir with your Rational Project Conductor installation directory:
    1. Click Servers -> Application Servers.
    2. Click server1.
    3. Click Java and Process Management -> Process Definition.
    4. Click Java Virtual Machine.
    5. Add the value 100 to the Initial Heap.
    6. Add the value 1500 to the Maximum Heap Size.
    7. Click Apply.
    8. Click Custom Properties.
    9. Add the following properties: Click New, enter the Name and Value, and then click OK.

      Name: java.awt.headless. Value: true

      Name: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin. Value: true

      Name: JAZZ_HOME Value: file:///JazzInstallDir/server/conf

    10. Click Save directly to the master configuration.
  3. Set up the required global WebSphere Application Server instance properties, and activate the proper security settings.
    1. In the WebSphere Application Server Admin Console, in the left menu, expand the Security group, and click Secure administration, applications, and infrastructure Servers.
    2. Ensure that the following security settings are configured as shown below:
      • Enable administrative security is "on"
      • Enable application security is "on"
      • Java 2 security is "off" for all three options
    3. Save the master configuration.
  4. Set up LDAP as the user authentication method. Rational Project Conductor requires that LDAP authentication is configured to perform authorization and personalize the application.
  5. Restart WebSphere Application Server.
    On Windows, the default value for WebSphere installation directory is:
    C:\Program Files\IBM\WebSphere\AppServer
    You can restart the server with the following commands on Windows:
    cd WASInstallDir\bin 
    stopServer.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
    startServer.bat server1
    On Linux, the default value for WebSphere installation directory is:
    /opt/IBM/WebSphere/AppServer
    You can restart the server with the following commands on Linux:
    cd WASInstallDir/bin 
    ./stopServer.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
    ./startServer.sh server1
  6. Now, install the Rational Project Conductor application.
    1. Open the Admin console for your WebSphere Application Server.
    2. Click Applications -> Install New Application.
    3. Under Path to new Application, click Local file system.
    4. Under Full path, browse to the location of the jazz.war in your file system. For example, JazzInstallDir/server/jazz.war. If Tomcat is already set up as the Rational Project Conductor application server, then browse to the jazz.war file at JazzInstallDir/server/tomcat/webapps/jazz.war
    5. Set Context Root as /jazz.
    6. Select the option Show me all installation options and parameters.
    7. Click Next and continue until Step 6: Map virtual hosts for Web modules.
    8. In step 6: Map Virtual Hosts, select the Mapping to the default host check box. Click Next, and continue until Step 8: Map Security roles to users or groups.
    9. In Step 8: Map Security roles to users or groups, map the Jazz roles to the WebSphere user groups.
      • Select the check box for the Jazz group you want to map.
      • Click Look up groups. If the WebSphere users are not mapped to groups, then click Look up users, and map the roles to users.
      • Search for the available groups or users. To search for groups, you can use wildcard characters to search for Jazz*
      • Click the >> button to select the corresponding group, and click OK.
      • Perform these mapping steps for all the Jazz roles.
    10. Click Next and then click Finish.
    11. Click Save directly to the master configuration.
  7. Deploy the help.war file for the Rational Project Conductor online help to be available. The steps are a subset of the procedure to deploy the jazz.war detailed in step 6 :
    1. In the Admin console, click Applications -> Install New Application
    2. Under Path to new Application, click Local file system.
    3. Under Full path, browse to the location of the help.war in your file system. For example, JazzInstallDir/server/help.war.
    4. Set Context Root as /help.
    5. Click Next and continue through the remaining Install New Application steps.
    6. Click Finish.
    7. Click Next and then click Finish.
    8. Click Save directly to the master configuration..
  8. Start the applications you installed.
    1. Click Applications -> Enterprise Applications.
    2. Select the check boxes for jazz_war and help_war, and click Start.

      A green arrow should appear indicating the application started successfully.

What to do next

After the server is started, proceed to Testing and configuring the server.

Alternatively, return to the Installation roadmaps to review the next steps in the installation.


Feedback