如果您正在使用 Rational® Engineering
Lifecycle Manager,那么需要执行配置步骤,将产品设置为 TRS 提供程序,为 Lifecycle Query
Engine 提供对数据的访问权限。如果您未使用 Rational Engineering Lifecycle Manager,那么不需要完成此部分中的步骤。
一旦您已经安装和配置了所有应用程序,并且创建了远程服务器上的应用程序之间的友元关系,就需要将每个应用程序设置为“跟踪的资源集”(TRS) 提供程序,以便在创建索引时 Lifecycle Query Engine 对这些应用程序的数据具有访问权。
分配“TRS 内部使用者”许可证
对有效用户 lqe_user 和 jts_user 分配“TRS 内部使用者”许可证。
- 在以下网址打开 JTS 管理控制台:https://host_name:port/jts/admin
- 选择用户 > 活动用户。
- 单击 lqe_user 链接。在 lqe_user 页面上,转至客户访问许可证区域并选择 TRS 内部使用者,然后单击保存。
- 返回到活动用户页面。单击 jts_user 链接。在 jts_user 页面上,转至客户访问许可证区域并选择 TRS 内部使用者。
- 单击保存。
为 CLM 应用程序配置 TRS
如果这些应用程序作为 LQE 部署至同一 Jazz™ Team
Server,那么不需要创建入站使用者。仅当 CCM、QM 和 RM 应用程序位于不同的 Jazz Team
Server 上时,才需完成这些步骤。
- 为 CCM 创建 LQE 入站使用者密钥。打开 CCM 管理页面:https://host_name:port/ccm/admin
- 在应用程序页面上,选择通信 >使用者(入站),然后创建新的 LQE OAuth 使用者:
单击注册。
- 转至已授权的密钥列表,然后通过单击画笔图标来编辑 LQE 条目。
- 在编辑使用者密钥属性对话框中,单击选择用户...链接。
- 在“过滤器”字段中输入 lqe,然后从相匹配用户列表中选择 lqe_user。单击添加之后关闭,然后单击完成。
- 为 QM 创建 LQE 入站使用者密钥。打开 QM 管理页面:https://host_name:port/qm/admin,然后再次完成步骤 7 到步骤 10。
- 如果这是您的 RM 应用程序,请为 DOORS® Next Generation 创建 LQE 入站使用者密钥。
打开 RM 管理页面:https://host_name:port/rm/admin,然后再次完成步骤 7 到步骤 10。
- 将应用程序注册为 TRS 提供程序,然后为其生成索引。打开 Lifecycle Query Engine 管理页面:https://host_name:port/lqe/web。
- 单击管理 > 数据源 > 添加数据源。
- 在添加数据源对话框中,选择 https://host_name:port/ccm/oslc/workitem/trs,然后添加 RTC 标签。接受其余缺省值(如果您有大量数据要建立索引,那么您可能需要将初始建立索引的线程数增大到 4),然后单击完成。
- 将 QM 注册为 TRS 提供程序,然后生成其索引。在数据源页面上,单击添加数据源。
- 在添加数据源对话框中,选择 https://host_name:port/qm/trs,然后添加 RQM 标签。接受其余缺省值,然后单击完成。
- 将 RM 注册为 TRS 提供程序,然后生成其索引。在数据源页面上,单击添加数据源。
- 在添加数据源对话框中,选择 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 属性文件中为此用户设置密码。
- 打开 [DWA_path]\server\festival\config\festival.xml。
- 搜索可配置的系统属性这一节。
- 在 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。 |
- 在编辑器中打开 derby.properties 文件。此文件位于 dwa_install/derby 目录中。
- 替换下表中的参数的密码值。
表 2. TRS 的 Derby 属性文件参数参数 |
描述 |
derby.user.trs |
您在 festival.xml 文件中指定的 trs.db.user 的密码。缺省值为 dwaTrsPa11word。 |
derby.user.admin |
Derby 数据库管理员的密码。当前,此用户未对 Rational DOORS Web Access 或者 Derby 数据库提供功能。缺省值为 dwaTrsPa11word。 |
- 运行以下批处理文件:dwa_install/derby.start.bat。
- 运行以下批处理文件:dwa_install/derby/scripts/init_trs.bat。
- 启用数据更改通知 (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
- 按以下顺序重新启动 DOORS Web Access 服务器:
- 代理
- 互操作
- 数据库服务器
- Web 应用程序服务器
- 使用下列凭证登录到 Rational DOORS:
- 用户名:LQE 有效用户或者您在 festival.xml 文件中指定的有效用户名。
- 密码:qwert6 或者您在 festival.xml 文件中指定的有效用户密码。
- 在文件菜单中选择 OSLC...本地密钥,然后单击添加。
单击注册,然后单击确定。
- 从文件菜单中选择OSLC...工作集。
- 在选择项目窗格中查找需求文件夹,然后在选择模块窗格中选中此文件夹下的所有模块。单击应用。
配置 LQE 以使用 DOORS Web Access 作为数据源
- 浏览到 https://hostname:port/lqe/web
- 在工具栏菜单中选择管理。
- 在数据源页面上,选择添加数据源
- 在添加数据源对话框中,选择“根服务文档 URL”选项并输入 DOORS 根服务 URL,选择 TRS URL,输入标签,然后选择指定认证详细信息。
- 根服务 URL:https://doorsserver:port/dwa/public/rootservices
- 选择 https://doorsserver:port/dwa/rm/trs
- 标签:DOORS
- 输入使用者密钥和私钥。
注: 使用者密钥和私钥必须与 DOORS Web Access
Festival.XML 文件中的值相匹配。
<f:property name="functional.user.consumer.key" value="xyz"/>
<f:property name="functional.user.consumer.secret" value="xyz"/>
- 首次建立索引和以递增方式建立索引时,将线程数设置为 1,然后单击完成。如果使用了多个线程来建立索引,那么可能会发生偶然性错误。
为 Rhapsody Design Manager 应用程序配置 TRS
- 浏览到 https://hostname:port/jts/admin
注: Design
Manager 入站使用者是在 Jazz Team Server 管理控制台中定义的,而不是在 Design Manager 控制台。
- 选择服务器 > 使用者(入站),输入以下信息,然后单击注册:
- 转至已授权的密钥列表,然后通过单击画笔图标来编辑 LQE 条目。
- 在编辑使用者密钥属性对话框中,单击选择用户...链接。
- 在“过滤器”字段中输入 lqe,然后从相匹配用户列表中选择 lqe_user。单击添加之后关闭,然后单击完成。
- 浏览到 https://hostname:port/dm/web
- 以管理用户身份登录。
- 选择项目区域,然后从管理下拉菜单(齿轮图标)中选择管理项目属性。选择缺省 OSLC 上下文,然后单击选择,单击项目名称,按确定,然后单击保存。
- 将 Rhapsody® DM 注册为 TRS 提供程序,然后生成其索引。打开 Lifecycle Query Engine 管理页面:httpslqe_host_name:port/lqe/web。
- 单击管理 > 数据源 > 添加数据源。
- 在添加数据源对话框中,选择 http://rdm_host_name:9443/dm/trs,然后添加 RDM 标签。接受其余缺省值(如果您有大量数据要建立索引,那么您可能需要将初始建立索引的线程数增大到 4),然后单击完成。
为 Rational Engineering Lifecycle Manager 应用程序配置 TRS
如果您是进行全新安装,那么将没有任何要建立索引的数据。您可能想要创建样本项目和产品,以便可以验证是否已成功创建索引。
- 打开 Lifecycle Query Engine 管理页面:https://lqe_host_name:port/lqe/web。
- 单击管理 > 数据源 > 添加数据源。
- 在添加数据源对话框中,选择 http://relm_host_name:port/productdef/resource/tracked_resource_set,然后添加 RELM 标签。接受其余缺省值(如果您有大量数据要建立索引,那么您可能需要将初始建立索引的线程数增大到 4),然后单击完成。
- 要测试索引,请打开 Rational Engineering
Lifecycle Manager:https://relm_host_name:port/relm/web
- 选择样本项目。从查询菜单中选择共享查询。
- 展开“样本”节点,然后选择所有工件。系统可能会提示您为正在对其运行查询的所有应用程序授权。单击您想要查询的每个应用程序旁边的授权。
- 查询结果应显示您已创建的样本产品。
为 Jazz Team
Server 用户配置 TRS
- 打开 Lifecycle Query Engine 管理页面:https://lqe_host_name:port/lqe/web。
- 单击管理 > 数据源 > 添加数据源。
- 在添加数据源对话框中,选择 httphost_name:port/jts/trsUsers,然后添加 Users 标签。接受其余缺省值,然后单击完成。