Orphaned keys need to be cleaned up

Technote (troubleshooting)


Problem(Abstract)

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.


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Quality Manager Team Server Linux, Windows 3.0.1, 3.0.1.1, 3.0.1.2, 3.0.1.3, 4.0
Software Development Rational Requirements Composer Team Server Windows, Linux 3.0.1, 3.0.1.1, 3.0.1.2, 3.0.1.3, 4.0

Rate this page:

(0 users)Average rating

Document information


More support for:

Rational Team Concert
Team Server

Software version:

3.0.1.1, 3.0.1.2, 3.0.1.3, 4.0

Operating system(s):

AIX, Linux, Solaris, Windows

Reference #:

1573461

Modified date:

2014-05-13

Translate my page

Machine Translation

Content navigation