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
- For each lifecycle application, create a Friend relationship
by completing the following steps:
- Log in to the application's Administration page: https://<server>:<port>/jts/admin
- Click Server and in the Communication
section, click Friends (Outbound).
- In the Friends List section,
click Add.
- 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.
- Select the Trusted check box.
Note: Trusted consumers can share authorization with other
trusted consumers and do not require user approval to access data.
- Click Create Friend. If the friend is added successfully, a message indicating
that a provisional key was generated is displayed.
- Click Next.
- 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.
- In the Authorize Provisional Key dialog
box, click Approve. A message
is displayed indicating that the provisional key has been marked as
Approved.
- 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.
- On the Lifecycle
Query Engine server,
accept the friendships by completing the following tasks:
- Go to Jazz Team Server on
which Lifecycle
Query Engine is
registered. For example: https://<server>:9943/jts/admin
- On the Administration page, click Server.
- From the menu on the left side of the page, under Communication,
click Consumers (Inbound).
- On the OAuth Consumers page, in
the Provisional Keys section where new requests are listed, complete
the following steps:
- 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.
- Trusted: Select this check box if the consumer
shares authorization with other trusted consumers.
- Authorized: Change the value from Pending
to Approved.
- 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.