将应用程序注册为 Lifecycle Query Engine 的 TRS 提供程序

如果您正在使用 Rational® Engineering Lifecycle Manager,那么将产品设置为 TRS 提供程序以及对 Lifecycle Query Engine 给定对这些产品的数据的访问权时需要配置步骤。

安装和配置所有应用程序且创建远程服务器上的应用程序之间的友元关系之后,将每个应用程序设置为跟踪资源集 (TRS) 提供程序,以便 Lifecycle Query Engine (LQE) 可访问这些应用程序的数据来创建索引。

先决条件:
要点: 如果您的应用程序与 LQE 位于不同的 Jazz™ Team Server,那么在将数据源添加至 Lifecycle Query Engine 时,会复用此任务中生成的密钥,如生成 LQE 索引中所述。 仔细注意每个密钥的名称和私钥。

分配“TRS 内部使用者”许可证

对有效用户 lqe_userjts_user 分配“TRS 内部使用者”许可证。

  1. 在以下网址打开 JTS 管理控制台:https://host_name:port/jts/admin
  2. 选择用户 > 活动用户
  3. 单击 lqe_user 链接。在 lqe_user 页面上,转至客户访问许可证区域并选择 TRS 内部使用者,然后单击保存
    为主要 LQE 用户选择“TRS 内部使用者”许可证
  4. 返回到活动用户页面。单击 jts_user 链接。在 jts_user 页面上,转至客户访问许可证区域并选择 TRS 内部使用者
  5. 单击保存

为 CLM 应用程序配置 TRS

如果已将这些应用程序作为 LQE 部署到同一 Jazz Team Server,那么没必要创建入站使用者。仅当 CCM、QM 和 RM 应用程序位于单独的 Jazz Team Server 上时,才完成这些步骤。

  1. 为 CCM 创建 LQE 入站使用者密钥。在以下网址打开 CCM 管理页面:https://host_name:port/ccm/admin
  2. 应用程序页面上,选择通信 >使用者(入站),然后为 LQE 创建新的 OAuth 使用者密钥:
    • 名称:LQE
    • 私钥:xyz
    • 可信:yes
    单击注册
  3. 转至已授权的密钥列表,然后通过单击画笔图标来编辑 LQE 条目。
  4. 编辑使用者密钥属性对话框中,单击选择用户...链接。
  5. 在“过滤器”字段中输入 lqe,然后从相匹配用户列表中选择 lqe_user。单击添加之后关闭,然后单击完成
  6. 为 QM 创建 LQE 入站使用者密钥。在以下网址打开 QM 管理页面:https://host_name:port/qm/admin,然后再次完成步骤 7 到步骤 10。
  7. 为 DOORS® Next Generation 创建 LQE 入站使用者密钥(如果这是您的 RM 应用程序)。在以下网址打开 RM 管理页面:https://host_name:port/rm/admin,然后再次完成步骤 7 到步骤 10。
  8. 将应用程序注册为 TRS 提供程序,然后生成它们的索引。在以下网址打开 Lifecycle Query Engine 管理页面:https://host_name:port/lqe/web
  9. 单击管理 > 数据源 > 添加数据源
  10. 添加数据源对话框中,选择 https://host_name:port/ccm/oslc/workitem/trs,然后添加 RTC 标签。接受剩余缺省值(如果您有大量数据要建立索引,请将初始建立索引的线程数增大到 4),然后单击完成
  11. 将 QM 注册为 TRS 提供程序,然后生成其索引。在数据源页面上,单击添加数据源
  12. 添加数据源对话框中,选择 https://host_name:port/qm/trs,然后添加 RQM 标签。接受剩余缺省值,然后单击完成
  13. 将 RM 注册为 TRS 提供程序,然后生成其索引。在数据源页面上,单击添加数据源
  14. 添加数据源对话框中,选择 https://host_name:port/rm/trs,然后添加 DNG 标签。接受剩余缺省值,然后单击完成

Rational Team Concert™、Rational Quality Manager 和 Rational DOORS Next Generation 应用程序现在已建立索引,并且可用于 Rational Engineering Lifecycle Manager。有关正在进行建立索引的首选项的更多信息,请参阅:使用 Lifecycle Query Engine 对数据建立索引

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

Rational DOORS Web Access 提供了若干缺省用户和密码以启用 TRS。您必须编辑与这些用户相关联的配置参数,如以下过程中所述。集成使用下列用户:
  • LQE 有效用户。此用户将处理从集成 TRS 使用者应用程序向 Rational DOORS Web Access 发出的 LQE 请求。此用户必须存在于 Rational DOORS 数据库中。必须在 festival.xml 文件中为此用户指定参数。
  • trs.db.user。这是对 TRS 数据库数据具有访问权的 Derby 数据库用户。Rational DOORS Web Access 使用此用户从数据库中检索数据。
  • derby.user.admin。这是 Derby 数据库管理员。当前,此用户未对 Rational DOORS Web Access 或者 Derby 数据库提供功能。您可以在 Derby 属性文件中为此用户设置密码。
  1. 打开 [DWA_path]\server\festival\config\festival.xml
    1. 搜索可配置的系统属性这一节。
    2. 添加下表中所列示的属性。
      属性格式:
      <f:property name="property_listed_in_table" value="appropriate_value_or_default_listed_in_table" />
    表 1. TRS 和 TRS 的 Festival.xml 文件属性
    属性 描述/值
    functional.user.consumer.key 与 LQE 有效用户相关联的使用者密钥。Lifecycle Query Engine 使用此密钥来访问 DOORS 跟踪的资源集 (TRS)。此密钥必须位于 Rational DOORS 配置本地密钥选项卡上。
    functional.user.consumer.secret 与 LQE 有效用户相关联的使用者私钥。Lifecycle Query Engine 使用此密钥来访问 DOORS 跟踪的资源集 (TRS)。此私钥必须存在于 Rational DOORS 配置本地密钥选项卡上。
    functional.user.name LQE 有效用户的用户名。此用户名必须是有效 Rational DOORS 用户。确保您在 festival.xml 文件中所使用的 DOORS 用户标识存在,并且对您在工作集中显示的项目和工件具有完全访问权。
    functional.user.password LQE 有效用户的密码。
    trs.db.user TRS 启用的用户名。为了简单起见,使用缺省用户名 trs.db.user。如果未指定此属性,那么系统将使用缺省值。
    trs.db.password trs.db.user 的密码。您还必须在 Derby 属性文件中指定此密码。缺省值为 dwaTrsPa11word。如果未指定此属性,那么系统将使用缺省值。
    trs.page.size 要包括在页面上的 TRS 资源数。缺省值为 250。如果未指定此属性,那么系统将使用缺省值。
    trs.enable 请将此值设置为 true
    来自 festival.xml 文件的以下截取显示与 TRS 相关的属性示例:
    <f:property name="functional.user.consumer.key" value="xyz" /> 
    <f:property name="functional.user.consumer.secret" value="xyz" />
    <f:property name="functional.user.name" value="Administrator" /> 
    <f:property name="functional.user.password" value="qwert6" /> 
    <f:property name="trs.enable" value="true" />
  2. 可选:在编辑器中打开 derby.properties 文件。此文件位于 dwa_install/derby 目录中。
  3. 可选:替换下表中的参数的密码值。
    表 2. TRS 的 Derby 属性文件参数
    参数 描述
    derby.user.trs 您在 festival.xml 文件中指定的 trs.db.user 的密码。缺省值为 dwaTrsPa11word
    derby.user.admin Derby 数据库管理员的密码。当前,此用户未对 Rational DOORS Web Access 或者 Derby 数据库提供功能。缺省值为 dwaTrsPa11word
  4. 初始化 TRS 数据库。运行以下脚本:
    • 对于 Windows。
      dwa_install/derby.start.bat
      dwa_install/derby/scripts/init_trs.bat
    • 对于 Linux。
      dwa_install/derby.start.sh
      dwa_install/derby/scripts/init_trs.sh
  5. 以数据库管理器类型的用户或管理员身份登录 Rational DOORS 客户机。
  6. 选择文件 > OSLC > 本地密钥。在“本地密钥”窗口中,单击添加。使用在 festival.xml 文件中指定的值。
    • 使用者名称:任何名称。推荐使用 LQE
    • 使用者密钥:对 functional.user.consumer.key 属性设置的值。
    • 使用者私钥:对 functional.user.consumer.secret 属性设置的值。
    单击注册,然后单击确定
  7. 选择文件 > OSLC > 工作集。在“选择项目”窗口中,选择您要显示给 LQE 的项目、文件夹和模块。
  8. 选择模块窗格中选择所有必需的模块。单击应用

配置 LQE 以使用 DOORS Web Access 作为数据源

  1. 浏览到 https://hostname:port/lqe/web
  2. 在工具栏菜单中选择管理
  3. 数据源页面上,选择添加数据源
  4. 添加数据源对话框中,选择“根服务文档 URL”选项。输入 DOORS 根服务 URL。选择 TRS URL。输入一个标签 ,然后选择指定认证详细信息
    • 根服务 URL:https://doorsserver:port/dwa/public/rootservices
    • 选择 https://doorsserver:port/dwa/rm/trs
    • 标签:DOORS
    添加至 LQE 的 DOORS 的数据源值的截屏
  5. 输入使用者密钥和私钥。
    注: 使用者密钥和私钥必须与 DOORS Web Access festival.XML 文件中的值相匹配。在以下示例中,值 xyz 为示例。
    <f:property name="functional.user.consumer.key" value="xyz"/>
    <f:property name="functional.user.consumer.secret" value="xyz"/>
    使用者密钥和私钥的截屏
  6. 首次建立索引和以递增方式建立索引时,将线程数设置为 1,然后单击完成。如果使用了多个线程来建立索引,那么可能会发生偶然性错误。

为 Rhapsody Design Manager 应用程序配置 TRS

  1. 转至 https://hostname:port/jts/admin
    注: Design Manager 入站使用者在 Jazz Team Server 管理控制台中定义而不是 Design Manager 控制台中定义。
  2. 选择服务器 > 使用者(入站),输入以下信息,然后单击注册
    • 名称:LQE
    • 私钥:xyz
    • 可信:yes
  3. 转至已授权的密钥列表,然后通过单击画笔图标来编辑 LQE 条目。
  4. 编辑使用者密钥属性对话框中,单击选择用户...链接。
  5. 在“过滤器”字段中输入 lqe,然后从相匹配用户列表中选择 lqe_user。单击添加之后关闭,然后单击完成
  6. 转至 https://hostname:port/dm/web
  7. 以管理用户身份登录。
  8. 选择项目区域,然后从管理下拉菜单(齿轮图标)中选择管理项目属性。选择缺省 OSLC 上下文,然后单击选择。单击您的项目名称,然后依次按确定保存
    选择项目区域,并确保指定缺省 OSLC 上下文。
  9. 将 Rhapsody® DM 注册为 TRS 提供程序,然后生成其索引。在以下网址打开 Lifecycle Query Engine 管理页面:https://lqe_host_name:port/lqe/web
  10. 单击管理 > 数据源 > 添加数据源
  11. 添加数据源对话框中,选择 http://rdm_host_name:9443/dm/trs,然后添加 RDM 标签。接受剩余缺省值(如果您有大量数据要建立索引,请将初始建立索引的线程数增大到 4),然后单击完成

为 Rational Engineering Lifecycle Manager 应用程序配置 TRS

如果您是进行全新安装,那么将没有任何要建立索引的数据。您可以创建样本项目和产品,以便可以验证是否已成功创建索引。

  1. 在以下网址打开 Lifecycle Query Engine 管理页面:https://lqe_host_name:port/lqe/web
  2. 单击管理 > 数据源 > 添加数据源
  3. 添加数据源对话框中,选择 http://relm_host_name:port/productdef/resource/tracked_resource_set,然后添加 RELM 标签。接受剩余缺省值(如果您有大量数据要建立索引,请将初始建立索引的线程数增大到 4),然后单击完成
    显示所有已建立索引的组件的数据源列表。
  4. 要测试索引,请打开 Rational Engineering Lifecycle Manager:https://relm_host_name:port/relm/web
  5. 选择一个样本项目。从查询菜单中选择共享查询
  6. 展开“样本”节点,然后选择所有工件。系统可能会提示您为正在对其运行查询的所有应用程序授权。在“用户授权”页面 https://relm_host_name:port/lqe/web/auth 中,单击您要查询的每个应用程序旁边的授权
    用户授权屏幕
  7. 查询结果将显示您已创建的样本产品。

为 Jazz Team Server 用户配置 TRS

  1. 在以下网址打开 Lifecycle Query Engine 管理页面:https://lqe_host_name:port/lqe/web
  2. 单击管理 > 数据源 > 添加数据源
  3. 添加数据源对话框中,选择 httphost_name:port/jts/trsUsers,然后添加 Users 标签。接受剩余缺省值,然后单击完成

待办事宜

将您的应用程序配置为 TRS 提供程序之后,请遵循运行查询以进行测试或调试中的步骤来验证您的配置。


反馈