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 if a license server has not been configured
by other means, such as the Windows registry: 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 that are 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: Set ForceHttpsForAuthenticationForOAuth to false:
<f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
Note: If Tomcat is configured to use SSL, set ForceHttpsForAuthenticationForOAuth to true.
- Optional: To protect against cross-site
request forgery (CSRF) security attacks, set disable.csrf.token to false.
Add this line:
<f:property name="disable.csrf.token" value="false"/>
- Optional: To improve performance when only
IBM Rational DOORS client licenses are used, set use.doors.client.license.only to true.
In this case, the application does not check for IBM Rational DOORS
Web Access Reviewer and Editor licenses. The default value for this
setting is false, which causes the application to
check for all license types. Add this line:
<f:property name="use.doors.client.license.only" value="true"/>
- Save and close the file.