Troubleshooting
Problem
Attempts to register the IBM Change and Configuration Management application in IBM Rational Team Concert results in the application listed as unknown in IBM Jazz Team Server.
Symptom
The following symptoms may be seen:
- The dashboards page does not fully resolve
- You cannot create a new widget through the dashboards page
- Within the Jazz Team Server, under "Registered Applications" the Change and Configuration Management application is listed but is described as "unknown"
- There is no link to the Change and Configuration Management application on the Jazz Team Server home page
- When clicking on the home icon from Change and Configuration Management application, you receive the following error:
Cause
This may occur when Rational Team Concert is referencing old consumer keys instead of the new keys generated by registering the Change and Configuration Management application. This can happen when you delete and recreate the consumer keys or re-register the Change and Configuration Management application.
Resolving The Problem
Steps to resolution:
Note: The following steps assume that you have just deleted/re-registered the Change and Configuration Management application or individual consumer keys.
- After having re-registered the Change and Configuration Management application, you will have new consumer keys for the Change and Configuration Management, dashboard, repository and theme by default on the Jazz Team Server Consumers (Inbound) screen
- Copy the keys for the dashboard, repository and theme to a notepad for your reference later
- Shut down the server
- On the command prompt, navigate to Jazz_Install_directory\JazzTeamServer\server
- Using repotools, run the following command:
repotools-jts -listStorageAreaKeys toFile=C:\Temp\storageAreaKeys.csv
- Open the storageAreaKeys.csv file in word pad and replace the listed consumer keys with your existing keys which were saved in notepad in step 2.
Note: dashboard is listed twice, enter the corresponding dashboard key twice
- Save the changes to storageAreaKeys.csv file
- Using repotools, run the following command:
repotools-jts -setStorageAreaKeys fromFile=C:\Temp\storageAreaKeys.csv
- Start the Jazz Team Server
Upon accessing the Jazz team Server you will notice that the Dashboard issues have now been fully resolved as well as the Home button. However, the link between the Jazz Team Server/Change and Configuration Management application still needs to be re-established.
- From the Jazz Team Server, navigate to the Registered Applications and delete the existing entry for the Change and Configuration Management application marked as "unknown". This will automatically delete the consumer key for the application.
- From the Change and Configuration Management application, navigate to the Friends(Outbound) screen and delete the existing listing for the Jazz Team Server
- From the Change and Configuration Management application, navigate to the Consumers(Inbound) and delete the corresponding consumer key for the Jazz Team Server
- Run through the Setup Wizard one final time to re-register the Change and Configuration Management application
After performing these steps the links between the Jazz Team Server and Change and Configuration Management application will be re-established.
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. |
---|
Related Information
Product Synonym
Rational Team Concert
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21496282