Establishing cross-server communication between Lifecycle Query Engine and Rational Engineering Lifecycle Manager

For Lifecycle Query Engine to interact with Rational® Engineering Lifecycle Manager and have access to the application data, each server must have the other server on its list of friends. The link between two servers is called a friend link. These friend links are required if you want to index and query the data from Rational Engineering Lifecycle Manager.

Before you begin

You must be logged in to the product with an account that has Jazz™ Administrator privileges.

To authorize the provisional key that the friend server generates, you must have Jazz Administrator privileges on the friend server.

About this task

You can establish communication between the Lifecycle Query Engine server, Rational Engineering Lifecycle Manager, and other applications that are registered with the Jazz Team Server by creating Outgoing Friend relationships with each application.

Procedure

  1. For each lifecycle application, create a Friend relationship by completing the following steps:
    1. Log in to the application's Administration page: https://<server>:<port>/jts/admin
    2. Click Server and in the Communication section, click Friends (Outbound).
    3. In the Friends List section, click Add.
    4. In the Add Friend dialog box, enter the following information to define the friend relationship:
      • Name: Specify a name for this relationship to help you identify it in a list. For example, if you are creating a friend relationship with an installation of Rational Engineering Lifecycle Manager that is hosted on a computer that is named relm.example.com, then you might specify RELM on relm.example.com.
      • Root Services URI: Specify the Uniform Resource Identifier (URI) for the root services document.
      • OAuth Secret and Re-type Secret: Specify a string that contains one or more words and special characters, and that does not 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.

    5. Select the Trusted check box.
      Note: Trusted consumers can share authorization with other trusted consumers and do not require user approval to access data.
    6. Click Create Friend. If the friend is added successfully, a message indicating that a provisional key was generated is displayed.
    7. Click Next.
    8. In the Authorize Provisional Key dialog box, click Grant access for the provisional key. If the account that you used to log in does not have administrator privileges on the friend server, a login window for the friend server is displayed.
    9. In the Authorize Provisional Key dialog box, click Approve. A message is displayed indicating that the provisional key has been marked as Approved.
    10. Click Finish. On the Friends page, the friend relationship is established and the relationship is displayed in the list of friends.
      Tip: To edit the properties of a friend server, or to delete it from the list, select a friend and, in the Actions column, select an action to complete.
  2. On the Lifecycle Query Engine server, accept the friendships by completing the following tasks:
    1. Go to Jazz Team Server on which Lifecycle Query Engine is registered. For example: https://<server>:9943/jts/admin
    2. On the Administration page, click Server.
    3. From the menu on the left side of the page, under Communication, click Consumers (Inbound).
    4. On the OAuth Consumers page, in the Provisional Keys section where new requests are listed, complete the following steps:
      1. Consumer Name: To identify the application that uses the consumer key, update the field with the name of the application that is requesting access to this application.
      2. Trusted: Select this check box if the consumer shares authorization with other trusted consumers.
      3. Authorized: Change the value from Pending to Approved.
    5. Click Save.
    The keys are displayed in the Authorized Keys section of the page. The requesting Jazz applications can now use the keys to communicate with Lifecycle Query Engine.

Feedback