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