Repository tools command to import the server rename mappings file

Use the importURLMappings command to import a previously-generated and edited mapping file into the target Jazz® Team Server for use with server rename.


Note: This command is not supported in a cluster environment.

The importURLMappings command is used to perform a server rename, that is, change the public URL of the Jazz Team Server or one or more IBM® Engineering Lifecycle Management (ELM) applications, after those applications are deployed. This command uses a previously-generated mapping file. The importURLMappings command must be run with the repotools-jts command.

Important: You must shut down the server before you run the command. The rename will begin offline on the Jazz Team Server, before the server is restarted.


Attribute Description Required Default
fromFile Path to the previously-generated mappings file. Yes mappings.txt
logFile Path to the log file. No repotools-jts_importURLMappings.log Path to the file. No conf/jts/
serverConfFile Path to the file containing a list of server configuration directories. This parameter is optional if the Jazz Team Server and applications are all installed on the same application that this command is run from. This list is required if the deployment is distributed across multiple application servers. In this case, the list must include an entry for each application server's configuration directory. Yes, if distributed or clustered None
noPrompt Do not prompt before importing the mappings. No N/A


For Windows operating system Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -importURLMappings fromFile=C:\mapping.txt\jts\

For Unix operating systems Open a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./ -importURLMappings fromFile=opt/mapping.txt