A test bed is a nonproduction are 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's tool to log users off the database, if the database
vendor provides such a tool.
- For Windows systems, 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 need to 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.