Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Do this in IBM Jazz:

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

  2. Select the "Server" tab

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

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

    2. Add a consumer secret twice. You will need to add the same secret later on the Smartfacts 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 Smartfacts side to add a friend.

...

Steps 1 and 2 allow Smartfacts to retrieve data form the IBM Jazz instance.

Step 3: On the Smartfacts side, define an external Server if you use Global Configuration Management

  1. Open the Modelwarehouse Profile, select the External Servers tab and add new external server.

  2. Select OSLC as a source type

  3. Add the url of the global config management server of Jazz: https://[ibm-jazz_base_url]:9553/gc/rootservices

  4. Select Jazz Auth as authentication method

  5. Add the security check URL: https://[ibm_jazz_base_url]:9443/jts/j_security_check

  6. Add a technical username and password

Step 4: On the IBM Jazz side, add Smartfacts as a Friend (Outbound) on JTS Level

  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.

    1. Add the root services file URL of Smartfacts. You will find this URL in Smartfacts in the MWH profile in the Smartfacts tab.

    2. Add a name if it is not generated automatically, e.g. "Smartfacts".

    3. Click "Next".

    4. Add any secret.

    5. Check "Trusted".

    6. Click "Create Friend".

Important! 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 Smartfacts manually. You can do this via these domains:

The user will now be able to add associations to a Smartfacts project or to add models to a GC on the IBM Jazz side.

Step

...

5: Whitelisting on the IBM Jazz Side

You must repeat the following steps for all IBM Jazz applications you want to use for linking Smartfacts 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 application URLs:

    DOORS Next: https://[ibm jazz base url]:9443/rm/admin
    Engineering Test Management: https://[ibm jazz base url]:9443/qm/admin
    Engineering Workflow Management: https://[ibm jazz base url]:9443/ccm/admin
    Global Config Management: https://[ibm jazz base url]:9443/gc/admin

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

  3. Enter the base URL of the Smartfacts instance you want to whitelist.

  4. Click "Add".

...