Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Step 1. Jira: Adding the Jazz Certificate

  1. In the Jira admin area, click "manage apps". You need Jira admin rights to do that.

  2. Put the Jazz certificate to the trust-store on the Jira server.

  3. Select the "Network Configuration" tab and set path to the trust-store and click “apply”. If the trust store text fiels is not visible, switch the SSL parameters to “No SSL” and back to “default settings”.

  4. Test the connection with https://[ibm-jazz base url]:9443/jts/admin

Step 2: IBM ELM: Adding Consumers

  1. Consumers must be registered for all Jazz applications you want to integrate with Jira. So, the following steps must be performed for all of these applications:
    DOORS Next  https://[ibm jazz base url]:9443/jts/admin    ## Note: The DNG consumer must be registered in JTS
    ETM  https://[ibm jazz base url]:9443/qm/admin
    EWM  https://[ibm jazz base url]:9443/ccm/admin
    you do not have to do the following steps for GCM.

  2. Click the “server” tab

  3. Select "Consumers (Inbound)" in the menu on the left

    1. Add any consumer name, e.g. "Jira".

    2. Add a consumer secret twice. You will need to add the same secret later on the Jira side.

    3. Check "trusted".

    4. Click "register". The consumer should be added to the list of consumers below.

    5. Copy the consumer key from the newly-added consumer. You will need it on the Jira side.

Step 3: Jira: Adding Friends

  1. Select the "Friends Management" tab.

  2. Click "Add OSLC Source Configuration" (1) and do the following steps for all Jazz applications you want to connec to to Jira

    1. Enter any Name like "DOORS Next OSLC Source".

    2. Enter the root services url of your Jazz applications’ instance:
      DOORS Next  https://[ibm jazz base url]:9443/rm/rootservices
      ETM  https://[ibm jazz base url]:9443/qm/rootservices
      EWM  https://[ibm jazz base url]:9443/ccm/rootservices
      GCM  https://[ibm jazz base url]:9443/gc/rootservices

    3. Select the correct OSLC domain: "RM" for DOORS Next, "QM" for ETM, "CCM" for EWM, "GC" for GCM.

    4. Paste the consumer key copied in step 2.3.e. and add the secret from 2.3.b.

    5. Save the friend.

    6. Use the "Test" button (2) to test if the IBM Jazz root service can be accessed from Jira. The log should show a status "200".

Step 4: Jira: Configure the Link Types

  1. Select the “Link Types" tab.

  2. Click the ‘Add link type’ button. If no link type was registered, a popup with all available link type options will appear, choose the necessary link types from the list and click “add”

  3. Manually add the link types you need for linking with all your OSLC sources.

  4. You can also import a CSV file with all standard OSLC link types required for connecting to IBM Jazz and Smartfacts.

Step 5: IBM ELM: Adding Friends

  1. Go to https://[ibm-jazz base url]:9443/jts/admin

  2. Select "Friends (Outbound)" in the menu on the left.

  3. Click "Add" in the upper right corner of the screen.

  4. Add the root services file URL of Jira: https://[jira-base-url]/rest/jirarestresource/1.0/rootservices. Add a name if it is not generated automatically, e.g. "Jira".
    If you are not sure what the correct url for the root services file is, you can also look up the value in the “Friends Management" tab in the apps management area of Jira. You need Jira admin rights to do that.

  5. Click "Next".

  6. Add any secret.

  7. Check "Trusted".

  8. Click "Create Friend".
    You must check if all the Jazz applications have inherited the friends definition from the JTS level. There are configurations in Jazz that do not allow that. In this case, you must add the friendship from every Jazz application to Jira manually. You can do this via these domains:

  9. DOORS Next  https://[ibm jazz base url]:9443/rm/admin
    ETM  https://[ibm jazz base url]:9443/qm/admin
    EWM  https://[ibm jazz base url]:9443/ccm/admin
    GCM  https://[ibm jazz base url]:9443/gc/admin

  10. The user will now be able to add associations to a Jira project.

Step 6: Jira: Manage Consumers

  1. Navigate to Admin -> Manage Apps -> Consumers Management.

  2. There should be a provisional key listed on top of the page. Authorize this provisional key.

Step 7: IBM ELM: Whitelisting Jira

You must repeat the following steps for all IBM Jazz applications you want to use for linking Jira model elements and IBM Jazz artifacts. If you are using global config management, you must also do the whitelisting in the global config management application.

  1. Go to the admin page of an IBM Jazz application where you want to add a whitelisting. These are the typical URLs:
    DOORS Next  https://[ibm jazz base url]:9443/rm/admin#action=com.ibm.team.repository.admin.proxyConfiguration
    ETM  https://[ibm jazz base url]:9443/qm/admin#action=com.ibm.team.repository.admin.proxyConfiguration
    EWM  https://[ibm jazz base url]:9443/ccm/admin#action=com.ibm.team.repository.admin.proxyConfiguration
    GCM  https://[ibm jazz base url]:9443/gc/admin#action=com.ibm.team.repository.admin.proxyConfiguration

  2. Enter the base URL of the Jira instance you want to whitelist.

  3. Click "Add".

You do not have to add a whitelisting on JTS level. This will allow Jira to display delegated UIs from an IBM Jazz application.

  • No labels