The generateURLMappings command is used to generate an initial mapping file for use with server rename. generateURLMappings must be run with the repotools-jts command, and requires that the repositoryURL parameter point to a Jazz™ Team Server.
The generated mapping file can be used as a template for further editing. The mapping file lists the existing source Public URL and a default target URL for the Jazz Team Server and each JTS application that is registered with the Jazz Team Server.
| Attribute | Description | Required | Default |
|---|---|---|---|
| toFile | Path to the generated mappings file. | Yes | N/A |
| adminUserId | Admin user ID to log in to the Jazz repository. | No | ADMIN |
| adminPassword | Admin password to log in to the Jazz repository. | No | ADMIN |
| overwrite | Specifies whether or not to overwrite an existing mapping file that was generated previously. | No | no |
| logFile | Path to the log file. | No | repotools-jts_generateURLMappings.log |
| repositoryURL | The connection URL for the server. | No | https://localhost:9443/jts |
| credentialsFile | The file containing the administrator user's login credentials. | No | credentials.properties |
| certificateFile | The file containing the administrator user's login certificate. | No | None |
| smartCard | The alias to login using a smart card, or ? to list available aliases. | No | None |
| additionalURLFile | File containing additional URLs found in the repository that should be reviewed for additional mappings. See below for further details. | No | additionalurl.txt |
The additionalURLFile parameter specifies the location to place a list of URLs that could potentially need to be added to the mappings file before performing a server rename. This file lists all URLs found in the repository that are not listed in the generated URL mappings file.
An example would be a URL to a deleted friend entry. It is up to the user performing the server rename to look through this list thoroughly for any mappings that the automated process may have missed. Any mappings can then be added manually to the mappings file before performing the actual server rename.
Each row in this list has a URL and a number. The number shows how many instances of the URL were found in the repository. The list is sorted in descending order to show the most important potential URLs first in the list.
If no additional potential URLs are found, this file should simply contain the message No additional potential URLs found.
cd C:\Program Files\IBM\JazzTeamServer\server\ repotools-jts.bat -generateURLMappings toFile=C:\mappings.txt additionalURLFile=C:\additionalurl.txtLinux:
cd opt/IBM/JazzTeamServer/server ./repotools-jts.sh -generateURLMappings toFile=opt/mappings.txt additionalURLFile=opt/additionalurl.txt