您可以通过编辑配置文件和运行 Derby 批处理文件将 IBM® Rational® DOORS® 配置为跟踪资源集 (TRS) 的提供程序。
关于此任务
Rational DOORS 和 Derby 随附若干用于启用 TRS 的缺省用户和密码。您必须编辑与这些用户关联的配置参数,如以下过程中所述。集成使用以下用户:
- LQE 功能用户。此用户处理从集成 TRS 用户应用程序到 Rational DOORS Web Access 的 LQE 请求。此用户必须存在于 Rational DOORS 数据库中。必须在 festival.xml 文件中为此用户指定参数。
- trs.db.user。这是对 TRS 数据库数据具有访问权的 Derby 数据库用户。它由 Rational DOORS Web Access 用于从数据库检索数据。必须在 festival.xml 文件和 Derby 属性文件中为此用户指定密码。
- derby.user.admin。这是 Derby 数据库管理员。
当前,此用户不为 Rational DOORS Web Access 或 Derby 数据库提供功能。可以在 Derby 属性文件中为此用户设置密码。
过程
- 在编辑器中打开 Rational DOORS Web Access festival.xml 文件。此文件位于 dwa_install\server\festival\config 目录中。
- 输入 LQE 功能用户和 TRS 用户的属性值,如下表中所述。请参阅本主题结尾处这些属性的示例。
表 1. TRS 和 LQE 的 festival.xml 文件属性属性 |
描述/值 |
ForceHttpsForAuthenticationForOAuth |
将该值设置为 true。 |
oauth.domain |
将该值设置为 https://server:port/dwa,其中 server 是服务器域名或 IP 地址。 |
functional.user.consumer.key |
与 LQE 功能用户关联的使用者密钥。它由生命周期查询引擎用于访问 DOORS 跟踪资源集 (TRS)。此密钥必须位于 Rational DOORS 配置的本地密钥选项卡上。
缺省值为 LQE Functional User Key。 |
functional.user.consumer.secret |
与 LQE 功能用户关联的使用者密码。它由生命周期查询引擎用于访问 DOORS 跟踪资源集 (TRS)。此密码必须位于 Rational DOORS 配置的本地密钥选项卡上。缺省值为 qwert6。 |
functional.user.name |
LQE 功能用户的用户名。此用户名必须是有效的 Rational DOORS 用户。缺省值为 LQE Functional User。 |
functional.user.password |
LQE 功能用户的密码。缺省值为 qwert6。 |
trs.db.user |
用于启用 TRS 的用户名。为简单明了,使用缺省用户名 trs.db.user。 |
trs.db.password |
trs.db.user 的密码。
您还必须在 Derby 属性文件中指定此密码。 |
trs.page.size |
要包含在页面上的 TRS 资源数。缺省值为 250。 |
trs.enable |
将该值设置为 true。 |
- 在编辑器中打开 derby.properties 文件。此文件位于 dwa_install/derby 目录中。
- 替换下表中参数的密码值。
表 2. TRS 的 Derby 属性文件参数参数 |
描述 |
derby.user.trs |
您在 festival.xml 文件中指定的 trs.db.user 的密码。缺省值为 dwaTrsPa11word。 |
derby.user.admin |
Derby 数据库管理员的密码。
当前,此用户不为 Rational DOORS Web Access 或 Derby 数据库提供功能。缺省值为 dwaTrsPa11word。 |
- 运行以下批处理文件:dwa_install/derby.start.bat。
- 运行以下批处理文件:dwa_install/derby/scripts/init_trs.bat。
- 启用数据变更通知 (DCN) 参数以将 Rational DOORS 数据库服务器配置为与 Rational DOORS Web Access 代理程序和 Rational DOORS Web Access 服务器进行通信。
- 通过使用以下凭证登录到 Rational DOORS:
- 用户名:LQE Functional User 或您在 festival.xml 文件中指定的功能用户名。
- 密码:qwert6 或您在 festival.xml 文件中指定的功能用户密码。
- 打开数据库属性,并且注明 Rational DOORS 配置的本地密钥选项卡包含您在 festival.xml 文件中指定的使用者密钥和密码。
- 通过使用以下 Rational DOORS Web Access URL 在 Jazz 注册应用程序页面上注册 Rational DOORS Web Access:install_path/dwa/public/scr。
示例
从
festival.xml 文件进行的以下抽取显示与 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"/>
下一步做什么
由 TRS 用户应用程序(如 Rational Engineering Lifecycle Management (RELM))使用的生命周期查询引擎 (LQE) 通过多个生命周期工具来构建数据的主索引(数据库)。各 TRS 提供程序工具通过跟踪资源集来发布其数据。LQE 可以通过各工具收集或“索引”数据。
团队可以使用 SPARQL 语言编写索引数据的查询(报告)。
在 LQE 管理应用程序中为 Rational DOORS 添加数据源时,请确保设置以下值:
- 用于初始索引的线程数:1
- 用于增量索引的线程数:1
- 刷新率:60
在
管理选项卡 >
配置 >
高级属性上设置以下 HTTP 超时值。
缺省值为 60 秒。两者都应增加为 10 分钟,即 600 秒。
- 连接超时(最小值):10 分钟(600 秒)
- 套接字超时(最小值):10 分钟(600 秒)