The festival.xml file is the core
configuration file in Rational® DOORS® Web Access. Modify the entries
for f:broker, f:repository-mapping and f:properties to
match your broker, repository, and license server setup.
Procedure
- The festival.xml file has three f:broker entries
that describe where the broker is. Edit these entries to point to
the URL of the system where you installed the broker with the default
port (61616). If the broker is on the same system as the Rational DOORS Web Access server, you do not need to
edit these entries.
<!-- Brokers we know about -->
<f:endpoints>
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
</f:endpoints>
- The f:repository-mapping entry defines
the URN of the repository.
- The name attribute is the name that
is displayed on the Rational DOORS Web Access logon page. You
can change this attribute. The default is DOORS ERS Repository.
- The repositoryUrn attribute must match
the uniform resource name (URN) of the Rational DOORS database
server you identified in Identifying the database uniform resource name.
You must change this attribute.
<!-- Mapping from Repository IDs to the broker we use to reach the repository -->
<f:mappings>
<f:repository-mapping
.
.
name="DOORS ERS Repository"
repositoryUrn="urn:rational:ers-46dd5d7806b96973:" />
</f:mappings>
- You must change the f:properties section
of the file.
- Required: Enter the location of the license
server. Update the value in this line:
<f:properties>
<f:property name="licence.server.location" value="19353@localhost"/>
This location is added to the list
of license locations held on your system.
- Optional: You can set up Rational DOORS Web
Access to display the URL of the current module in the interface.
To display the URLs, change value="false" to value="true" in
this line:
<f:property name="display.redirector.urls" value="false"/>
- Optional: If the Rational DOORS database
uses corporate LDAP for user authentication, you must add a line to
remove the Change Password option from the
Welcome screen. Add this line:
<f:property name="change.password.enabled" value="false"/>
- Required: Change the two URL values to the
values you entered in the dbadmin command in Configuring the Rational DOORS database server. Change http://MYHOSTNAME.8080/ to
the values you entered for -dwaProtocol, -dwaHost,
and –dwaPort, for example if you entered -dwaProtocol
http, -dwaHost dwa_server, and –dwaPort
8080, change the lines to:
<f:property name="published.url.prefix" value="http://dwa_server:8080/doors/redirector/"/>
<f:property name="oauth.domain" value="http://dwa_server:8080/dwa" />
- Required: Set ForceHttpsForAuthenticationForOAuth to false:
<f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
Note: If Tomcat is configured to use SSL, set ForceHttpsForAuthenticationForOAuth to true.
- Save and close the file.