Setting the public URI for Jazz servers

Set the public URI on each Jazz™ Team Server that hosts a Rational® product for C/ALM integration. This procedure identifies each server for cross-server communication.

About this task

Guidelines for setting the public URI are as follows:

Important: Use a single, consistent way of addressing a server: All clients and collaborating servers must use that address. Do not use other aliases besides the chosen address.

To set the public URI on a Jazz Team Server:

Procedure

  1. Open the server administration interface as a member of the JazzAdmins group:
    • For IBM® Rational Team Concert and IBM 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.
    • For IBM Rational Quality Manager, log in and click Admin > Jazz Server Administration.
  2. In the Configuration pane, click Advanced Properties.
  3. Search for Public URI Root.
  4. In com.ibm.team.repository.service.internal.RepositoryRemoteService, click Edit.
  5. In the Public URI Root property at the Current Value field, enter the URL that can be used to access the Jazz Team Server that you are logged on to. Be sure to specify the URI root that contains the hostname or IP address that you want clients to use. The typical format is https://host-name:port/jazz/, and the default port number is 9443.
  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. For example, 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 can now remove any existing server friend entries on each Jazz Team Server.

Feedback