Remapping URIs after renaming a CLM server

You must remap Jazz Team Server public URI artifact links for the Rational solution for Collaborative Lifecycle Management (CLM) resources after a server rename operation. Specifically, these are links that are stored in IBM Rational ClearQuest Web server configuration files and in OSLCLinks records in the ClearQuest user database.

About this task

Starting in the version 4.0 products for the Rational solution for Collaborative Lifecycle Management (CLM), administrators can change the public URI of a Jazz Team Server or a Rational solution for CLM application after deployment by using the server rename operation. Such changes require corresponding updates to the Rational solution for CLM resources that are based on the URI. For the ClearQuest Bridge, these artifact links for the Rational solution for CLM product resources (IBM Rational Team Concert, IBM Rational Quality Manager, and IBM Rational DOORS Next Generation) are stored in ClearQuest Web server configuration files and in OSLCLinks records in the ClearQuest database.

Procedure

Send a notification to the ClearQuest user community that all links to the Rational solution for CLM artifacts are broken and that a URI remapping procedure will begin soon to fix the broken links. Warn users that they cannot currently create new OSLC links to the Rational solution for CLM artifacts. Users can continue to perform ClearQuest Web activities that do not involve the ClearQuest Bridge.
Log on to ClearQuest Web server as a user with both local administrator and ClearQuest Super User privileges.
Reconfigure cross-server communication only on the ClearQuest Web server. For each Rational solution for CLM cross-server friend for which you have reestablished cross-server communication, run the URI remapping tool, clm_server_rename.pl, with the -remapconfigfiles option. This updates the ClearQuest Web server configuration files.
Important: When you use this option, you must run the tool in the directory where the tool is installed.

For example, if ClearQuest is integrated with IBM Rational Team Concert and IBM Rational Quality Manager, and both the Jazz Team Server for Rational Team Concert and the Rational Quality Manager server are renamed, then you must run the tool with the -remapconfigfiles option twice: once for remapping the URIs for the Rational Team Concert artifact links, and once for remapping the URIs for the Rational Quality Manager artifact links.
Notify users to log off ClearQuest Web server. Then restart the server.
Notify users that they can log on to ClearQuest Web server and create new links to the Rational solution for CLM artifacts. Mention, however, that following existing links to the Rational solution for CLM artifacts will not work yet, and you will send another notification after these links are fixed.
For each Rational solution for CLM cross-server friend for which you have reestablished cross-server communication, run the clm_server_rename.pl tool again with the -update option. This updates the URI artifact links that are stored in ClearQuest OSLCLink records.
For example, if ClearQuest is integrated with IBM Rational Team Concert and IBM Rational Quality Manager, and both the Jazz Team Server for Rational Team Concert and the Rational Quality Manager server are renamed, then you must run the tool with the -update option twice: once for remapping the URIs for the Rational Team Concert artifact links, and once for remapping the URIs for the Rational Quality Manager artifact links.
If your deployment includes Rational ClearQuest MultiSite, you must repeat Step 6 at each replica where the affected ClearQuest OSLCLinks records are mastered. The tool reports the OSLCLinks records that are mastered remotely.
Notify users that the URI remapping is complete. Be sure to specify the limitations of remapping as described in the Limitations section of the clm_server_rename.pl help.

Feedback