升级 ClearQuest Web 服务器功能部件:注意事项和最佳做法

在升级或移至新的 WebSphere® Application Server 概要文件时,ClearQuest® Web Server、全文搜索和报告功能部件都安装在同一 WebSphere Application Server 概要文件中。必须同时升级或移动所有这些功能部件。

升级或应用修订包之前,请查看会影响 ClearQuest Web 服务器功能部件的升级、配置和管理过程的重要信息。
要点: 如果 ClearQuest 环境包含全文搜索和 Report Launcher 功能部件,那么必须安装 WebSphere Application Server 32 位版本。在 WebSphere Application Server 64 位版本上不支持这些功能部件。 有关更多信息,请参阅技术说明 1512059

使用以下链接或向下滚动页面以获取有关升级 ClearQuest Web 服务器功能部件的信息。

ClearQuest Web 服务器

表 1 提供 ClearQuest Web 服务器的升级路径的概述。

表 1 主题按进行升级的源版本提供 ClearQuest Web 服务器升级过程的概述。
表 1. ClearQuest Web 服务器升级指示信息(按版本)
已安装的版本 升级概述
ClearQuest V7.x 在 ClearQuest V8.x 中,WebSphere Application Server 与 ClearQuest Web Server(在 ClearQuest V7.x 中称为 ClearQuest CM 服务器)分开进行安装。通过分开安装,可以独立于 ClearQuest 环境来管理 WebSphere Application Server 和 IBM® HTTP Server 环境。如果是从 V7.x 升级,请在升级 ClearQuest 资源之前,使用 IBM Installation Manager 来安装受支持版本的 WebSphere Application Server 和 IBM HTTP Server。 请参阅为 ClearCase 和 ClearQuest Web 服务器准备 WebSphere Application Server 环境
限制: 由于 ClearQuest V7.x 应用程序服务器体系结构和安装过程在 V8.x 中有所不同,因此在从 V7.x 升级到 V8.x 后不支持回滚操作。要复原先前版本,请移除新版本并重新安装先前版本的产品。
含有 WebSphere Application Server 7.0 的 ClearQuest V8.0
  1. 将 WebSphere Application Server 升级到 V8.0 或 V8.5。
  2. 将 ClearQuest 升级到 V8.0.1。
限制: 如果从 WebSphere Application Server 7.0 上的 ClearQuest V8.0 部署升级到 WebSphere Application Server 8.0 上的 ClearQuest V8.0.0.x 部署,那么不支持回滚操作。要复原先前版本,请移除新版本并重新安装先前版本的产品。
含有 WebSphere Application Server V8.0 的 ClearQuest V8.0.0.x 在 WebSphere Application Server V8.0 和 V8.5.0.x 上支持 ClearQuest V8.0.1。升级时,您具有以下选项:
  • 选项 1:将 Rational ClearQuest 升级到 V8.0.1 而不升级 WebSphere Application Server。
  • 选项 2:将 WebSphere Application Server 升级到 V8.5.0.x,然后将 Rational ClearQuest 升级到 V8.0.1。
有关更详细的升级指示信息(包括受支持安装、升级和回滚路径的兼容性矩阵),请参阅 IBM 支持 Web 站点上的技术说明 1634465

有关升级 ClearQuest Web 服务器的重要信息

  • 升级之前,请查看 ClearQuest 发行说明以了解与安装和升级相关的任何已知问题或限制。
  • 在升级过程中覆盖缺省端口号分配时,请谨慎操作。在升级或安装操作期间,分配了缺省端口号以确保每个端口都是唯一的。例如,如果 WebSphere Application Server V7.x 概要文件 AppSrv01 的缺省端口为端口 9080,那么在升级到 V8.0.x 时,分配给 AppSrv01 的缺省端口为 9081。如果覆盖缺省端口号,那么存在产生端口号冲突的风险。
  • 不能在 ClearQuest 升级过程中修改概要文件安全设置。 请使用 WebSphere Application Server 控制台来管理 WebSphere Application Server 管理安全性。
  • 如果没有提示您重新启动系统,请在各连续操作之间重新启动 IBM Installation Manager。
  • ClearQuest Web 服务器升级后,会通知 ClearQuest Web 客户机用户清除其浏览器高速缓存并删除 cookie 和临时因特网文件。清除浏览器将防止发生由基于高速缓存数据(而非 ClearQuest Web 服务器的当前数据)的 ClearQuest 客户机/服务器通信带来的 ClearQuest 问题。

ClearQuest Report Server 和报告功能部件

如果是从 ClearCase V7.1.x 升级到 ClearCase V8.x 或更高版本,请了解包含报告特性的 ClearQuest Web 环境的安装和升级过程方面的变化。

ClearQuest V8.0 引入新的报告策略,这可能影响您的升级过程。如果您的升级计划包括更新或添加 Rational ClearQuest 报告支持,请参阅报告 Rational ClearQuest 数据源以了解有关这些更改的信息。

要点: 如果 ClearQuest 环境包含 Report Launcher 功能部件,那么必须安装 WebSphere Application Server 32 位版本。 在 WebSphere Application Server 64 位版本上不支持这些功能部件。 有关更多信息,请参阅技术说明 1512059

Report Server for Crystal ReportsReport Launcher for ClearQuest Web Server 功能部件与 ClearQuest Web 服务器安装在同一 WebSphere Application Server 应用程序服务器概要文件中。因此,必须在升级 ClearQuest Web 服务器的同时升级报告功能部件。

Full-Text Search Server

在升级支持全文搜索的 ClearQuest Web 环境或对其应用修订包之前,请备份全文搜索配置和数据。根据初始安装全文搜索功能的方式,在升级环境之前可能需要其他任务。

升级 WebSphere Application Server 和 ClearQuest Web 服务器之前,必须备份 Full-Text Search Server 配置和数据。表 2 主题提供不同升级路径的升级过程的概述。要了解更多信息,请参阅设置和配置全文搜索的场景
要点: 如果 ClearQuest 环境包含全文搜索功能部件,那么必须安装 WebSphere Application Server 32 位版本。 在 WebSphere Application Server 64 位版本上不支持这些功能部件。 有关更多信息,请参阅 IBM 支持文章 #1512059
表 2. ClearQuest Full Text Search 升级指示信息(按版本)
ClearQuest 版本 升级概述
ClearQuest V7.1.x 到 V8.0.x
  • 如果您从 DCF 下载 Web 站点下载并安装了 ClearQuest 7.1.x Full Text Search Administrator 工具,那么在升级此功能部件之前,必须移除或重命名 ClearQuest 7.1.x 主目录中的全文搜索脚本 cqtsadmin.plCQTsAdmin 目录。对于标准安装,可在以下缺省目录中找到这些全文搜索资源:
    • Windows: C:\Program Files\IBM\RationalSDLC\ClearQuest\
    • UNIX/Linux:/opt/ibm/RationalSDLC/clearquest/
    重命名该目录后,继续执行 ClearQuest 升级过程。
  • 如果 Full Text Search Administrator 工具未用于原始“全文搜索”部署,请参阅 IBM 支持 Web 站点上的技术说明 #1515900,以获取有关升级 Full Text Search 服务器的信息。
ClearQuest V8.0.0.1 或更高版本到 V8.0.x 在 ClearQuest V8.x 安装过程中,Full Text Search Server 功能部件的软件会复制到 ClearQuest Web 服务器的 WebSphere Application Server 概要文件中。要在升级、移除该功能部件或应用修订包时保留此信息,请使用 ClearQuest cqtsadmin.pl 脚本备份全文搜索配置和数据。升级后,使用 cqtsadmin.pl 脚本复原数据。有关指示信息,请参阅在具有多个 WebSphere 概要文件的全文搜索部署中升级或重新安装 ClearQuest
注: 运行脚本之前,请运行此命令以验证 CQFTS_AppServer_HOME 环境变量是否设置为 WebSphere Application Server 的安装目录。
  • 在 Windows 上:set CQFTS_AppServer_HOME=C:\Program Files\IBM\WebSphere\AppServer
  • 在 Linux 上:setenv CQFTS_AppServer_HOME /opt/IBM/WebSphere/AppServer
如果未设置该值,那么在运行脚本时会显示与下面类似的错误消息:Cannot determine WebSphere’s AppServer home

具有 OSLC 集成的 ClearQuest Web 服务器环境

复审有关升级支持 OSLC 集成的 ClearQuest Web 服务器环境后可能需要的配置任务的信息。

将 ClearQuest 配置为负载均衡的 OSLC 提供程序
在 ClearQuest 8.0.1.1 和更高版本中,可以将负载均衡的 ClearQuest 环境配置为 OSLC 提供程序。有关详细信息,请参阅以下信息:
启用智能卡认证
要包含用于在升级为智能卡认证配置的 ClearQuest Web 部署时对 OSLC 集成启用智能卡认证的功能部件,必须更新和重新部署 ClearQuest Web 部署描述符文件 web.xml。升级 ClearQuest Web 服务器后,请完成此任务。有关指示信息,请参阅为 ClearQuest Web 配置客户机证书认证
解决由于缺少 oslc:versionoslc:domain 参数而导致的 OSLC 链接错误
如果从 V8.0.0.3 或更低版本升级 ClearQuest Web 服务器,那么必须为 ClearQuest V8.0.0.4 中添加的 oslc:versionoslc:domain 参数指定值。升级后,新参数不具有有效值。因此,您在尝试访问 ClearQuest 记录中指向外部 OSLC 资源的链接时可能会遇到 JavaScript 问题。要解决此问题,请在升级到新 ClearQuest Web 服务器版本后更新 OSLC 配置。请参阅更新 OSLC 集成的链接配置

针对 ClearQuest 用户认证将 LDAP 配置更新为 TLS 1.2

更新 ClearQuest 版本和 LDAP 配置,从而为美国国家标准技术学会 (NIST) 专用出版物 (SP) 800-131A 准则添加支持。

ClearQuest V8.0.1.1 为提供有关管理密钥的信息的 NIST SP 800-131A 准则添加支持。 这些准则覆盖以下领域:
  • 密钥管理过程。
  • 如何使用密码算法。
  • 要使用的算法及其最小长度。
  • 安全通信的密钥长度。

要遵守这些准则,您必须使用包含传输层安全性 1.2 协议 (TLS 1.2) 的 LDAP 来认证 ClearQuest 用户。此配置要求更新 LDAP 服务器和 ClearQuest LDAP 配置以支持 TLS 1.2。有关详细信息,请参阅技术说明 1646724


反馈