Establishing friend relationships from CLM

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

Before you begin

Previous post-installation tasks are complete.
Important: These instructions do not apply if you set up friend relationships to CLM from JIRA as described in Establishing friend relationships from the adapter.

If you are integrating with Rational® ClearQuest®, see Technote 1580379 for information about establishing friend relationships between Rational ClearQuest projects and the JIRA application.

Review the project associations that are possible between JIRA and CLM projects to learn about what servers to friend, see Using the JIRA adapter.

Verify your Requirements Management, Quality Management, Change and Configuration Management applications are started.

About this task

You add friend relationships to JIRA. These friend relationships are with Change and Configuration Management, Quality Management, and Requirements Management applications.

Procedure

  1. Point your browser to one of the following URLs by using the default context root value:
    1. https://fully qualified hostname:port/jts/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.

    3. https://fully qualified hostname:port/qm/admin

      Log in to the Rational Quality Management server by using an account that has administrator privileges.

  2. On the Server Administration page:
    • For jts/admin, click the Server tab.
    • For ccm/admin, click the Application tab.
    • For qm/admin, click the Application tab.
  3. In the Communications section, click Friends (Outbound).
  4. At the Friends List, click Add. The Add Friend window opens.
  5. For Name, type the name that you want to use to identify the JIRA friend application.

    For example, JIRA server

  6. For Root Services URI, type the uniform resource identifier for the JIRA server.

    For example, http://YourJIRAhostname:8080/rest/oslc/latest/rootservices

    Tip: You can find the Root Services URI from the Rational Adapter for JIRA home page. From the JIRA server Administration page, you click Administration > Add ons at the upper right of the page. On the Administration page, click Manage Add-ons. In the OSLC section, click Rational Adapter Home. The Rational Adapter for JIRA home page opens, which provides a link to the Root Service Document. Look at the browser URL address, which is what you need for the Root Services URI field.
  7. 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.
  8. Click Create Friend. A confirmation message opens. Click Next to continue.
  9. Configure the OAuth manager for OAuth authentication while you create the friend server. Click 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.
    Important:
    • If JIRA uses an LDAP user registry, you must add the following JVM Arguments when you start JIRA: Datlassian.org.osgi.framework.bootdelegation=sun.*, com.sun.*, org.springframework.ldap.core.*
    • If you are using Rational solution for Collaborative Lifecycle Management v3.0.1.0, you must configure OAuth to complete the authentication between JIRA and Jazz™ server entries, see Configuring OAuth authentication.
  10. If you are prompted, log in to JIRA by using an account that has administrator privileges. Specify a consumer name to remember your OAuth friendship.
  11. In the Authorize Provisional Key window, click Approve and Finish.
  12. Repeat the previous steps, if you want to add another friend to the friend list for CLM applications.

Results

From the Jazz application server, you created one or more friend requests from one or more CLM applications to the JIRA server.

What to do next

Associate JIRA projects with CLM project areas, see Linking between JIRA projects and CLM project areas.


Feedback