Guideline: Installing DOORS/DWA and Restoring Project Data
This guideline describes in detail the necessary steps to install DOORS and DOORS Web Access and restore the DOORS archive.
Relationships
Related Elements
Main Description

1. Install Rational DOORS Web Access and Rational DOORS

To enable Rational DOORS to integrate with RTC, you must install and configure Rational DOORS and DOORS Web Access, and configure the Rational DOORS database server.

Before you begin

You must have local administrator powers on your server.

Steps

Installing Rational DOORS and DOORS Web Access is almost completely automated; configuring is a manual procedure. You must update two configuration files - the festival.xml file and the doorsRedirector.properties file. You must also set up Rational DOORS Web Access to use SSL. Finally, as part of the configuration procedure, you also configure the Rational DOORS database server by running the dbadmin command with additional parameters.

Install and configure Rational DOORS and DOORS Web Access

To setup Rational DOORS Web Access and Rational DOORS, follow the instructions in the topics in these sections of the Rational DOORS information center:  

  • Installing the Rational DOORS client and the database server on Windows
    • For the client install use the following parameters:
      • Installation location: use the default location
      • Database port: use the default port (36677)
      • License Server: 270000@<evalserver> where <evalserver> is the name of the machine hosting the DOORS server
    • For the database server install use the following parameters:
      • Database port: use the default port (36677)
    • Test your installation
      • Once you have completed the client and database server installation there should be a shortcut on your desktop for DOORS
      • Start the DOORS client using the shortcut. You will receive a notice that the Administrator account is create and that you need to set the password
      • Click OK
      • Set a password of your choosing and click OK
      • The DOORS Welcome screen should appear if all went well and you will have an empty DOORS database.
  • Installing the web access server and web access broker on Windows
    • The installation file is " ..\DWA_v1.5\Installer\win32\ IBM_Rational_DOORS_Web_Access.exe"
  • Configuring the components for communication
    • Issue the following command from a commands line editor:
      • cd C:\Program Files\IBM\Rational\DOORS\9.4\bin
      • dbadmin -data 36677@<evalserver> -P <password> -dcnEnable -dcnBrokerUri "tcp://<evalserver>" -dcnChannelName "dcn" -dwaProtocol https -dwaHost <evalserver> -dwaPort 8443
      • Where
        • <evalserver> is the name of the machine hosting the DOORS database server
        • <password> is the DOORS Administrator password you chose earlier
    • Start the DOORS client and log in as Administrator
    • From the database explorer, select Tools->Edit DXL
    • Type the following DXL command print getDatabaseIdentifier() and Click Run
    • Record the database URN (the 16 character string returned), you will need this later
    • Update the file C:\Program Files\IBM\Rational\DOORS Web Access\1.5.0.0\server\festival\config\festival.xml as follows:
      • f:endpoints section
        • no change needed since the DWA broker and server are on the same host 
      • f:mappings section
        • Update the repositoryURN to match the value you recorded above and optionally change the name of the repository
        • Change the name attribute to "DOORS Medical Device Solution Repository"
      • f:properties section to match the dwaProtocol, dwaHost and dwaPort you used to configure the DOORS database above:
        • The license server port is 27000 by default - no change needed
        • Replace "MYHOSTNAME" with evalserver, i.e the name of your host server machine
        • Replace "http" with "https" and replace "8080" with "8443"
        • Set "ForceHttpsForAuthenticationForOAuth" to true
      • Save and close the festival.xml file
  • The Rational DOORS redirector service
    • Update the file C:\Program Files\IBM\Rational\DOORS Web Access\1.5.0.0\server\festival\config\doorsRedirector.properties as follows:
      • Replace "http://MY_DWA_HOSTNAME:8080/dwa" with "https://<evalserver>:8443/dwa" to match the dwaProtocol, dwaHost and dwaPort you used to configure the DOORS database above, where <evalserver> is the name of the machine hosting the DOORS database. 
      • Replace "doors://MY_DOORS_DATABASE_HOSTNAME:36677/" with "doors://<evalserver>:36677/" where <evalserver> is the name of the machine hosting the DOORS database  

Additional Notes on configuring DWA to use SSL

As described in the online instructions, The Rational® DOORS® Web Access server can be configured to use SSL. To enable Rational DOORS Web Access to use SSL, we configured the festival.xml file. We also need to update the server.xml file. The server.xml file is a Tomcat file which refers to a security ‘keystore’.

To support your evaluation, we have supplied an example sever.xml file. Simply extract the contents of server_xml.zip and copy the server.xml file into your <dwa_install>/server/conf/ directory. We suggest you rename the original server.xml file. We have also supplied a keystore directory, which contains a keystore_dwa.jks. Simply extract the contents of the cert.zip and copy the cert directory into your <dwa_install>/server/ directory. This new folder should contain a single file.

When you have completed all of the configuration tasks, you are ready to start Rational DOORS Web Access. 

Start Rational DOORS Web Access

  1. Start the DWA broker
    1. Run the batch file C:\Program Files\IBM\Rational\DOORS Web Access\1.5.0.0\ broker.start.bat.
    2. Note that this will launch a console window. DO NOT close this window, simply minimize it to the task bar.
    3. Tip: create a shortcut to this batch file on your desktop
  2. Ensure the DOORS database service is running (it is called DOORS DB Server 9.4)
  3. Start a command line interface and issue the following commands:
    1. cd C:\Program Files\IBM\Rational\DOORS\9.4\bin
    2. doors.exe -interop - data mailto:36677@evalserver> - brokerHost <evalserver> - brokerPort 61616
    3. Tip: copy the DOORS shortcut on your desktop and add the command line switches to the command
    4. This will start another console window. DO NOT close this window, simply minimize it to the taskbar
  4. Start the DOORS Web Access server
    1. Run the batch file C:\Program Files\IBM\Rational\DOORS Web Access\1.5.0.0\ server.start.bat.
    2. Note that this will launch a console window. DO NOT close this window, simply minimize it to the task bar.
    3. Tip: create a shortcut to this batch file on your desktop

Test your installation as follows:

  1. Launch Internet Explorer and navigate to: "https://evalserver:8443/dwa"
  2. Login as user: Administrator with the DOORS Administrator password you set earlier.

Rational DOORS and Rational DOORS Web Access are now ready for the next step.

Create DOORS users for the evaluation 

You will create three new users for the evaluation. For ease of use in this evaluation, we will allow each user to have high-level permissions. In a real production environment, users may have limited permissions as defined by your IT policies.

  • Administrator / <your pswd> (DOORS default admin)
  • rational / rational – database manager (New)
  • susan / susan1 – database manager (New)
  • pete / pete12 – database manager (New)

Follow these steps to create new users:

  1. Start DOORS and log in as Administrator using the password you set earlier
  2. Click Tools>Manage Users in the database explorer
  3. Select the Users tab and click New
  4. Enter the username and select Database Manager radio button on the General Tab
  5. Click OK
  6. Repeat steps 3 through 5 to create the other users
  7. Click OK to close the Manage Users dialog
  8. Exit DOORS

Prior to moving to the next step, log in as each new user. You will be forced to change the password on first access.

  1. Start DOORS
  2. In the Login dialog, enter the username, leave the password field empty and click OK
  3. You will see a dialog indicating that you must change the password
  4. Click OK
  5. Leave the Old password field empty
  6. Enter the password from the list above in both remaining fields
  7. Click OK
  8. DOORS will start
  9. Close the Welcome screen (you can disable the welcome screen by unchecking the "Show this screen at startup)
  10. You will see the DOORS database explorer with the Username and User Type listed in the information bar at the bottom of the window
  11. Exit DOORS

Repeat steps 1 through 11 for each of the remaining users.

2. Restore the Example DOORS Archive

To support your evaluation, we have supplied an example DOORS project that includes sample data for an Infusion Pump. This sample project is based on the structure of the template project provided (more on this later).

Follow these instructions to restorre the example project: 

  1. Click the following hyperlink to download the example project and save it to a suitable location on your server Infusion_Pump_Demo_Project_July16.zip 
  2. Extract the contents of the zip file to a suitable location on your server
  3. Open a DOORS client, log in as pete and restore the project:
    1. Select the Database node in the DOORS database explorer
    2. Click File > Restore > Project
    3. Click the Browse ... button and navigate to the *.dpa file you extracted in step 2 above, and click OK
    4. The Restore Project dialog will be presented
    5. Ensure all items are selected and click OK

Your DOORS DB Explorer will look similar to this upon completion:

We will use this project during the evaluation. Note that it already has content, including links, so many of the supplied views are more meaningful than in the empty template.

©  Copyright IBM Corp. 1987, 2010.  All Rights Reserved.