Using Rational Team Concert server rename feature to rename Rational Change and Rational Synergy links stored in Rational Team Concert

Resolving The Problem

IBM Rational Team Concert version 4.0 and above support server rename using a command in repotools utility, importURLMappings, to rename all installed application server URLs.

Input to this command requires a mapping file which needs to be created manually.

This is applicable to any standard URLs from Rational Synergy 7.1 / 7.2 and its future releases and Rational Change 5.1/5.2 / 5.3 and its future releases.

---

Command Syntax:

repotools-jts.sh –importURLMappings fromFile=<path to URL mapping files> teamserver.properties=<path to jts team server properties file>

Note: teamserver.properties is an optional argument. Log file is stored under the current working directory.


Creating a URL mapping file:

Create a text file locally with the following format:

#Source URL
source= Standard http URL(Can be full URL or part of the URL)
#Target URL
target= Standard http URL(Can be full URL or part of the URL)

Examples:

Below examples illustrates how server rename can be used in different scenarios.
Below examples are all for a Windows OS.


Consider the following Change URL:

http://my_host:8600/my_context/PTweb?ACTION_FLAG=frameset_form&TEMPLATE_FLAG=ProblemReportView&database%ccm_home%2Fccmdb%2Fmy_database&role=User&problem_number=1


Example 1:
Only port number and context is changed and all other parameters remain same

Text file contents:
#Source URL
source= http://my_host:8600/my_context
#Target URL
target= http://my_host:8610/my_new_context

Command to execute:
repotools-jts.bat -importURLMappings fromFile=<PATH to URL Mappings file>


Example 2:
Only database name is changed and everything else remains same.

Text file contents:
#Source URL
source= http://my_host:8600/my_context/PTweb?ACTION_FLAG=frameset_form&TEMPLATE_FLAG=ProblemReportView&database%ccm_home%2Fccmdb%2Fmy_database&role

 #Target URL
target= http://my_host:8600/my_context/PTweb?ACTION_FLAG=frameset_form&TEMPLATE_FLAG=ProblemReportView&database%ccm_home%2Fccmdb%2Fmy_new_database&role


Example 3:
Hostname changes and everything else remains the same.

Text file contents:
#Source URL
source= http://my_host:8600/my_context

 #Target URL
target= http://my_new_host:8600/my_context


Example 4:
Updating synergy task link when hostname changes.

Text file contents:
#Source URL
source= http://my_synergy_host:8471/oslc/scm/database/~~ my_synergy_host ~ccmdb~my_database/changeset/10286
 
#Target URL:
target= http://my_new_synergy_host:8471/oslc/scm/database/~~ my_new_synergy_host ~ccmdb~my_database/changeset/10286


Note: Synergy tasks that are migrated using Rational Synergy for Rational Team Concert Interface 1.1 are stored as 4 part link and not standard URL hence cannot be renamed using the above command.

For more information and options on the command, review the following information center article Rational Team Concert - server rename.

For information on Rational Synergy URL rename feature, review the following information center article Updating references to a renamed integration server.