festival.xml 文件是 Rational® DOORS® Web Access 中的核心配置文件。修改 f:broker、repository-mapping 和 f:properties 的条目以与代理程序、存储库和许可证服务器安装匹配。
过程
- festival.xml 文件有三个描述了代理程序所在位置的 f:broker 条目。请将这些条目编辑为指向您使用缺省端口 (61616) 安装代理程序所在的系统的 URL。 如果代理程序位于与 Rational DOORS Web
Access 服务器相同的系统上,那么无需编辑这些条目。
<!-- 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>
- f:repository-mapping 条目定义了存储库的 URN。
- name 属性是显示在 Rational DOORS Web Access 登录页面上的名称。您可以更改此属性。缺省值为 DOORS ERS 存储库。
- repositoryUrn 属性必须与您在标识数据库统一资源名中确定的 Rational DOORS 数据库服务器统一资源名 (URN) 匹配。您必须更改此属性。
<!-- 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>
- 您必须更改文件的 f:properties 部分。
- 必需: 输入许可证服务器的位置。更新以下行中的值:
<f:properties>
<f:property name="licence.server.location" value="19353@localhost" />
此位置会添加到系统上所保存的许可证位置列表中。
- 可选: 您可以设置 Rational DOORS Web Access 以在界面中显示当前模块的 URL。要显示 URL,请将以下行中的 value="false" 更改为 value="true":
<f:property name="display.redirector.urls" value="false"/>
- 可选: 如果 Rational DOORS 数据库使用企业 LDAP 进行用户认证,那么必须添加一行以从“欢迎”屏幕中除去更改密码选项。添加以下行:
<f:property name="change.password.enabled" value="false"/>
- 必需: 将两个 URL 值更改为您在配置 Rational DOORS 数据库服务器中为 dbadmin 命令输入的值。将 http://MYHOSTNAME.8080/ 更改为针对 -dwaProtocol、-dwaHost 和 –dwaPort 输入的值。 例如,如果输入了 -dwaProtocol http、-dwaHost dwaserver.ibm.com 和 -dwaPort 8080,请将该行更改为:
<f:property name="published.url.prefix" value="http://dwaserver.ibm.com:8080/doors/redirector/" />
<f:property name="oauth.domain" value="http://dwaserver.ibm.com:8080/dwa" />
要点: -dwaHost 的值必须是计算机的标准主机名。
- 必需: 将 ForceHttpsForAuthenticationForOAuth 设置为 false:
<f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
注: 如果 Tomcat 配置为使用 SSL,请将 ForceHttpsForAuthenticationForOAuth 设置为 true。
- 保存并关闭文件。