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
- 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 .
- In the Configuration pane on the Server page, click Advanced
Properties.
- In the Core Repository Component list, locate the following
service and click Edit: com.ibm.team.repository.service.internal.RepositoryRemoteService
- 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 (_).
- Click Save and restart the Jazz
Team Server.
- Repeat this procedure on each Jazz Team Server that you
want to access through the C/ALM integrations.
- After starting the servers, verify that the root service
document can be accessed and is valid:
- 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.
- 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">
- 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.
- 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.