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.
Purpose
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.
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 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 |
Example
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
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