Configuring the Rational Team Concert adaptor

About this task

An adaptor to connect Rational Build Forge to Rational Team Concert source repository is installed automatically with Build Forge. The adaptor runs on the Rational Build Forge console host and communicates with Rational Team Concert directly as a client. You do not need to install the Rational Team Concert client on the Rational Build Forge console host. You can configure individual Build Forge projects to access Rational Team Concert source as follows.

Procedure

  1. Define a Server resource.
    • Enter the Name for this server resource.
    • Enter the Host: this is the fully qualified domain name of the host where Rational Team Concert server is running.
      Note: Normally this property refers to a Build Forge agent. You do not need to install a Build Forge agent on the Rational Team Server host. This property is used specially to communicate with Rational Team Concert directly.
    • Enter values for other properties as appropriate.
    Note: The RTC tool scm must be on the PATH for the user profile or the startup profile for the RTC server. The adaptor uses scm to access source files.
  2. Set up adaptor links for each project that uses the Rational Team Concert repository. The following instructions describe how to set up an adaptor link for a project.
    1. In the console, go to Projects > Adaptor Links.
    2. Click New Adaptor Link. Set its properties in the Details tab, and then click Save.
      • State - select Active.
      • Name - enter the name for the adaptor link.
      • Adaptor
        • For Rational Team Concert version 1.x, choose JazzSCM
        • For Rational Team Concert version 2.x, choose JazSCMv2
      • Project - choose the project to which to apply the adaptor link.
      • Environment - choose the environment to use for this adaptor link. It must be an existing environment.
    3. Click the adaptor link you just created.
    4. Click Populate Env. This step populates the specified environment with the variables defined in the adaptor (JazzSCM.xml).
    5. Click Save.
  3. Update the variables provided by the adaptor. In the environment you set up and populated, edit the variables provided by the adaptor.

    Four environment variables are set in the adaptor:

    • Current_Date - sets the current date. It is used to apply timestamps. Do not change this definition.
    • Last_Run - automatically updated by the system. Do not change this definition.
    • Directory_Path - sets the location for source files retrieved from the repository. It is set to C:\temp by default. Change this directory to the temporary directory you want to use.

      The directory is not cleaned up by default after a job runs. Delete old directories from jobs that have already run.

    • Jazz_Server - sets the location of the Rational Team Concert server. It is set to $BFServer by default. You must change this setting to the Name property of the Server resource that points to the Rational Team Concert Server.
    1. In the console, go to Environments.
    2. Select the environment that is used by the adaptor link.
    3. Select and edit the variables you want to change.
    4. Click Save.

Results

You can now run the project. Each time it runs, it connects to the Rational Team Concert repository. It updates source files that have changed at the RTC server since the last time the project ran.

Additional resources:


Feedback