When you upgrade to Rational® DOORS® version 9.5 from a version
earlier than 9, the previous version is retained on your system. Rational DOORS 9.5 does not overwrite your current version.
You must migrate data from previous versions of Rational DOORS so
that the data is compatible with the current version.
Before you begin
- Back up your current Rational DOORS data.
- You must be able to log in as a Rational DOORS administrator.
If you do not know the administrator password, contact your local
support department.
- If you are currently running Rational DOORS version 5, you must migrate
your data to version 6.0 Special Release 1 (SR1). To complete this
task, you must run the Module Migrator DXL. This DXL can be obtained
by contacting IBM Software Support. If you are migrating a large database
and each Rational DOORS client runs on a different
computer, you can run the Module Migrator DXL on multiple clients.
With that DXL, you can migrate different sections of the data at the
same time. When you are running the Module Migrator DXL, do not run
more than one Rational DOORS client on any one computer
at the same time.
About this task
On Windows systems only, when you install Rational DOORS 9.5,
these defaults apply:
- The Rational DOORS 9.5 client installs to a
new directory: C:\Program Files\IBM\Rational\DOORS\9.5.
Your previous version is not overwritten, and you can run your current
version and Rational DOORS 9.5 in parallel on the same
machine.
- After the installation, you can start the upgraded software by
clicking .
- The Rational DOORS database server service
is called DOORS DB Server
9.5.
- The Rational DOORS database server port number
is 36677, which was also the default port number for previous versions.
For your existing database server and a Rational DOORS 9.5
database server to run from your computer, the 9.5 database server
must run on a different port.
- The Rational DOORS 9.5 database server points
to an empty data directory in the Rational DOORS 9.5 directory. Do not change
this path; it provides more control over how and when you migrate
your existing data.
Procedure
- Install version 9.5. For information about installing
the client and database server, see:
After you install version 9.5, you can migrate
your data.
- Optional: If you are currently running version
5, you cannot migrate directly to version 9.5. You must migrate it
to the version 6.0 SR1 format and then migrate it directly to Rational DOORS 9.5. You migrate only the version 5 database
to version 6.0 SR1. You do not need to upgrade all of the clients.
Migrate your data as follows:
- Install a version 6.0 SR1 Complete Server Installation.
You must accept the default data directory.
- Copy your version 5 database to the default directory.
- Run version 6.0 SR1.
- Log in as an administrator.
- To migrate your data, click Confirm.
- Migrate your data from your current version. You
can migrate data directly to Rational DOORS 9.5 from all versions of Rational DOORS after version 6.0. There are four methods
you can use.
- Follow the procedure in Upgrading to Rational DOORS 9.5 from earlier releases of version 9.
This
option gives the maximum amount of control over when data is migrated.
The Rational DOORS database server and all the Rational DOORS clients
can be installed, pointing them all to the empty data directory. None
of the Rational DOORS 9.5 clients can access the
data and migrate it until it is ready for migration. When the data
is ready for migration, copy it to the empty directory. Log in to
a Rational DOORS client as the Administrator user, and
the data is migrated to Rational DOORS 9.5.
- When you install Rational DOORS 9.5, point the Rational DOORS 9.5
database server at the Rational DOORS data directory. Then, run
a Rational DOORS client as the administrator user.
Make
sure that a copy of the Rational DOORS data directory exists and
that the data is ready to migrate.
Any Rational DOORS client
that is using the Rational DOORS 9.5 database server and
has access to the administrator password can migrate the data.
- Archive the projects that are to be migrated, and then restore
them to Rational DOORS 9.5.
Use this option only
for the initial testing of Rational DOORS 9.5. Using archive and restore
to migrate data takes a long time and results in the loss of access
controls and cross-project links.
- Make a copy of the current Rational DOORS data directory. Access the
copied data directory from a version 7 or 8 client, and delete the
projects and folders that are not to be migrated to version 9.5.
You can also migrate your data in phases. Rational DOORS 9.5
overwrites only other version 9 installations. If you are running
a version that is earlier than version 9.0, you can install the Rational DOORS database server and all the Rational DOORS clients
alongside the versions that you are currently using.
You can
choose when to migrate your data. If you want some users to use the
new Rational DOORS version while other users continue to
use the old one, make sure that the Rational DOORS 9.5 database server is using
a different port than your existing database server.