You can configure IBM® Rational® DOORS® as a provider for Tracked Resource Sets
(TRS) by editing configuration files and running Derby batch files.
About this task
Rational DOORS and Derby are shipped with
several default users and passwords for the TRS enablement. You must
edit configuration parameters associated with these users, as described
in the procedure below. The integration uses the following users:
- LQE Functional User. This user handles LQE requests from
an integrated TRS consumer application to Rational DOORS Web
Access. This user must exist in the Rational DOORS database. You must
specify parameters for this user in the festival.xml file.
- trs.db.user. This is a Derby database user who has access
to the TRS database data. It is used by Rational DOORS Web
Access to retrieve data from the database. You must specify a password
for this user in the festival.xml file and the
Derby properties file.
- derby.user.admin. This is a Derby database administrator.
Currently, this user does not provide functions for Rational DOORS Web
Access or the Derby database. You can set a password for this user
in the Derby properties file.
Procedure
- Open the Rational DOORS Web Access festival.xml file
in an editor. This file is located in the dwa_install\server\festival\config directory.
- Enter property values for the LQE Functional User and TRS
user, as described in the following table. See the example of these
properties at the end of this topic.
Table 1. Festival.xml
file properties for TRS and LQEProperty |
Description/Value |
ForceHttpsForAuthenticationForOAuth |
Set this value to true. |
oauth.domain |
Set this value to https://server:port/dwa,
where server is a server domain
name or IP address. |
functional.user.consumer.key |
The consumer key that is associated with the
LQE Functional User. It is used by the Lifecycle Query Engine to access
the DOORS Tracked Resource Set (TRS). This key must be on the Rational DOORS configuration Local Keys tab.
The default value is LQE Functional User Key. |
functional.user.consumer.secret |
The consumer secret that is associated with
the LQE Functional User. It is used by the Lifecycle Query Engine
to access the DOORS Tracked Resource Set (TRS). This secret must be
on the Rational DOORS configuration Local
Keys tab. The default value is qwert6. |
functional.user.name |
The user name for the LQE Functional User. This
user name must be a valid Rational DOORS user. The default value
is LQE Functional User. |
functional.user.password |
The password for LQE Functional User. The default
value is qwert6. |
trs.db.user |
A user name for the TRS enablement. For simplicity,
use the default user name trs.db.user. |
trs.db.password |
The password for the trs.db.user.
You must also specify this password in the Derby properties file. |
trs.page.size |
The number of TRS resources to include on a
page. The default value is 250. |
trs.enable |
Set this value to true. |
- Open the derby.properties file in
an editor. This file is located in the dwa_install/derby directory.
- Replace the password values for the parameters in the following
table.
Table 2. Derby properties file parameters
for TRSParameter |
Description |
derby.user.trs |
The password for the trs.db.user that
you specified in the festival.xml file. The default
value is dwaTrsPa11word. |
derby.user.admin |
The password for the Derby database administrator.
Currently, this user does not provide functions for Rational DOORS Web
Access or the Derby database. The default value is dwaTrsPa11word. |
- Run the following batch file: dwa_install/derby.start.bat.
- Run the following batch file: dwa_install/derby/scripts/init_trs.bat.
- Enable the Data Change Notifications (DCN) parameters to
configure the Rational DOORS database server to communicate
with the Rational DOORS Web Access broker and the Rational DOORS Web Access server.
- Log on to Rational DOORS by using these credentials:
- User name: LQE Functional User or the
functional user name that you specified in the festival.xml file.
- Password: qwert6 or the functional
user password that you specified in the festival.xml file.
- Open the database properties and note that the Rational DOORS configuration Local Keys tab
contains the consumer key and secret that you specified in the festival.xml file.
- Register Rational DOORS Web Access on the Jazz
Registered Applications page by using the following Rational DOORS Web Access URL: install_path/dwa/public/scr.
Example
The following extract from the
festival.xml file
shows an example of the properties that are related to TRS:
<f:property name="ForceHttpsForAuthenticationForOAuth" value="true"/>
<f:property name="oauth.domain" value="https://[server]:[port]/dwa"/>
<f:property name="functional.user.consumer.key" value="LQE Functional User Key"/>
<f:property name="functional.user.consumer.secret" value=qwert6"/>
<f:property name="functional.user.name" value="LQE Functional User"/>
<f:property name="functional.user.password" value="qwert6"/>
<f:property name="trs.enable" value="true"/>
What to do next
The Lifecycle Query Engine (LQE), which is used by a TRS
consumer application, such as Rational Engineering Lifecycle Management
(RELM), builds a master index (database) of data from multiple lifecycle
tools. Each TRS provider tool publishes its data through a Tracked
Resource Set. LQE can collect or 'index' the data from each tool.
Teams can write queries (reports) for indexed data in the SPARQL language.
When you add a data source for Rational DOORS in the LQE Administration
application, be sure to set the following values:
- Number of Threads for initial indexing: 1
- Number of Threads for incremental indexing: 1
- Refresh Rate: 60
Set the following HTTP timeout values on the
Administration tab
>
Configuration >
Advanced Properties.
The default is 60 seconds. BOTH should be increased to 10 minutes,
600 seconds.
- Connection Timeout (minimum): 10 minutes (600 seconds)
- Socket Timeout (minimum): 10 minutes (600 seconds)