Remove 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 configuration attempts.

About this task

If you or someone else has worked with the cross-server 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.
Important: Do not remove the friend entry for the Rational Requirements Server, if it is present. This entry is created on the Cross-Server Communication Internal Friends list and in the OAuth Consumer Management Authorized Keys section when you install and configure the IBM® Rational® Requirements Composer server. It is required for the client access to the server.

Procedure

  1. Open the server administration interface as a member of the JazzAdmins group:
    • For IBM Rational Team Concert and 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.
    Important: Do not delete the Rational Requirements Server from the Internal Friends List, if it is present.

    The following table shows example 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
  4. In the Configuration pane, click Oauth Consumer Management. In the Authorized Keys section, delete existing keys by clicking the Delete Consumer Key icon.
    Important: Do not delete the Rational Requirements Server entry from the Authorized Keys section, if it is present.
  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