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:
- Rational TestManager
must be installed on the computer that is running the migration wizard.
- The user who runs the migration wizard must be a member of the IBM Rational Quality Manager project
areas to migrate the test artifacts to. This user must also have the
correct Client Access License. If you do not meet these requirements,
the project areas are not included in the project list in Step 8.
- You ran the Datastore Doctor tool, which is available with Rational TestManager, and resolved
any issues that are reported.
- If you plan to use the Rational ClearQuest® Bridge
and you want to migrate ClearQuest defect
links, you must provide the DBID of the default ClearQuest record type in the migration
wizard. For more information, see the instructions in Step 6.
Procedure
- 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.
- Copy the contents of the RTMMigration folder to the RTM_install_dir\Rational
Test folder.
- Browse to the RTM_install_dir\Rational
Test folder, and run RQMMigration.exe.
- 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.
- 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.
- 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:
- 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.
- 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.
- 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.
- Click Next, and select the Rational Quality Manager target
project area for artifact migration.
- Click Next to display the migration
summary page.
- 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.
- 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