管理和配置问题

本主题描述了您在安装、管理或配置 Rational® Engineering Lifecycle Manager 时可能遇到的一些问题。

将 Rational DOORS 配置成跟踪资源集 (TRS) 提供程序

将 Rational DOORS® 配置成 TRS 提供程序时,您将选择工具 > 配置 TRS。这偶尔会导致发生错误 CRCRD7213W: Unable to update the Tracked Resource Set configuration

要解决此错误,请更新任何需求,然后选择再次配置 TRS。

重新启动 Jazz Team Server 不会重新启动 Rhapsody DM

在将 Jazz™ Team Server、Rhapsody® DM 和 Rational Engineering Lifecycle Manager 全部安装到单个 JTS 的环境中(使用 Windows 2008 服务器上的缺省 Tomcat 和 Derby),重新启动 Jazz Team Server 不会始终重新启动 Rhapsody DM 服务器。

在以下情况下,您可能会遇到此问题:
  • 不能访问 Rhapsody DM 站点:https://hostname:9444/dm/web
  • https://hostname:9444/dm/admin 站点指示 Rhapsody DM 尚未向 Jazz Team Server 注册。
  • Lifecycle Query Engine 指示 Rhapsody DM 不是 TRS 提供程序:https://hostname:9444/lqe/web/admin/data-sources

请转至 Jazz Team Server > 配置 > 已注册的应用程序页面:https://hostname:9444/jts/admin 来确保已正确地配置 Rhapsody DM。应该有一个 Design Management 条目。

请转至 https://hostname:9444/jts/admin 站点,再转至应用程序管理部分并搜索 Design Management 来确认已启动 Rhapsody DM。如果 Design Management 部分显示它未定义或根本不显示,请重新启动 Jazz Team Server。

WebSphere Application Server 中不正确的 Lifecycle Query Engine 类装入器设置会导致创建错误版本的 Derby 数据库

必须遵循下列主题中描述的指示信息,才能正确部署 Lifecycle Query Engine:为 Lifecycle Query Engine 设置 WebSphere® Application Server

如果在 WebSphere Application Server 中尝试启动 lqe_war 时遇到与以下消息类似的错误消息,那么您可能忘记了完成更改类装入器设置这一步骤。 此日志可在以下位置找到:WAS_install_dir/AppServer/Profiles/yourprofile/logs/Server1/SystemOut.log
Caused by: ERROR XSLAN: Database at C:\Users\IBM_ADMIN\Desktop\WAS_Config\server\conf\lqe\derbyDB has an incompatible format with the current version of the software.  The database was created by or upgraded by version 10.8.
使用缺省类装入器设置时,WebSphere Application Server 会使用错误版本的 Derby 为 Lifecycle Query Engine 创建 Derby 数据库。
如果发生了这种情况,您可以通过完成下列步骤来解决这种情况:
  1. 在 WebSphere Application Server 管理控制台中,停止 lqe_war
  2. 删除 LQE 使用错误版本的 Derby 创建的 Derby 数据库。此数据库位于 lqe.config.location 变量(您在为 Lifecycle Query Engine 设置 WebSphere Application Server 的步骤 5 中设置该变量)中设置的路径内。

    例如,在缺省路径 C:\Program Files\IBM\JazzTeamServer\server\conf\lqe 中查找名为 derbyDB 的文件夹并删除整个文件夹。

  3. 在 WebSphere Application Server 管理控制台中,按照为 Lifecycle Query Engine 设置 WebSphere Application Server 中的描述来完成步骤 18 到 26。确保您保存主配置并启动 lqe_war

注销会导致 WebSphere Application Server 错误消息

如果正在运行WebSphere Application Server 并注销Rational Engineering Lifecycle Manager,那么您可能会遇到错误消息:SESN0008EA: user authenticated as anonymous has attempted to access a session owned by user...

通过添加定制会话管理器属性,在 WebSphere Application Server(V8.0.0.3 或更高版本)上启用修订。单击应用程序服务器 > server1 > 会话管理 > 定制属性,然后添加 InvalidateOnUnauthorizedSessionRequestException = true 定制属性。

或者,如果您关闭浏览器窗口(而不是显式注销),那么该会话最终会自己超时。

升级 Rational Engineering Lifecycle Manager 导致 TRS 许可证不可用

在升级 Rational Engineering Lifecycle Manager 之后,TRS 许可证可能尚未添加到许可证密钥管理器。这将导致 LQE 建立索引失败并显示类似如下的错误:
Error 403: CRJAZ0977I The com.ibm.team.jazz.foundation.enterprise server license policy does not allow the com.ibm.team.jis.trs.read operation. 
com.ibm.team.jis.lqe.http.error.HttpForbiddenException: Forbidden
如果发生此错误,请手动将 TRS 许可证添加到 Jazz Team Server 许可证密钥管理器。

升级 DOORS Next Generation

配置或升级“需求管理 (RM)”服务器时,OAuth 使用者密钥可能会发生问题,使该服务器变得不可用。设置向导中的按钮可能已禁用,或者 server/logs/rdm.log 文件中可能发生以下错误:CRJZS0033E Invalid consumer key。 如果发生此问题,请参阅以下技术说明:对 OAuth 使用者密钥存在的问题进行故障诊断

WebSphere Application Server 堆大小不足导致错误

为 Rational Engineering Lifecycle Manager 设置 WebSphere Application Server 这一主题中,我们建议您将 WebSphere Application Server JVM 堆大小设置为 4096MB,或者调整此设置以适应用户数或正在处理的数据量。

如果您遇到类似于以下内容的错误,那么可通过增大 WebSphere Application Server 内存设置来解决问题。
  • relm.log
     CRCPC1815E An internal error has occurred.Explanation:
    java.lang.OutOfMemoryError
  • vvc.log
    CRJAZ1451I An exception occurred while executing the task "LogChangeEventAppenderTask", contributed by component "com.ibm.team.repository".  The task will be rescheduled.
    java.lang.OutOfMemoryError
  • lqe.log
    A fatal error occurred during change log processing. Aborting change log processing for https://jts.server.com:9443/application/trs
    java.lang.OutOfMemoryError

导入大型产品文件导致错误

当如导入产品树中所述导入产品树时,如果您尚未如先决条件中所述将 WebSphere Application Server Web 容器线程池最大值设置为 200,那么您可能遇到类似于 relm.log 文件中以下内容的错误:
ERROR com.ibm.relm.productdefapi - CRCPC2001E An internal error has occurred.
org.apache.http.conn.HttpHostConnectException: Connection to <host> refused

反馈