The DOORS redirector service

If you want IBM® Engineering Requirements Management DOORS® - Web Access (DWA) users to be able to use IBM Engineering Requirements Management DOORS (DOORS) URLs in the same way as DOORS users, configure the redirector service and the DOORS database server. Users can then specify whether to open DOORS URLs in a standard client or in the web client. The redirector service automatically opens the URL in the chosen client.
Important: Any change to the DWA URL, including the port number, might require a rebuild of Lifecycle Query Engine (LQE) indexes in integrated applications, such as IBM Engineering Lifecycle Optimization - Engineering Insights (ENI). For more information, see the help "Completing the server rename for Lifecycle Query Engine" in the documentation for ENI.

The DOORS database, and each project, folder, module, baseline, and object in the database has a unique identifier, which is expressed as a URL. By default, the URL begins with doors://, but you can change it to either http or https. To configure the redirector URL format, run the dbadmin command with the following parameters:

Table 1. Redirector parameters
Parameter Description
-data port@databasehostname Identifies the DOORS database server, where port is the number of the port that the database server is using and databasehostname is the name of the machine where the database server is installed.
-dwaProtocol https or http The default is http.

Specifies the protocol that the server is using to communicate with DWA.

If the communication is secure, the protocol is https. If the communication is not secure, the protocol is http.

–dwaPort 8080 or 8443 The default is 8080.

Specifies the port that the server is using to communicate with DWA.

If the communication is secure, the default port is 8443. If the communication is not secure, the default port is 8080.

-dwaHost hostname Specifies the name of the computer that the DWA server is running on.
If dbadmin is not in your PATH variable, navigate to the directory where the dbadmin command is located. The complete command has the following format:
dbadmin -d "port@databasehostname" -dwaProtocol "(https or http)" -dwaHost "hostname" -dwaPort "(8080 or 8443)" 
Here is an example:
dbadmin.exe -d "36677@dbserver.example.com" -dwaProtocol "http" -dwaHost "dbserver.example.com" -dwaPort "8080" 

The redirector URLs can then be inserted into a web page, stored as favorites or bookmarks in your browser, included in emails, or pasted into other applications.

The redirector service is an optional service and is installed with the DWA. It shares a web server and port with DWA, but is configured separately from DWA. If the redirector service is not configured, DOORS URLs are opened in a standard client.


Feedback