About this task
A test bed is a nonproduction area where you can test
your changes. Upgrade the test bed before you upgrade your production
databases.
If you plan to perform an in-place upgrade, that
is specifying the same database as the source and target, you should
test it first using the test bed. You can skip Step 2 in the following
instructions with an in-place upgrade.
If you are performing
a standard upgrade, not an in-place upgrade, the procedure for upgrading
the test databases is almost identical to upgrading production databases.
To
create a test bed based on your production databases:
- Back up your Rational® ClearQuest® schema
repository and user databases.
- Create new, empty vendor databases for each schema repository
and user database, as described in Vendor database configuration.
Create the new databases in a new test directory or on a test server.
These new databases are referred to as the test bed in the
rest of this section.
Create empty databases only. Do not use
the vendor database tools to move or copy the data. Rational ClearQuest updates
the data structure and moves it into the new databases as part of
the upgrade process.
Do not perform this step if you are performing
an in-place upgrade or using Microsoft Access.
- If you use Rational ClearQuest Web,
shut down your Web server, stop any scheduled Rational ClearQuest MultiSite synchronization
jobs, and disconnect all users from Rational ClearQuest by
using one of these techniques:
- Use the administrator tool to log users off the database, if the
database vendor provides such a tool.
- For Windows, check the
Task Manager Process List of each client and server computer. If any
of the following processes is running, use the Task Manager to end
it:
- clearquest.exe
- cqdesign.exe
- cqintsvr*.exe
- Copy your existing production schema repository and user databases
to the test bed databases. Use the Rational ClearQuest installutil utility
with the options convertschemarepo and convertuserdb.
For more information, see the "Reference pages" in the Rational ClearQuest Online
Help.
The convert options with installutil cause Rational ClearQuest to
lock the original production databases. If you must unlock them, see
the information about installutil unlockschemarepo and installutil
unlockuserdb commands in the "Reference pages" topics of the Rational ClearQuest Online
Help.
- For each database in the test bed, create another new, empty vendor
database. These databases, which are referred to as the test upgrade
set in the rest of this section, are the databases that you upgrade
to.