Repository tools command to rename the URI in the data warehouse
You can use the renameURIInWarehouse command to rename the public Uniform Resource Identifier (URI) in the data warehouse.
Purpose
The renameURIInWarehouse command is for use with server rename to replace an old URI with a new URI in the data warehouse. You can run this command when the typical server rename operation is incomplete for some reason in the data warehouse. For example, the data warehouse was unintentionally offline or the URLs in the data warehouse aren't getting renamed.Important: You must shut down the server before you run the command.
Parameters
| Attribute | Description | Required | Default |
|---|---|---|---|
| teamserver.properties | The file system path to the teamserver.properties file. | No | conf/application/teamserver.properties
where application is jts, ccm, rm, qm, gc, dcc, or relm. |
| logFile | The path to the log file. | No | repotools-application_renameURIInWarehouse.log
where application is jts, ccm, rm, qm, gc, dcc, or relm. |
| noPrompt | Do not prompt before updating the tables. | No | N/A |
| oldURI | The old URI to be renamed. | Yes | https://<old_hostname>:<port>/<application>For
example, where old_hostname is the old URI to be renamed, port is the port number, and application is jts, ccm, am, rm, qm, gc, dcc, or relm. |
| newURI | The new URI. | Yes | https://<new_hostname>:<port>/<application>For
example, where new_hostname is the new URI to replace the old URI, port is the port number, and application is jts, ccm, am, rm, qm, gc, dcc, or relm. |
Example
The following example is for Jazz® Team Server. To use
this command for other applications, run these options from the server directory:
- IBM® Engineering Workflow Management (Change and Configuration Management application): repotools-ccm
- IBM Engineering Requirements Management DOORS® Next (Requirements Management application): repotools-rm
- IBM Engineering Test Management (Quality Management application): repotools-qm
- Global Configuration Management: repotools-gc
- Data Collection Component: repotools-dcc
- IBM Engineering Lifecycle Optimization Engineering Insights: repotools-relm
Open a command prompt and enter this command:
cd C:\Program Files\IBM\JazzTeamServer\server\ repotools-jts.bat -renameURIInWarehouse teamserver.properties=conf\jts\teamserver.properties oldURI=https://host.example.org:9443/jts newURI=https://newhost.example.org:9443/jts
Open a command line and enter
this command:
cd opt/IBM/JazzTeamServer/server/ ./repotools-jts.sh -renameURIInWarehouse teamserver.properties=conf/jts/teamserver.properties oldURI=https://host.example.org:9443/jts newURI=https://newhost.example.org:9443/jts