Running the Rational TestManager migration wizard

You migrate your IBM® Rational® TestManager artifacts by running the migration wizard.

Before you begin

Before you run the migration wizard, make sure that you meet these requirements:

Procedure

  1. Extract the contents of the RTMMigration.zip file from the JazzInstallDir\server\conf\ContextRoot\migration folder to the computer that is running your Rational TestManager client.
    Note: The default path to JazzInstallDir on a 32-bit Windows computer is C:\Program Files\IBM\JazzTeamServer. The default path to JazzInstallDir on a UNIX computer is /opt/IBM/JazzTeamServer.

    In a new installation, the ContextRoot would be qm. If you are upgrading from the previous release, the ContextRoot would be jazz.

  2. Copy the contents of the RTMMigration folder to the RTM_install_dir\Rational Test folder.
  3. Browse to the RTM_install_dir\Rational Test folder, and run RQMMigration.exe.
  4. On the first page of the migration wizard, click Next, and provide the appropriate Rational TestManager repository information.

    This information includes the Rational TestManager repository to migrate, the location of the repository, and the user name and password.

  5. Click Next, and provide the Rational RequisitePro® web server information, if one is integrated with the Rational Quality Manager server. Otherwise, click No, Manage requirements using RRC Server.
  6. Click Next, and if prompted, specify whether you have an association with either the Rational ClearQuest Connector or the Rational ClearQuest Bridge. If you have an association with the Rational ClearQuest Bridge, provide the DBID of the default ClearQuest record type.
    Follow these steps to find the DBID of the default ClearQuest record type:
    1. From Rational Quality Manager , create a Rational ClearQuest defect by using the Rational ClearQuest Bridge. Do not link to an existing defect; only a new defect uses the default record type of the ClearQuest schema.
    2. View the URL of the new defect. The URL is in this format:

      <http or https>://<CQ Web server:port>/cqweb/oslc/repo/<schema repository connection>/db/<user database>/<dbid>-<record id>

      The <dbid> is the DBID of the default record type. For example, if the defect URL is http://mycqweb.ibm.com/cqweb/oslc/repo/Connection1/db/SAMPL/record/16777576-33554487, 16777576 is the ID that you enter in the Default RecordType Dbid field of the migration wizard.

  7. Click Next, and provide the appropriate Rational Quality Manager server information.

    This information includes the fully qualified path to the server, and the user name and password for the server.

  8. Click Next, and select the Rational Quality Manager target project area for artifact migration.
  9. Click Next to display the migration summary page.
  10. If you are satisfied with the settings, click Finish. If you want to review or change any settings click Back.

    A progress window displays the status of the migration. You can stop the migration at any time by clicking Stop.

  11. At the end of the migration, click View Log to see the migration results. You can also see the log file by looking in the Logs folder


Have a problem or a question? Post it in the Jazz.net forum.