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:
- If available, use
a hostname, preferably a fully-qualified hostname.
If your machine has no publicly known hostname, you can use the IP
address.
- The chosen address or hostname must be visible and
accessible
to all clients and the collaborating servers. Do not use localhost
or hostnames that are only known inside local networks.
- Only
access the Web UI with the chosen hostname, never an alias,
especially when performing the configuration steps described below.
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
- 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 .
- In the Configuration pane, click Advanced
Properties.
- Search for Public
URI Root.
- In com.ibm.team.repository.service.internal.RepositoryRemoteService,
click Edit.
- 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.
- 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:
- 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.
- 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 can now remove any existing server friend entries on
each Jazz Team Server.