Repository tools command to export the Requirements Management application link validity data during migration

Use the rmExportLinkValidity command to export link validity to a .csv file.

Purpose

The rmExportLinkValidity command connects to Jazz® Team Server and runs a simple data query to fetch link validity information and saves it into a .csv file on the Requirements Management server.

To run this command, the Jazz Team Server specified by the repositoryURL argument must be running.

Parameters

Attribute Description Required Default
toFile Path to the Jazz Team Server output link validity comma delimited file. If a relative path is provided, it is relative to server directory. No server/rmLinkValidityToFile.csv
overwrite Whether to overwrite an existing .csv file. No None
repositoryURL The Jazz Team Server root URL.

For a multi-JTS environment, this should identify the URL of the Jazz Team Server that the LQE is registered with. This should be the URL that is defined in the advanced admin property (Shared Validity Provider URL) of the JTS that RM is registered with. If no URL is defined, then use the URL of the Jazz Team Server that the RM application is registered with. Note that this Jazz Team Server should already be upgraded to 7.0, deployed, and running.

No https://localhost:port/jts
adminUserId Administrative user ID to login to the Jazz repository. No ADMIN
adminPassword Administrative user password to login to the Jazz repository. No ADMIN
credentialsFile The file containing the administrative user login credentials. No credentials.properties
certificateFile The file containing the administrative user certificate file. No none
smartCard The alias to login using a smart card. Type ? to list the available aliases. No none
logFile Path to the log file. No repotools-rm_rmExportLinkValidity.log
kerberos Authenticate with Windows user credentials using Kerberos/SPNEGO by setting to true. Or authenticate with Windows Integrated Authentication by setting to windows. No None

Example

Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-rm.bat -rmExportLinkValidity toFile=Path_to_rmLinkValidityToFile.csv adminUserId=ADMIN adminPassword=ADMIN repositoryURL=https://hostname.example.com:port/jts logFile=Path_to_repotools-rm_rmExportLinkValidity.log

Open a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./repotools-rm.sh -rmExportLinkValidity toFile=Path_to_rmLinkValidityToFile.csv adminUserId=ADMIN adminPassword=ADMIN repositoryURL=https://hostname.example.com:port/jts logFile=Path_to_repotools-rm_rmExportLinkValidity.log