When you upgrade to a new release of Rational®
DOORS® from a version earlier than 9.0, the previous version
is retained on your system. Rational
DOORS does not overwrite the previous version. You can
migrate or restore data from the previous version so that the data is available in the new
version.
Before you begin
- Before you migrate data, check the integrity of your existing data.
- Be sure that all users log out of the database and then shut down the database server.
- Back up your Rational
DOORS data. If you customized the menus in the existing
installation, backup the addins.idx file and any custom scripts that you
created.
- You must be able to log in as the Rational
DOORS Administrator to migrate the data.
About this task
This procedure provides information for upgrading from Rational
DOORS version 6.0 SR1 or later. If you are using an earlier
release, see upgrade documentation from previous releases.
On Windows systems, when you install Rational
DOORS 9.0 or later, these defaults apply:
- Rational
DOORS installs to a new directory: C:\Program
Files\IBM\Rational\DOORS\9.version. Your previous client and database
server are not overwritten; however, if you are upgrading Rational DOORSclient,
you must uninstall your old client before you install the new client.
- The Rational
DOORS database server port number is 36677. For your
existing database server and a new version of the database server to run on the same computer, the
new database server must run on a different port.
- Other team members cannot use the upgraded version of Rational
DOORS until migration is completed.
There are two methods for upgrading data to your new installation:
- When you install the database server, point to existing data. If you want to preserve the
existing Rational
DOORS installation so that the data is available to existing
clients, copy the data directory from the existing installation and point to the copy for the
migration. If you do not want to migrate all the existing data, you can point to a copy of the data
directory that contains only the items that you want to migrate. Then, use an upgraded client to
migrate the data.
- Restore data in the new installation from a project or module archive from a previous release.
For more information, including the limitations of data archives, see Data backups and archives.
Procedure
- If you are upgrading the client, uninstall the previous client by using Windows Control Panel
Programs and Features.
- Install a new version of release 9. For information about installing the client and database server, see:
- If you customized the menus in the previous installation, stop the database server, copy the
addins.idx file and any custom scripts and folders from your backup files and
add them to the new installation. Then, restart the database server.
- To migrate your data, do one of the following steps:
- If you pointed to an existing data directory when you installed the database server, log in
to the upgraded client as Administrator and accept the option to migrate the data to the new
installation.
- If you have archives from a previous release, restore the data in the new
installation.