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

任何支持 TRS 规范的生命周期工具都可用作数据源以创建链接的生命周期数据索引。本主题描述了如何使用根服务文档为与 LQE 不同的 JTS 上的生命周期工具生成索引。对于远程 Jazz™ Team Server 上的应用程序,这是将数据源添加至 LQE 的最简单方法。

开始之前

必须为生命周期工具在 JTS 中创建 LQE 功能用户 (lqe_user),如在 JTS 管理控制台中配置 LQE中所述

关于此任务

如果应用程序具有用于声明它自己的 OAuth URL 的根服务文档,那么您可以通过根服务 URL 来注册 TRS。将您的应用程序向不同的 JTS 注册(而不向 LQE 注册)时,通常首选这种方法。与 TRS 提供程序(您的应用程序)通信时,LQE 将直接与您的应用程序通信并直接向该应用程序进行认证。 同样地,您必须在应用程序内为 LQE 创建 OAuth 使用者私钥/密钥对。该入站使用者必须可信并且必须具有有效用户 (lqe_user)。必须将 TRS 内部许可证指定给有效用户。

过程

  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. 完成该向导之后,将向您显示可以随时为此数据源配置的数据。单击保存以开始建立索引。 建立索引进程的实时状态显示在主数据源面板中。单击状态字段中的链接将显示建立索引进程的详细状态报告。
    “数据源”状态概述页面的截屏
    “数据源”状态历史记录页面的截屏

下一步做什么

如果您在任何时间点处需要停止对数据源建立索引或暂停建立索引进程,请在主“数据源”窗口中将光标悬浮在操作字段上以显示适用于暂停、停止或删除索引的图标。


反馈