Repository tools command to verify a mapping file

Use the verifyURLMappings command before a rename to verify that the mapping file is valid.

Purpose

The verifyURLMappings command is used to verify a mapping file. Run the command after you generate and edit a mapping file, but before you import the mapping file into the server. verifyURLMappings must be run with the repotools-jts command and requires that the repositoryURL parameter point to a Jazz™ Team Server. The command performs the following verifications:

Note: Problems reported by this command do not necessarily indicate that the mapping file is wrong. It is mostly to alert administrators to any discrepancies between the generated file and the verified file.

Parameters

Attribute Description Required Default
mappingFile Path to the mapping file to verify. No mapping.txt
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
repositoryURL The connection URL for the server. No https://localhost:9443/jts
credentialsFile The file containing the administrative user login credentials. No credentials.properties
certificateFile The file containing the administrator user's certificate file. No none
logFile Path to the log file. No repotools-jts_verifyURLMappings.log
smartCard The alias to login using a smart card, or ? to list available aliases. No none

Example

Windows:
cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -verifyURLMappings mappingFile=C:\mappings.txt
Linux:
cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -verifyURLMappings mappingFile=opt/mappings.txt

Feedback