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.

Purpose

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 theJazz 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.

Parameters

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
teamserver.properties Path to the teamserver.properties file. No conf/jts/teamserver.properties
serverConfFile Path to the file containing a list of server configuration directories. This parameter is optional if the JTS 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

Example

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 teamserver.properties=conf\jts\teamserver.properties

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

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -importURLMappings fromFile=opt/mapping.txt teamserver.properties=conf/jts/teamserver.properties

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki