IBM Support

Utility for updating a renamed or moved Rational Change server in Rational DOORS

How To


Summary

When you integrate IBM Rational DOORS and IBM Rational Change, object URLs are stored in files in the database. These include protocol, server host, and port number settings. If the Rational Change server is moved or renamed, the Rational DOORS integration with Rational Change stops working. The attached script helps with the server rename process in Rational DOORS.

You can consult a support representative when working with this script.

Objective

Update all instances of the Rational Change server in Rational DOORS with the new protocol, host, and port settings.

Steps

Steps for updating a renamed or moved Rational Change server:

Note: Always take a backup of the Rational DOORS database before making the following changes.

  1. Open the attached script.
  2. Edit the sections marked at the top of the file to reflect the existing and required change settings. You must change the elements indicated below in italics to reflect the server in use.

    Note: Use double backslashes (path delimiters) for START_DIRECTORY.

    // Root of DOORS database tree
    const string START_DIRECTORY = "C:\\DOORS\\Data"
    
    // Old server details
    const string OLD_PROTOCOL = "doors"
    const string OLD_SERVER_NAME = "WIN08R2EEX64"
    const string OLD_SERVER_PORT = "36677"
    
    // New server details
    const string NEW_PROTOCOL = "doors"
    const string NEW_SERVER_NAME = "WIN08R2EEX65"
    const string NEW_SERVER_PORT = "36678"
  3. Run the script and wait for it to complete.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Component":"Change Integration","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
01 May 2020

UID

ibm10735847