IBM Support

Multiple DWA server installation on one machine

Technote (FAQ)


Question

Is it possible to set up more than one IBM Rational DOORS Web Access (DWA) server on a machine?

Cause

You have multiple DOORS databases and you need to configure a DWA server for each database instance.

Answer

Yes - providing that you are not attempting to configure them all as TRS providers.

You must install and configure a separate DWA instance for each DOORS Database you want to connect to.

The DWA servers must be installed to a different directory and use different port numbers, etc.
You can not have separate "DWA" instances connected to different DOORS Databases all running from a single set of installed binaries.

If the separate DWA instances share the same version then they can use a single DOORS Interop Server install, providing that the short-cuts / batch files for starting those Interops are configured correctly.

Multiple DWA installs on one machine

Example of all applications on the same machine. You will need:

  • N installs of DWA into fresh directories, where N the number of database servers you want to service

Example:
Two DOORS database servers on machine A with a DWA instance serving each

Procedure:
  1. Install DOORS client and server on machine A
  2. Create multiple DOORS services for different DOORS databases (36677, 36678)
  3. Install DWA twice into directories c:\dwa1 and c:\dwa2
  4. Use two different secure (or non-secure) DWA ports, 8443 and 9443
  5. Use two different broker ports 61616 and 61617

Configure DWA instances
Ensure there are no port clashes and that all ports used by instance 1 and instance 2 are unique.
The initial set of ports are likely to be unused but ensure that the ports used on instance 2 are unused ( netstat -a | findstr 80).
Recommend that instance 1 uses the defaults and subsequent instances change the ports needed. The files below are those which need editing, including the default text requiring changed for the second instance.

Broker files:


$BROKER\broker_start.bat


BROKER_ADMIN_PORT=1099

$BROKER\broker_shutdown.bat


BROKER_ADMIN_PORT=1099

$BROKER\conf\activemq.xml


transportConnectore port: " tcp://0.0.0.0:61616"

Tomcat files:


$TOMCAT\conf\server.xml


server port="8005" SHUTDOWN="SHUTDOWN"
non-SSL connector port (8080)
SSL Connector (8443)
AJP Connector 8009 (and redirect port)

$DWA\conf\festival\festival.xml


all Broker port refs (there will be multiple references)
repository ID
published.url.prefix (port number)
oauth.domain (port number)

$DWA\conf\festival\doorsRedirector.properties


doors.url.prefix

Configure DOORS data

Run the dbadmin command to set up the data for both DWA instances:

dbadmin -data port@DOORSserver -dcnEnable -dcnBrokerUri tcp://machineA:61616 -dcnChannelName “dcn” –dwaProtocol https -dwaHost machineA –dwaPort 8443

dbadmin -data port@DOORSserver -dcnEnable -dcnBrokerUri
 “tcp://machineA:61617-dcnChannelName “dcn” –dwaProtocol https -dwaHost machineA –dwaPort 9443

Interop Startup

Start interop servers referencing correct brokers:

doors.exe –interop –data 36677@machineA –brokerHost machineA –brokerPort 61616
doors.exe –interop –data 36678@machineA –brokerHost machineA –brokerPort 61617



Gotchas:


Cross reference information
Segment Product Component Platform Version Edition
Rational DOORS

Document information

More support for: Rational DOORS
General Information

Software version: 1.1, 1.2, 1.3, 1.3.0.1, 1.3.0.2, 1.4, 1.4.0.1, 1.4.0.2, 1.4.0.3, 1.4.0.4, 1.4.0.5, 1.5, 1.5.0.1

Operating system(s): Linux, Solaris, Windows

Reference #: 1592875

Modified date: 11 December 2012