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:
- Verify that a supported version of WebSphere® Application Server is installed.
For information about supported versions, see Installation requirements.
- Ensure that the database is created and the teamserver.properties
file is updated with your database settings.
- Ensure that the WebSphere Application
Server security setting "Use available authentication data when an
unprotected URI is accessed" is selected. If you are using the WebSphere Integrated Solutions
Console, perform the following steps:
- Navigate to .
- Select the check box for Use available authentication
data when an unprotected URI is accessed.
- If you installed Rational Project Conductor into
an existing package group, or updated an existing installation, clear
the server cache. To clear cache, delete the folders temp and wstemp from
the path WASInstallDir\profiles\AppSrv01\.On
Windows, also clear the contents at the directory location C:\Documents
and Settings\<User name>\Local Settings\Application Data\IBM\IBM
Information Server console.
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
- 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.
- 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:
- Click Servers -> Application Servers.
- Click server1.
- Click Java and Process Management -> Process
Definition.
- Click Java Virtual Machine.
- Add the value 100 to the Initial Heap.
- Add the value 1500 to the Maximum Heap Size.
- Click Apply.
- Click Custom Properties.
- 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
- Click Save directly to the master
configuration.
- Set up the required global WebSphere Application Server instance properties,
and activate the proper security settings.
- In the WebSphere Application
Server Admin Console, in the left menu, expand the Security group,
and click Secure administration, applications, and infrastructure
Servers.
- 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
- Save the master configuration.
- Set up LDAP as the user authentication method. Rational Project
Conductor requires
that LDAP authentication is configured to perform authorization and
personalize the application.
- 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
- Now, install the Rational Project
Conductor application.
- Open the Admin console for your WebSphere Application Server.
- Click Applications -> Install New Application.
- Under Path to new Application, click Local
file system.
- 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
- Set Context Root as /jazz.
- Select the option Show me all installation options
and parameters.
- Click Next and continue until
Step 6: Map virtual hosts for Web modules.
- 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.
- 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.
- Click Next and then click Finish.
- Click Save directly to the master
configuration.
- 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 :
- In the Admin console, click Applications
-> Install New Application
- Under Path to new Application, click Local
file system.
- Under Full path, browse to the location of the help.war
in your file system. For example, JazzInstallDir/server/help.war.
- Set Context Root as /help.
- Click Next and continue through
the remaining Install New Application steps.
- Click Finish.
- Click Next and then click Finish.
- Click Save directly to the master
configuration..
- Start the applications you installed.
- Click Applications -> Enterprise Applications.
- 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.