Configuring a Rational Team Concert server to work with Rational Asset Manager

You can manually configure a IBM® Rational® Team Concert server that is required for lifecycles in IBM Rational Asset Manager.

Before you begin

To configure a Rational Team Concert server application to work with Rational Asset Manager, the application must be deployed to the application server and connected to the database. If you are using IBM WebSphere® Application Server, the server setup application does this procedure for you.

The Tomcat server for Rational Team Concert must be running.

Procedure

  1. Retrieve the application files on the appropriate archive for Tomcat and for your operating system. The application files are in the archive_extract_location/apps/tomcat/ folder.
  2. On the installation media, find the archive_extract_location/apps/tomcat/RTC-server.zip file.
  3. Extract RTC-server.zip to a location on your hard disk drive, which is referred to in these instructions as rtc_install_dir.
  4. Launch the Administrative web interface of Rational Team Concert in a web browser at https://machine_name:secure_port/jazz/admin/. Note the https; the connection must be secure.
  5. Log in with the user ID and password for the administrator of Rational Team Concert. If no one has logged in to Rational Team Concert before, use the user ID and password for the administrator of the application server.
  6. If you are working with a new installation of Rational Team Concert: Configure the administrative user for Rational Team Concert:
    1. If you see an error about "fetching server status information," shut down and restart both your database server and your application server and log in again.
    2. In the Rational Team Concert Administrative web interface, click User Management. Ignore any errors about an external registry not being configured.
    3. Click Create User.
    4. Enter the following details:
      1. User Name: The user ID of the application server administrator
      2. User ID: The user ID of the application server administrator
      3. Email Address: A valid email address for the application server administrator
    5. In the Client Access License section, select Rational Team Concert - Developer to assign the developer license to that user.
    6. Click Save.
    7. Log out, and then log back in to the Administrative web interface as the administrator of the application server.
  7. Import the lifecycles process template into Rational Team Concert:
    1. In the Rational Team Concert Administrative web interface, click Process Template Management. If you cannot see the Process Template Management link, log out and then log back in to the Administrative web interface.
    2. Click Import Template and browse to the com.ibm.ram.lifecycle.zip file in the archive_extract_location/DatabaseScripts/ folder. Then click OK. The RAM Lifecycle template is displayed.
  8. Create a project area in Rational Team Concert:
    1. In the Rational Team Concert Administrative web interface, click Project Area Management. If you cannot see the Project Area Management link, log out and then log back in to the Administrative web interface.
    2. Click Create Project Area.
    3. Enter the following details about the project area:
      • Project name: RAM Lifecycle
      • Summary: Rational Asset Manager Lifecycle control project area
      • Description: This area is used to manage the lifecycles for Rational Asset Manager
    4. Click Save.
  9. Assign the appropriate memberships and process roles for the project area:
    1. On the Project Area Management page, click the RAM Lifecycle project area.
    2. In the Administrators section, click Add. Search for and select the administrator user that you created. If you are working with an existing Rational Team Concert application, you can also select a different user to be administrator for this project area.
    3. In the Members section, click Add; then search for and select the same user that you selected as the administrator for the project area.
    4. After you add the administrator, click the Process Roles icon next to the administrator's name.
    5. In the Edit Process Roles window, from the Available Roles list, select Administration and click Add.
    6. Click Finish.
    7. Click Save.
  10. Stop and then restart the application server. If you are using Rational Asset Manager and Rational Team Concert on separate Tomcat servers, also start the Tomcat server for Rational Asset Manager. To start Tomcat, run the following file:
    • For Windows:tomcat_install_directory\bin\startup.bat
    • For Linux:For AIX:For Linux for zSeries:tomcat_install_directory/bin/startup.sh
  11. Open and log in to the Rational Asset Manager web client to configure the Rational Asset Manager web application. For more information, see Configuring the Rational Asset Manager server application.
Feedback