将 Rational DOORS Web Access 配置为 TRS 提供程序

您可以通过编辑配置文件和运行 Derby 批处理文件将 IBM® Rational® DOORS® Web Access 配置为跟踪资源集 (TRS) 的提供程序。

关于此任务

Rational DOORS Web Access 和 Derby 随附若干用于启用 TRS 的缺省用户和密码。如果修改用户名或密码,那么必须编辑与这些用户关联的配置参数,如以下过程中所述。集成使用以下用户:
LQE Functional User
此标准 Rational DOORS 用户处理从集成 TRS 用户应用程序到 Rational DOORS Web Access 的生命周期查询引擎 LQE 请求。如果该用户具有缺省值之外的用户名和密码,那么这些值必须与 festival.xml 文件中的条目匹配,如以下过程中所述。
trs.db.user
此 Derby 数据库用户可访问 TRS 数据库数据,并由 Rational DOORS Web Access 用于从数据库检索数据。如果想要使用缺省用户名和密码之外的值,必须在 festival.xml 文件中创建条目。如果更改密码,必须在 Derby 属性文件中输入新密码。
derby.user.admin
此 Derby 数据库管理员当前没有提供 Rational DOORS Web Access 的功能。可以在 Derby 属性文件中为此用户设置密码。
要点: 管理员必须采取操作以维护 Derby 数据库的完整性并防止其损坏。有关更多信息,请参阅 Derby Server and Administration Guide 中的“Maintaining database integrity”。

过程

  1. 停止所有 Rational DOORS Web Access 组件,如启动、停止和除去 Rational DOORS Web Access中所述。
  2. 备份 install.ini 文件并在编辑器中打开原始文件。此文件位于 dwa_install\server\festival\config 目录中。
  3. 输入 LQE Functional User 和 TRS 用户的以下属性值:
    ForceHttpsForAuthenticationForOAuth
    将该值设置为 true
    functional.user.consumer.key
    该使用者秘钥与 LQE 功能用户关联。LQE 使用该秘钥来访问 Rational DOORS TRS。此密钥必须与 Rational DOORS 配置的“本地密钥”窗口中的使用者秘钥条目匹配。 缺省值为 LQE Functional User Key。仅当您使用缺省值之外的值时,festival.xml 文件中才需要该属性。
    functional.user.consumer.secret
    该使用者私钥与 LQE Functional User 关联。LQE 使用该秘钥来访问 Rational DOORS TRS。此密钥与 Rational DOORS 配置的“本地密钥”窗口中的 OAuth 私钥条目匹配。 缺省值为 qwert6。仅当您使用缺省值之外的值时,festival.xml 文件中才需要该属性。
    functional.user.name
    此属性是 LQE Functional User 的用户名。此用户必须是标准 Rational DOORS 用户,该用户具有读取旨在 LQE 中使用的所有 Rational DOORS 数据的特权。此值必须与 Rational DOORS 配置的“本地密钥”窗口中的使用者名称条目匹配。 缺省值为 LQE Functional User。仅当您使用缺省值之外的值时,festival.xml 文件中才需要该属性。
    functional.user.password
    此属性是 LQE Functional User 的密码。缺省值为 qwert6。仅当您使用缺省值之外的值时,festival.xml 文件中才需要该属性。
    trs.db.user
    该属性是用于启用 TRS 的用户名。缺省用户名是 trs。仅当您使用缺省值之外的值时,festival.xml 文件中才需要该属性。
    trs.db.password
    此属性是 trs.db.user 的密码。 缺省值为 dwaTrsPa11word。仅当您使用缺省值之外的值时,festival.xml 文件中才需要该属性。如果使用缺省值之外的值,那么必须在 Derby 属性文件中输入新的密码,如该过程中接下来的步骤中所述。
    trs.page.size
    该属性指示页面上要包含的 TRS 资源的数量。缺省值为 250
    trs.enable
    将该值设置为 true
    festival.xml 文件进行的以下抽取显示与 TRS 相关的属性的示例:
    <f:property name="ForceHttpsForAuthenticationForOAuth" value="true"/> 
    <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"/>
  4. 保存并关闭 festival.xml 文件。
  5. 如果更改 festival.xml 文件中 trs.db.password 的缺省值,请遵循以下步骤:
    1. 在编辑器中打开 derby.properties 文件。该文件位于 dwa_install/derby 目录中。
    2. 替换 derby.user.trs 值。derby.properties 文件包含以下值:
      derby.user.trs
      这是您在 festival.xml 文件中指定的 trs.db.user 的密码。缺省值为 dwaTrsPa11word
      derby.user.admin
      这是 Derby 数据库管理员的密码。当前,该用户没有提供 Rational DOORS Web Access 的功能。缺省值为 dwaTrsPa11word
  6. 启动所有 Rational DOORS Web Access 组件,如启动、停止和除去 Rational DOORS Web Access中所述。

下一步做什么

使用 OSLC 好友关系配置了与 TRC 使用者应用程序的集成之后,您必须将 Rational DOORS 注册为使用者应用程序中的 TRS 提供者。 关于该过程的示例,在 IBM Rational Engineering Lifecycle Management 的文档中,参阅“将应用程序注册为 Lifecycle Query Engines 的 TRS 提供程序”。

由 TRS 用户应用程序(如 Rational Engineering Lifecycle Management)使用的 LQE 通过多个生命周期工具来构建数据的主索引数据库。各 TRS 提供程序工具通过 TRS 来发布其数据。LQE 可以通过各工具收集或索引数据。 团队可以使用 SPARQL 语言编写索引数据的查询(与报告类似)。 在 LQE 管理应用程序中为 Rational DOORS 添加数据源时,请设置以下值:
  • 用于初始索引的线程数:1
  • 用于增量索引的线程数:1
  • 刷新率:60
管理选项卡上,单击Configuration > 高级属性并设置以下 HTTP 超时值。缺省值为 60 秒。增大两个值:
  • 连接超时(最小值):5 分钟(300 秒)
  • 套接字超时(最小值):15 分钟(900 秒)

反馈