使用根服务文档连接至 TRS 提供程序以作为 Lifecycle Query Engine 索引的数据源

任何支持 TRS 规范的生命周期工具都可用作数据源以创建链接的生命周期数据索引。 如果生命周期应用程序具有用于声明它自己的 OAuth URL 的根服务文档,那么您可以通过使用根服务 URL 来注册 TRS。对于已向除 LQE 外的其他 JTS 服务器注册的应用程序,这是添加数据源的最简单方法。 与 TRS 提供程序(生命周期应用程序)通信时,LQE 将直接与应用程序通信并进行认证。

开始之前

您必须在应用程序内为 LQE 创建 OAuth 使用者私钥/密钥对。该入站使用者必须可信并且必须具有有效用户 (lqe_user)。必须将 TRS 内部许可证指定给有效用户。有关更多信息,请参阅配置 Lifecycle Query Engine 以访问生命周期应用程序数据

过程

  1. 在 LQE 管理面板中,选择数据源面板。 此面板会显示 LQE 已连接至的任何数据源的实时状态。
    用于显示正在建立索引的数据源的“数据源”面板的截屏。
  2. 选择添加数据源,然后单击根服务 URL
    “添加数据源”向导的截屏。
    1. 输入您要添加的应用程序的根服务文档。此输入内容的缺省格式为:https://server:port/tool/rootservices
    2. 列在此根服务文档中且已找到的数据源将采用与以下内容类似的格式进行列示:https://server:port/tool/trs。选择要添加的数据源。
    3. 作为数据源的标识来添加标签。
    4. 计划字段允许您设置发生初始建立索引的时间。将这些字段留空将导致在向导完成后立即创建索引。在测试实验室环境中,LQE 可以在不到 1 小时的时间内为 50 000 个工件建立索引 - 根据硬件和配置,您建立索引的速度可能更慢。
      注: 可以同时为多个数据源建立索引。 每一个都将在它自己的线程上运行。或者,您可以将多个 TRS 数据源的初始建立索引任务安排成逐个运行。
    5. 因为该应用程序所在的 JTS 与 LQE 正在使用的 JTS 不同,所以您需要指定 OAuth 认证。单击下一步
  3. 指定认证详细信息面板上,输入该应用程序的 OAuth 使用者密钥和私钥。
    认证详细信息面板
    1. 在另一个浏览器窗口中,查找您为 LQE 生成的密钥:将应用程序注册为 Lifecycle Query Engine 的 TRS 提供程序。在本示例中,您要添加 QM 应用程序,所以您将转至 QM 管理面板:https://server:port/QM/admin#action=com.ibm.team.repository.admin.configureOAuth
      注: 除非已将认证委派给 Jazz Team Server,否则您应该转至该应用程序的管理面板,而不是 Jazz Team Server 管理面板。
    2. 授权的密钥列表下面,找到并复制 lqe_user 密钥和私钥。
    3. 返回至 LQE 浏览器窗口,并输入使用者密钥私钥
  4. 选择数据源配置选项。
    “添加数据源”向导的“配置数据源”面板的截屏
    1. 刷新率指定 LQE 尝试访问数据源以持久刷新其索引的频率。不经常更新的数据源的刷新率可以低于连续更新的数据源的刷新率。提高刷新率将影响性能。
    2. 通常,应该将初始建立索引的线程数设置为介于 2 和 4 之间。每一个线程都相当于使用 LQE 服务器的一个用户。对于 Intel 机器,至少应该提高 4 个以上线程的数据检索速度的频率。
    3. 通常,应该将进行中建立索引的线程数设置为介于 2 和 4 之间。每一个线程都相当于使用 LQE 服务器的一个用户。对于 Intel 机器,至少应该提高 4 个以上线程的数据检索速度的频率。
    4. 当遇到无法对其建立索引的资源时,这些跳过的资源允许 LQE 记录错误并继续建立索引;如果遇到此类情况,请继续执行增量更新。 缺省情况下,将选择此项。 如果禁用此项,那么建立索引进程将在无法对资源建立索引的任何时间停止。
  5. 完成该向导之后,将向您显示可以随时为此数据源配置的数据。单击保存以开始建立索引。 建立索引进程的实时状态显示在主数据源面板中。单击状态字段中的链接将显示建立索引进程的详细状态报告。
    “数据源”状态概述页面的截屏
    “数据源”状态历史记录页面的截屏

下一步做什么

您可以通过将光标悬浮在相关联的操作字段上方并单击图标来停止建立数据源的索引或暂停建立索引过程。


视频图标 观看视频

CLM 播放列表
Jazz.net 频道
User Education 频道

学习图标 了解更多

CLM 学习圈
Agile 学习圈
学习圈

提问图标 提出问题

Jazz.net 论坛
developerWorks 论坛

支持图标 获取支持

Support Portal
Deployment Wiki
Support 博客