IBM Support

Quick Guide to setting up and launching IBM Rational DOORS Web Access (DWA) on Windows

Technote (FAQ)


What are some quick steps to installing, setting up, and launching IBM Rational Doors Web Access (DWA) on Windows?


For detailed instructions and any special configurations, visit the DOORS Information Center:

  1. Review the Readme file, that comes with your install of Doors Web Access, and verify that the system and DOORS Interoperation Server are compatible with DWA.
  2. Install the Rational DOORS database server. If you have already installed a database server, you need the port number and the name of the server machine for use later in the procedure.
  3. Install the Interoperation server, which is a DOORS client. If you have a DOORS client installed, you do not need to install the interoperation server.
  4. Install the Rational® DOORS® Web Access (DWA)
  5. Identify the database Universal Resource Name
    1. If the Rational DOORS database server is not already running, then start it.
    2. Start the Rational DOORS client and log in to the database.
    3. In either the Rational DOORS database explorer or a module window, click Tools > Edit DXL.
    4. Type the following DXL script into the DXL input pane:
      print getDatabaseIdentifier()
    5. Click Run to run the program. A 16 digit hexadecimal number is output, for example
      This forms part of the database URN. In this example, the database URN is:
    6. Make a note for later use.
    • Note: You can also retrieve the database Universal Resource Name by going to the Database Properties and looking at the end of the URL. The id will be between the "1- and "-A". For example, if you see "1-4d52f8f42a405d3f-A" at the end of the URL. The database Universal Resource Name would be 4d52f8f42a405d3f.
  6. Modify the festival.xml file
    1. Go to the following Directory:
      C:\Program Files\IBM\Rational\DOORS Web Access\\server\festival\config\festival.xml
    2. Open the festival.xml file in a text editor
    3. The default port for the broker will remain 61616. If you change the broker port, update "f:broker" with the proper port number
    4. Modify the "f:repository-mapping" section and add the database Universal Resource Name.
      Below is an example
      <f:repository-mapping enabled="true" endpoint="RMSERVICES" name="DOORS ERS Repository"         repositoryUrn="urn:telelogic:ers-4d52f8f42a405d3f:"/>
    5. Modify the "f:properties" and add the license server and port. The default license port is 19353. Example:
      <f:property name="licence.server.location" value=" 19353@localhost"/>
    • Note: You can verify the License port number by launching LMTOOLS, select Configure Services Tab, and select "View Log". The port will be listed after "lmgrd tcp-port". 19353 is the default port number.
  7. Set up the Rational DOORS database server to communicate with the broker
      1. Log into the database server
      2. Open a command prompt
      3. Change Directory to C:\Program Files\IBM\Rational\DOORS\9.3\bin
      4. Run dbadmin, in a command line in the following format:
        dbadmin -data port@myserver -P server_password -dcnEnable -dcnBrokerUri “tcp://myBroker:61616” -dcnChannelName “dcn”
        Parameter Description
        data 36677@myserver Identifies the Rational DOORS database server, where 36677 is the default port number the database server is using and myserver is the name of the machine where the database server is installed.
        tcp://myBroker:61616 Locates the interface services broker, where myBroker is the machine hosting the broker and 61616 is the default port that the broker uses.
      5. Example:
        dbadmin -data 36677@localhost -dcnEnable -dcnBrokerUri "tcp://localhost:61616" -dcnChannelName "dcn"
      6. Restart the Rational DOORS database server for the new settings to take effect.
      • Note: DO NOT copy and paste the text into the command prompt and modify the command. You must type in the command. This line will not be accepted if there are special characters copied into the command prompt including smart quotes and hyphens.
  8. Start the Rational DOORS Web Access broker and
    1. Start the broker by running broker.start.bat. This file is in the directory where you installed the broker. (For Example C:\Program Files\IBM\Rational\DOORS Web Access\
    2. Start the Rational® DOORS® database server as a service on the machine hosting the database.C:\Program Files\IBM\Rational\DOORS\9.3\bin to start interrop Server
  9. Run the interoperation server on the machine hosting DWA
    1. Open a command prompt
    2. CD to C:\Program Files\IBM\Rational\DOORS\9.3\bin to start interrop Server
    3. Run the command-line attributes in the following format:
      doors.exe –interop –data port@myserver –brokerHost myBroker –brokerPort brokerport 
    4. where
    • port is the port number the Rational DOORS database server is using and
    • myserver is the name of the machine where the Rational DOORS database server is installed
    • myBroker is the name of the machine hosting the broker
    • brokerport is the port that the broker is using, by default 61616
      doors.exe -interop -data 36677@localhost -brokerHost localhost -brokerPort 61616
  10. Start Rational® DOORS® Web Access Server
    Start the Rational DOORS Web Access server by running server.start.bat. The file is in the directory where you installed the server (for example C:\Program Files\IBM\Rational\DOORS Web Access\ When you start the system for the first time, you may need to wait while the system unpacks files.
    • Note: If the DOORS client launches, there are special characters in the command to start the interoperation server. After doing the above, the DOS window for the broker, database server, and web server will remain open. Do not close them. Also doorsd.exe, two java.exe will be found in your Task Manager under Processes
  11. Access the Web client
    1. In your browser, enter the URL that points to the Rational DOORS Web Access Server.
      For example, http://servername:8080/dwa. The Web client opens and the Welcome screen is displayed.
    2. Enter your User name and Password, and then click Login. You are connected to the Rational DOORS database.
    3. When you are finished, click Logout. The Welcome screen is displayed.

Related Technotes:
Starting/Shutting IBM Rational DOORS Web Access on Microsoft Windows

Cross reference information
Segment Product Component Platform Version Edition
Rational DOORS

Document information

More support for: Rational DOORS

Software version: 1.1, 1.2, 1.3, 1.4

Operating system(s): Windows

Reference #: 1472587

Modified date: 02 May 2012