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

如果您正在使用 Rational® Engineering Lifecycle Manager,那么需要执行配置步骤,将产品设置为 TRS 提供程序,为 Lifecycle Query Engine 提供对数据的访问权限。如果您未使用 Rational Engineering Lifecycle Manager,那么不需要完成此部分中的步骤。

一旦您已经安装和配置了所有应用程序,并且创建了远程服务器上的应用程序之间的友元关系,就需要将每个应用程序设置为“跟踪的资源集”(TRS) 提供程序,以便在创建索引时 Lifecycle Query Engine 对这些应用程序的数据具有访问权。

先决条件:

分配“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. 如果这是您的 RM 应用程序,请为 DOORS® Next Generation 创建 LQE 入站使用者密钥。 打开 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 文档:使用 Lifecycle Query Engine 对数据建立索引

将 DOORS 和 DOORS Web Access 配置为 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 属性文件中为此用户设置密码。
  1. 打开 [DWA_path]\server\festival\config\festival.xml
    1. 搜索可配置的系统属性这一节。
    2. oauth.domain 属性下,添加下表中所列示的属性,替换您的 DOORS 管理标识和密码,并选择使用者密钥和私钥。这些属性的格式应为如下所示:
      <f:property name="functional.user.consumer.key" value="consumer_key" />
    表 1. TRS 和 LQE 的 festival.xml 文件属性
    属性 描述/值
    ForceHttpsForAuthenticationForOAuth 请将此值设置为 true
    oauth.domain 请将此值设置为 https://server:port/dwa,其中 server 是服务器的域名或 IP 地址。
    functional.user.consumer.key 与 LQE 有效用户相关联的使用者密钥。Lifecycle Query Engine 使用此密钥来访问 DOORS 跟踪的资源集 (TRS)。此密钥必须存在于 Rational DOORS 配置本地密钥选项卡上。缺省值为 LQE 有效用户密钥
    functional.user.consumer.secret 与 LQE 有效用户相关联的使用者私钥。Lifecycle Query Engine 使用此密钥来访问 DOORS 跟踪的资源集 (TRS)。此私钥必须存在于 Rational DOORS 配置本地密钥选项卡上。缺省值为 qwert6
    functional.user.name LQE 有效用户的用户名。此用户名必须是有效 Rational DOORS 用户。缺省值为 LQE 有效用户
    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
  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. 运行以下批处理文件:dwa_install/derby.start.bat
  5. 运行以下批处理文件:dwa_install/derby/scripts/init_trs.bat
  6. 启用数据更改通知 (DCN) 参数来配置 Rational DOORS 数据库服务器,以与 Rational DOORS Web Access 代理和 Rational DOORS Web Access 服务器进行通信。有关更多信息,请参阅以下主题:http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp?topic=/com.ibm.rational.dwa.install.doc/topics/c_setupddbs.html
  7. 按以下顺序重新启动 DOORS Web Access 服务器:
    1. 代理
    2. 互操作
    3. 数据库服务器
    4. Web 应用程序服务器
  8. 使用下列凭证登录到 Rational DOORS:
    • 用户名:LQE 有效用户或者您在 festival.xml 文件中指定的有效用户名。
    • 密码:qwert6 或者您在 festival.xml 文件中指定的有效用户密码。
  9. 文件菜单中选择 OSLC...本地密钥,然后单击添加
    • 名称:LQE
    • 密钥:xyz
    • 私钥:xyz
    单击注册,然后单击确定
  10. 文件菜单中选择OSLC...工作集
  11. 选择项目窗格中查找需求文件夹,然后在选择模块窗格中选中此文件夹下的所有模块。单击应用

配置 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 文件中的值相匹配。
    <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 管理页面:httpslqe_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. 展开“样本”节点,然后选择所有工件。系统可能会提示您为正在对其运行查询的所有应用程序授权。单击您想要查询的每个应用程序旁边的授权
    用户授权屏幕
  7. 查询结果应显示您已创建的样本产品。

为 Jazz Team Server 用户配置 TRS

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

反馈