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, https://clmhost.example.org:9443/jts

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, https://newhost.example.org:9443/jts

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

For
Windows operating system 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

For Unix operating systems Open a command line and enter this command:

cd C:\Program Files\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