IBM Support

Orphaned keys need to be cleaned up

Troubleshooting


Problem

Attempts to run the IBM Rational Jazz Team Server (JTS) diagnostics results in consumer key errors with IBM Rational Team Concert (RTC).

Symptom

In the Diagnostic page of jts/admin web UI, the following error will be seen under the Jazz Foundation Services (JFS) Storage:



WARNINGS:
The consumer key <key hash> used by the storage
area com.ibm.team.lpa.ab23d2df-5000-44bf-82e3-24f1b41a86be does not exist.

This behavior may also render itself with the following error message in Diagnostics:
CRJZS5766W Resources cannot be accessed from the com.ibm.team.rdm.binary.resources storage area because the <key hash> consumer key does not exist. Create a consumer key, stop the server, and set the new consumer key to the storage area by using the "repotools-jts -setStorageAreaKeys list=com.ibm.rdm.binary.resouces,<new consumer key>". For more details, open the help system and search for CRJS5766W.

Cause

The application does not automatically delete old key references, so when re-registering applications, the referenced keys may still exist and cause warnings or errors in the Diagnostics.

Resolving The Problem

To removed the unwanted keys, the following steps should be followed:

  1. Shutdown the Jazz Team Server and associated applications

  2. Run the following command to delete the referenced keys:

    ${JAZZ_HOME}\server\repotool-jts.bat repotools-jts.bat -deleteJFSResources consumerKey=${KEY_ID} force

    Using the screenshot above as an example, the following command would be run:

    repotools-jts.bat -deleteJFSResources consumerKey=fd43db48d8f94cd0baadcaaea251d94f force

  3. Rebuild the jazz indices: https://jazz.net/wiki/bin/view/Deployment/UnderstandingIndicesInJazz See section repotools reindex.

  4. After the command succeeds, restart the application server. The Diagnostics should complete successfully and without error.



Leverage the Jazz Community
Jazz and Rational Team Concert have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki.
Refer to technote 1319600 for details and links.

[{"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Team Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"3.0.1;3.0.1.1;3.0.1.2;3.0.1.3;4.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"Team Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"3.0.1.1;3.0.1.2;3.0.1.3;4.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSWMEQ","label":"Rational Requirements Composer"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Team Server","Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"3.0.1;3.0.1.1;3.0.1.2;3.0.1.3;4.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Team Concert;Rational Quality Manager

Document Information

Modified date:
16 June 2018

UID

swg21573461