Setting up WebSphere Application Server

This topic describes how to set up the Team Server to work with Application Server. This setup assumes that you are installing the Team Server for on the same machine as the Application Server.
Before beginning these steps, you should have the following completed:
Note: This document does not provide instructions for configuring WebSphere Application Server authentication or SSL, which are complex topics. Detailed information about the authentication and encryption options for WebSphere Application Server is described in the WebSphere Application Server Information Center. See Securing applications and their environment for more information. The Jazz Web user interface requires that authentication be configured in order to perform authorization and personalize the application.
To setup the Jazz Team Server to work with WebSphere Application Server, proceed as follows:
  1. Modify the profile.ini and license-profile.ini files:
    Edit each of profiles in JazzInstallDir/server/provision_profiles and set an absolute path for the URL property.
    Example:
    Change this line:
    url=file:./update-site
    To something like this:
    url=file:/opt/IBM/JazzTeamServer/server/update-site
    Note: The directory JazzInstallDir/server/provision_profiles must only contain the .ini files included and must not contain any backup files. Some editors automatically save a backup file, which must be removed.
  2. Verify or update the WebSphere Application Server level.

    Jazz Team Server requires WebSphere Application Server Version 6.1 with the IBM® Java SDK 1.5 SR5 or later cumulative fix applied. The IBM Java SDK 1.5 SR6 SDK update is available from Java SDK 1.5 SR6 Cumulative Fix for WebSphere Application Server. With WebSphere 6.1 and the IBM Java SDK, Jazz starts to report proxy errors after several operations.

  3. Define users and user groups for Jazz Team Server.
    The security roles and levels of access defined by the Jazz Team Server include:
    • JazzAdmins - Jazz repository administrators with full read-write access
    • JazzDWAdmins - Jazz repository administrators with specific permissions to control the data warehouse on a Jazz Team Server
    • JazzGuests Users with read-only access to the Jazz repository
    • JazzUsers Users with regular read-write access to the Jazz repository

    There are two options for mapping security roles. If you have many users, it is more efficient to create groups and map those groups to Jazz Team Server roles rather than mapping a large number of individual users.

    1. Create Users Groups using names such as JAZZADMINS, JAZZDWADMS, JAZZGUESTS, JAZZUSERS.
      Note: These group names are suggestions only. You can choose to assign any group name you prefer.
    2. Assign users to the appropriate groups.
  4. Update the JVM arguments.

    The Jazz Team Server requires specific settings on the Java Virtual Machine in which it is run.

    First, it needs to know where to find the configuration files for the server and for log4j, the logging framework used by the server. This is done by setting the system properties com.ibm.team.server.configURL and log4j.configuration. These properties use a URL rather than a simple path, so the value should be specified as a file://-style URL.

    The second property that is required for the Jazz Team Server is to provide more than the default maximum memory allocation. This allocation should be set according to the size of the team supported by the server and the memory capacity of the server where the Jazz Team Server is running. A typical medium-size team can use a value of 1000 MB of heap memory for the Jazz Team Server process.

    The following system properties must be set to control server behaviors. Set these JVM properties in the WebSphere Administrative Console, by substituting JazzInstallDir with your Jazz Team Server for System z installation directory:

    1. Click Servers > Application Servers.
    2. Click server1 or your application server.
    3. Click Java and Process Management > Process Definition.
    4. Click Java Virtual Machine.
    5. Add the value 1000 to the Maximum Heap Size.
    6. Click Apply.
    7. Click Custom Properties.
    8. Add the following properties: Click New; enter the Name and Value; then click OK.
      • Name: com.ibm.team.repository.provision.profile Value: com.ibm.team.repository.provision.profile
        Note: The property com.ibm.team.repository.provision.profile must point to the directory containing the provision_profiles.
      • Name: com.ibm.team.server.configURL Value: file:///JazzInstallDir/server/teamserver.properties (as file URL)
      • Name: log4j.configuration Value: file:///JazzInstallDir/server/log4j.properties (as file URL)
      • Name: java.awt.headless Value: true
      • Name: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Value: true
    9. Click Save directly to the master configuration .
  5. Install the Jazz Application.
    1. Open the administrative 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, enter:
      JazzInstallDir/server/tomcat/webapps/jazz.war
    5. Set Context Root to /jazz.
    6. Under How do you want to install the application?, select Show me all installation options and parameters and click Next.
      Complete each subsequent step, accepting all defaults until you get to Step 8 Map security roles to users or groups.
      • To map groups of users to Jazz Team Server roles (recommended):
        1. Use Look up groups to map those groups of users to their corresponding roles.
        2. Select JazzAdmins and click Look up groups.
        3. On the next screen, click Search, and select at least one group from the Available list and move it to Selected using >>.
          Note: The WebSphere Application Server console displays only those groups that have at least one user assigned.
        4. Repeat these steps for JazzDWAdmins, JazzUsers, and JazzGuests.
      • To map individual users to Jazz Team Server roles:
        1. Select JazzAdmins and click Look up users.
        2. On the next screen, click Search, and select at least one user ID from the Available list and move it to Selected using >>.
        3. Repeat these steps for JazzDWAdmins, JazzUsers, and JazzGuests.
          Note: If you use LDAP security, the users and groups in this case would correspond to user IDs or groups on your LDAP server. For more information on LDAP security and Jazz, see Managing users with Lightweight Directory Access Protocol (LDAP).
    7. Click Next and continue through the remaining Install New Application steps.
    8. Click Finish.
    9. Click Save directly to the master configuration.
  6. Before restarting WebSphere, add the following line to your .profile.ini:
    export LD_LIBRARY_PATH=/yourDB2Path/V9.1/lib64
    and run the command ./.profile to take your modification into account.
  7. Restart WebSphere Application Server.
    In the following command line examples, WASInstallDir represents the location where WebSphere Application Server is installed on your server.
    • The default value for WebSphere installation directory is:
      /opt/IBM/WebSphere/AppServer
      You can restart the server with the following commands:
      cd WASInstallDir/bin 
      ./stopServer.sh server1 
      [for a secure server, include: -username {User} -password {Password}] 
      ./startServer.sh server1
After the server is started, proceed to Running the setup wizard.

Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug