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.
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
- Point your browser to one of the following URLs by using
the default context root value:
- https://fully qualified hostname:port/jts/admin
Log in to the Rational Requirements
Composer server by using an account that has administrator privileges.
- https://fully qualified hostname:port/ccm/admin
Log in to the Rational Team Concert™ server by using an account that has administrator
privileges.
- https://fully qualified hostname:port/qm/admin
Log in to the Rational Quality
Management server by using an account that has administrator privileges.
- 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.
- In the Communications section, click Friends
(Outbound).
- At the Friends List, click Add. The Add Friend window opens.
- For Name, type the name that you
want to use to identify the JIRA friend application.
For
example, JIRA server
- 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 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.
- 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.
- Click Create Friend. A confirmation
message opens. Click Next to continue.
- 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.
- 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.
- In the Authorize Provisional Key window,
click Approve and Finish.
- 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.