Remove any existing friends and keys

For Jazz products to interact with each other, each server must add the other server to its list of friends. You do this by configuring cross-server communication. Before you do this, remove any server friend entries and keys that might remain from previous configurations.

About this task

Note: If you or someone else has worked with the cross communication set up, it is possible that previous attempts were made that may or may not have been successful. To ensure a clean start, it is best to remove existing server friend entries.

To find and remove existing friends and keys:

Procedure

  1. Open the server administration interface as a member of the JazzAdmins group:
    • For IBM® Rational® Team Concert and IBM Rational Requirements Composer, log in to the Admin Web UI and click the Server tab.
    • For IBM Rational Quality Manager, click Admin > Jazz Server Administration.
  2. In the Configuration pane, click Cross-Server Communication.
  3. On the Cross-Server Communication page, scroll to the Server Friends List section and verify that it does not contain any friends. If any friends exist, delete them by clicking the Delete Friend icon.

    The following table shows some sample entries to the Server Friends List:

    Table 1.
    Title Root Services URI OAuth Consumer Key  
    My Team Concert Server https://rtc.mass.ibm.com:9443/jazz/rootservices 1cff4f920e4c429981d33600f35cfd1a X
    My Requirements Server https://rrc.mass.ibm.com:9443/rdm/rootservices 5jght786hdjmj729ki56m8947nedg5rf X
    My Test Server https://rqm.mass.ibm.com:9443/jazz/rootservice 67890yjnhfyeudjsnf5092kjqrtdnm56 X
    Note: Rational Requirements Composer uses a fronting server application, and that application has an internal friend relationship with the Rational Requirements Composer Jazz Team Server. The Cross-Server Communication page for the Rational Requirements Composer server includes an additional section, Internal Friends List, that lists the friend relationship between the fronting server application and the Jazz Team Server. Do not remove entries from the Internal Friends List.
  4. In the Configuration pane, click Oauth Consumer Management. In the Authorized Keys section, delete any existing keys by clicking the Delete Consumer Key icon.
    Note: The Oauth Consumer Management page for the Rational Requirements Composer server Rational Requirements Composer lists a key for the internal friend relationship between the fronting server application and the Rational Requirements Composer Jazz Team Server. Do not remove this key.
  5. Click Save to save your changes. Restart the Jazz Team Server. Repeat this procedure for the other Jazz Team Servers.

What to do next

You can now configure cross-server communication.

Feedback