IBM Support

How to set up an Rational DOORS server to integrate with Rational Requirements Composer 2.0

Question & Answer


Question

What should I do to set up an IBM Rational DOORS server in order to integrate with IBM Rational Requirements Composer 2.0?

Answer

The following summarizes the steps you need to take for the set-up. All the detailed information is contained in the IBM Rational DOORS installation guide Chapter 8: Installing the Rational DOORS server interface services on Windows.

Step 1: Install the Rational DOORS interface services components

In this step, you need to:

  • Install the Rational DOORS database server
  • Install the Interoperation Server
  • Install the interface services server and the interface services broker

->See detail instructions in Rational DOORS installation guide P44-46

Step 2: Setting up the Rational DOORS interface services components

In this step, you need to:

  • Identify the database Universal Resource Name
  • Set up the interface services server
  • Modify festival.xml

->See detail instructions in Rational DOORS installation guide P46-49

Step 3: Configuring the redirector service

In this step, you need to modify doorsRedirector.properties to configure the Rational DOORS redirector service, the interface services server and the DOORS database server.

->See detail instructions in Rational DOORS installation guide P54-55

Step 4: Setting up the Rational DOORS database server

In this step, you need to set up the Rational DOORS database server to communicate with the interface services broker.

->See detail instructions in Rational DOORS installation guide P49-50

Step 5: Start the broker server

Open a new command front and go to the directory where you extracted festival-win32.zip on the machine hosting the interface services broker. Execute following command to start broker service:


    %broker.start.bat

*You need to leave that command front open while the integration service is on.

Step 6: Check if the Data Change Notification (DCN) service is on

Open a new command front and move to the directory of <Rational DOORS installation directory>\bin, and execute the follow command to check if the Data Change Notification (DCN) service is on.


    %dbadmin -data <Rational DOORS server's port>@<DOORS server's hostname> -dcnInfo

    Expected result:

    -I- DBADMIN: Data Change Notifications are currently enabled (Broker URI = 'tcp://<broker server's hostname>:<broker server's port>', Channel Name = 'dcn')


If the result turns out to be:


    -I- DBADMIN: Data Change Notifications are currently enabled but not sending <Broker URI= 'tcp://<broker server's hostname>:<broker server's port>', Channel Name = 'dcn'>.

Then you need to execute follow commands to refresh the current status:
    %dbadmin -data <Rational DOORS server's port>@<DOORS server's hostname> -dcnInit
    %dbadmin -data <Rational DOORS server's port>@<DOORS server's hostname> -dcnEnable
    %dbadmin -data <Rational DOORS server's port>@<DOORS server's hostname> -dcnInfo

If you still can not get the expected result, then please contact support.


Step 7: Start the interopration server

Move to <Rational DOORS installation directory>\bin, and execute the follow command to start interopration server:

    %doors.exe –interop –data <Rational DOORS server's port>@<DOORS server's hostname> –brokerHost <broker server's hostname> –brokerPort <broker server's port>

Step8: Start the interface services

Open a new command front and move to the directory where you extracted festival-win32.zip on the machine hosting the interface services broker. Execute the following command to start interface services:


    %server.start.bat

*You need to leave that command front open while the integration service is on.

Once you have completed the above steps, you have finished the set-up of the Rational DOORS server.

[{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"9.2.0.2;9.2.0.3","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSWMEQ","label":"Rational Requirements Composer"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Integrations: IBM","Platform":[{"code":"PF033","label":"Windows"}],"Version":"1.0.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
01 May 2020

UID

swg21432076