Setting the public URI for Jazz servers

To identify servers for cross-communication, set the public URI for each Jazz Team Server that hosts a Rational product for C/ALM integration.

About this task

Use the following guidelines when setting the public URI:
  • Use a fully qualified hostname. If your machine has no publicly known hostname, use the IP address.
  • The hostname for a Jazz Team Server must not include an underscore (_). If hostnames contain underscores, they must be changed to successfully implement the integration.
  • The hostname or IP address must be accessible to all clients and the collaborating servers. Do not use localhost or hostnames that are only known inside local networks.
  • Use a single, consistent way of addressing a server. All clients and collaborating servers must use the same address.
  • Open the Admin Web UI with the chosen hostname, rather than an alias, especially when performing the configuration steps described below.

Procedure

  1. Open the server administration interface as a member of the JazzAdmins group:
    • For Rational® Team Concert and Rational Requirements Composer, open a browser and log in to the Admin Web UI on the Jazz Team Server. Typically, the URL for the Admin Web UI is https://host-name:9443/jazz/admin. In the Admin Web UI, click the Server tab.
    • In Rational Quality Manager, click Admin > Jazz Server Administration.
  2. In the Configuration pane on the Server page, click Advanced Properties.
  3. In the Core Repository Component list, locate the following service and click Edit: com.ibm.team.repository.service.internal.RepositoryRemoteService
  4. In the Current Value field of the Public URI Root property, type the URL for the Jazz Team Server that you are logged on to. The typical form is:

    https://host-name:port/jazz/
    for example:
    https://rrc-host:9443/jazz

    Important: The hostname for a Jazz Team Server must not include an underscore (_).
  5. Click Save and restart the Jazz Team Server.
  6. Repeat this procedure on each Jazz Team Server that you want to access through the C/ALM integrations.
  7. After starting the servers, verify that the root service document can be accessed and is valid:
    1. On a Rational Team Concert or Rational Quality Manager Jazz™ server, open the root services document in a browser. The typical format is https://host-name:9443/jazz/rootservices.
      On a Rational Requirements Composer server, the typical format is https://host-name:9443/rdm/rootservices.
      Note: For Rational Requirements Composer, the URL ends in /rdm/rootservices, rather than /jazz/rootservices.
    2. Verify that the XML document opens, and that the first line in the document appears as follows:
      <rdf:Description rdf:about="https://host-name:9443/jazz/rootservices">
    3. If the URL in the rdf:about attribute does not correspond to the address that you want to use for your server, configure the host name of your server as described above.
    4. Perform the same steps on each Jazz Team Server that you want to access through the C/ALM integrations.

What to do next

You should now clear any previous attempts to configure cross-server communication. See Remove existing friends and keys.

Feedback