Installing the DOORS® Client


Introduction

This procedure describes how to unpack and install the IBM Rational® DOORS® Client application on a Windows 7 Client system.

The installation follows this flow:

  1. Locate and unpack the compressed ZIP installer image for your Windows client.
  2. Execute the Window Install Shield Installer file
  3. Accept the End User License Agreement (EULA)
  4. Select The destination folder for the DOORS® client
  5. Choose the installation type (usually the Typical type)
  6. Configure connection to a DOORS® Database Servers
  7. Configure access to User license information.
  8. Complete Software Installation
  9. Review Shortcuts to launch the DOORS® Client

You can inspect the procedure for DOORS® Server Installation which is a related activity.


Preparing to Install the DOORS® Client

Locate the appropriate compressed ZIP installer image in your file system.

In the following figure, a number of these compressed files has been downloaded from the IBM support site. The ratlDOORS_Client_9-5-0-1_Windows.zip file has been selected.

 

Locate DOORS Client ZIP File
Picture showing Locate DOORS Client ZIP File

As shown below, the unpackaging procedure yielded the setup.exe file which is suitable for installations on Windows client systems.

 

Extract Setup.exe File
Picture showing Extract Setup.exe File

Note: Many of the other ZIP files that are part of the DOORS® distribution use the exact same setup.exe file name for their installers. You should rename the file meaningfully.

A suggested name of DOORS-client-9-5-0-1-windows-setup.exe not only conveys the purpose of the file, but using the minus sign instead of underscores and dots even eases typing (fewer shift keys).

 

Rename Exe To Meaningful Name
Picture showing Rename Exe To Meaningful Name


Executing the DOORS® Installation File

Select the installer as shown in the following figure from the system on which you wish to install the DOORS® Client software.

 

Locate DOORS Client Installer
Picture showing Locate DOORS Client Installer

Double-clicking the installer image (or using right-mouse open, or run, etc) will execute the program. The windows installer-type program will prepare as shown here.

 

Launch Windows Installer For DOORS Client
Picture showing Launch Windows Installer For DOORS Client

The Welcome Page for the installer is presented when the utility is ready to run as seen in the following figure.

 

DOORS Installer Welcome Page
Picture showing DOORS Installer Welcome Page

Press the Next button to proceed to the End User License Agreement (EULA) page as seen in the next figure.

Be default no selection as to acceptance of the EULA is made in the page.

Note: The Next button will not become active until you have selected the I Accept radio button.

 

DOORS License Agreement Page
Picture showing DOORS License Agreement Page

As highlighted, the I Accept ratio button has been selected and you are ready to proceed.

 

Move Past License
Picture showing Move Past License

The DOORS® client can be installed in most any location on your computer. This page offers an opportunity for you to change the default destination which, as shown is

C:\Program Files\IBM\Rational\DOORS\9.5\

 

DOORS Destination Folder Page
Picture showing DOORS Destination Folder Page

As shown below, the Change button will be activated in order to select the appropriate destination file for this computer.

 

Press Change To Alter Destination
Picture showing Press Change To Alter Destination

In the Change Current Destination Folder dialog shown below, you could use either the Browse button to select a directory, or use the Create button to create a new location.

Alternatively, if you know the exact path you desire, you can type the information into the Folder Name text area at the bottom of the dialog.

As shown here, the D:\Program Files\IBM\Rational\DOORS\ folder has been selected as the desired alternative location.

 

Changed Destination As Desired
Picture showing Changed Destination As Desired

Press the OK button to complete the changes and select the desired folder.

 

Destination Folder Changed
Picture showing Destination Folder Changed

The installer is now ready to proceed. Press the Next button to move on.

You have a choice of installation types as seen in the following figure. Selecting the Typical installation method is generally best unless you have specific information or are expert enough to select components using the Custom choice,

 

Installation Type
Picture showing Installation Type

You may connect a DOORS® client to one or more DOORS® Database Servers. Usually, you have a primary server to which you connect most of the time. The DOORS® Database Settings window as seen here wants to collect the

Port (with default value of 36677)

and

Database host name where the server is installed.

You should be aware of how to specify the name of your DOORS® DB server. In some installations a fully-qualified domain name (FQDN) is needed. In other installations, a simple host name will suffice.

 

DOORS DBSETTINGS Page
Picture showing DOORS DBSETTINGS Page

As seen here, the default port number has been selected and a simple host name entered for the DOORS® DB server.

Press the Next key to proceed.

 

Define DOORS DB
Picture showing Define DOORS DB

The next dialog will assist in configuring the DOORS® client to access your user license information.

You may use a license file, access an IBM Rational License Key Server or make no selection.

 

License Key Info Initial Page
Picture showing License Key Info Initial Page

In this example, an IBM Rational License Key Server has been identified by port number and hostname.

Press the Next key to proceed to the final steps.

 

Identify RLKS
Picture showing Identify RLKS

The next dialog provides a summary of your selections and shows that the DOORS® Client installation is ready to proceed.

Note: That this dialog includes a check-box which will cause the installation to create a desktop shortcut if checked. People typically find this a convenient option to choose.

 

Ready To Install DOORS Client
Picture showing Ready To Install DOORS Client

As seen here, on Windows 7 Clients whenever a software installation is attempted, the OS will ask if this operation should be permitted.

You must have sufficient rights to perform such an activity. This installation will add values to your Windows Registry and also make a few minor additions to OS folders as necessary.

Press the Yes button on the dialog to permit the installation to proceed.

 

Permit Installation
Picture showing Permit Installation

Progress of the installation will be displayed as shown in the following figure. The progress bar will fill in as more work is accomplished.

 

Progress Messages Displayed
Picture showing Progress Messages Displayed

When complete, the InstallShield Wizard Completed will display success in this case, or whether there were problems with the installation.

Press the Finish button to complete the installation and dismiss the wizard.

 

Finished Installing DOORS Client
Picture showing Finished Installing DOORS Client

 

DOORS Shortcuts On Desktop And Start
Picture showing DOORS Shortcuts On Desktop And Start

You installation is complete. If you have a DOORS® Database Server available and have a user ID configured on that server, you may proceed to launch the DOORS® client to verify access to a user license via the Rational License Key Server (RLKS) and access the to DOORS® DB Server.

You can inspect the procedure for DOORS® Database Server Installation which is a related activity.