Establishing cross-server communication from CLM

Use the application administration interface to establish cross-server communication between Rational® Requirements Composer, Rational Team Concert™ and HP ALM. Use this procedure to add the location information for the Rational Adapter for HP ALM application, and send a request to the friend application.

Before you begin

After approving an access request from the Rational Adapter for HP ALM, you create friend relationships between the Rational Adapter for HP ALM, the HP ALM server and the servers used by Rational Requirements Composer and Rational Team Concert.
Important: This topic does not apply if you used your administrator credentials to create the friend relationship on the Jazz™ server as described in Establishing cross-server communication from the HP adapter.

About this task

Add friend relationships to the Rational Adapter for HP ALM to establish cross-server communication with the HP ALM server, Rational Requirements Composer and Rational Team Concert.

Procedure

  1. Point your browser to one of the following URLs that use the default context root values:
    1. https://[fully qualified hostname]:[port]/rm/admin. Login to the Rational Requirements Composer server by using an account that has administrator privileges.
    2. https://[fully qualified hostname]:[port]/ccm/admin and login to the Rational Team Concert server by using an account that has administrator privileges.
  2. On the Application Administration page, in the Communication section, click Friends (Outbound).
  3. At the Friends List, click Add. The Add Friend window opens.
  4. For Name, type the name that you want to use to identify the HP ALM friend application, for example HPALM server.
  5. For Root Services URI, type the uniform resource identifier for the HP ALM server. To find the URI, click the Help icon in the Rational adapter for HP ALM title bar.
  6. In the OAuth Secret and Re-type Secret fields, enter an OAuth secret code phrase to associate with the new OAuth consumer key. This string can contain one or more words and special characters, and cannot exceed 50 characters. This string is never displayed in the user interface, and you do not enter this string again. This string, also called an OAuth consumer secret, acts as a password to access the friend server.
  7. Select the Trusted check box. Trusted consumers can share authorization with other trusted consumers and do not require user approval to access data.
  8. Click Create Friend. A confirmation message opens. Click Next to continue.
  9. Click the link Grant access for the provisional key. If you do not have administrator permissions on the targeted application server, work with a member of that administrator group to get approval for provisional OAuth consumer keys.
  10. In the Authorize Provisional Key window, click Approve and Finish.
  11. To verify that the friends list is configured correctly, you can enter the following URLs:
    • https://[fully qualified hostname]:[port]/rm/friends
    • https://[fully qualified hostname]:[port]/ccm/friends
    Each URL opens an XML document with an entry that is similar to the following example, although the entries will vary, depending on which friends have been added:
    <jd:Friend>
    <jfs:internal>false</jfs:internal>
    <jd:rootServices rdf:resource="https://host-name:9443/rm/rootservices"/>
    <dc:title>Requirements Management (/rm)</dc:title>
    </jd:Friend>
    <jd:Friend>
    <jfs:internal>false</jfs:internal>
    <jd:rootServices rdf:resource="https://host-name:8443/hpqm/rootservices"/>
    <dc:title>Rational Adapter for HP ALM (host-name:8443)</dc:title>
    </jd:Friend>

Results

From the application server, you have created friend relationships to the Rational Adapter for HP ALM to establish cross-server communication with the HP ALM server, Rational Requirements Composer and Rational Team Concert.

What to do next

Associate project areas so team members can link the artifacts in the applications on servers that you just friended, see Linking between HP ALM projects and CLM project areas.


Feedback