Establishing friend relationships from CLM

Use the application administration interface to establish friend relationships between Requirements Management, Change and Configuration Management, and HP ALM. Use this procedure to add the location information for the adapter application, and send a request to the adapter friend application.

Before you begin

An access request from the adapter is approved.
Important: These instructions do not apply if you used your administrator credentials to create the friend relationship on the Jazz™ server as described in Establishing friend relationships from the adapter.

About this task

You add a friend relationship to the HP ALM server.

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.

      Log in to the Rational® Requirements Composer server by using an account that has administrator privileges.

    2. https://fully qualified hostname:port/ccm/admin

      Log in to the Rational Team Concert™ server by using an account that has administrator privileges.

  2. On the Application Administration page, click Friends (Outbound). The Friends page opens.
  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 banner.
  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. You might 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. The entries can vary, depending on which friends were 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

A friend request exists between a Change and Configuration Management application, a Requirements Management application, and the adapter.

What to do next

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


Feedback