升級 ClearQuest Web Server 特性:考量事項與最佳作法

當您升級至或移至新的 WebSphere® Application Server 設定檔時,ClearQuest® Web Server、全文檢索及報告特性都安裝在同一個 WebSphere Application Server 設定檔中。 您必須同時升級或移轉這些特性。

在升級或套用修正套件之前,請檢閱會影響 ClearQuest Web Server 特性之升級、配置及管理程序的重要資訊。
重要: 如果 ClearQuest 環境包括「全文檢索」及 Report Launcher 特性,則您必須安裝 WebSphere Application Server 32 位元版本。這些特性在 WebSphere Application Server 64 位元版本上不受支援。如需相關資訊,請參閱 Technote 1512059

請使用這些鏈結或向下捲動頁面,以取得升級 ClearQuest Web Server 特性的相關資訊。

ClearQuest Web Server

表 1 提供 ClearQuest Web Server 升級路徑的概觀。

表 1 主題會依照您正在升級的版本,提供 ClearQuest Web Server 的升級處理程序概觀。
表 1. 依版本指出 ClearQuest Web Server 的升級指示
已安裝的版本 升級概觀
ClearQuest 7.x 版 在 ClearQuest 8.x 版中,WebSphere Application Server 與 ClearQuest Web Server(在 ClearQuest 7.x 版中稱為 ClearQuest CM Server)分開安裝。此分開安裝的作法,能夠在 ClearQuest 環境之外,獨立管理 WebSphere Application Server 及 IBM® HTTP Server 環境。 如果您從 7.x 版進行升級,請使用 IBM Installation Manager 安裝受支援版本的 WebSphere Application Server 及 IBM HTTP Server,然後才升級 ClearQuest 資源。 請參閱準備適用於 ClearCase 及 ClearQuest Web Server 的 WebSphere Application Server 環境
限制: 因為 ClearQuest 7.x 版的應用程式伺服器架構及安裝處理程序與 8.x 版不同,所以如果您是從 7.x 版升級到 8.x 版,則不支援回復作業。若要還原舊版,請移除新版本,然後重新安裝舊版產品。
ClearQuest 8.0 版,使用 WebSphere Application Server 7.0
  1. 將 WebSphere Application Server 升級至 8.0 或 8.5 版。
  2. 將 ClearQuest 升級至 8.0.1 版。
限制: 如果您從 WebSphere Application Server 7.0 上的 ClearQuest 8.0 版部署,升級至 WebSphere Application Server 8.0 上的 ClearQuest 8.0.0.x 版部署,則不支援回復作業。若要還原舊版,請移除新版本,然後重新安裝舊版產品。
ClearQuest 8.0.0.x 版,使用 WebSphere Application Server 8.0 版 WebSphere Application Server 8.0 版及 8.5.0.x 版上支援 ClearQuest 8.0.1 版。當您升級時,您有下列這些選項:
  • 選項 1:將 Rational ClearQuest 升級至 8.0.1 版,而不用升級 WebSphere Application Server。
  • 選項 2:將 WebSphere Application Server 升級至 8.5.0.x 版,然後將 Rational ClearQuest 升級至 8.0.1 版。
如需更詳細的升級指示,包括支援的安裝、升級及回復路徑之相容性矩陣,請參閱 IBM 支援中心網站的 Technote 1634465

升級 ClearQuest Web Server 的重要相關資訊

  • 升級之前,請檢閱「ClearQuest 版本注意事項」,以瞭解與安裝及升級相關的任何已知問題或限制。
  • 在升級程序期間,要置換預設指派的埠號時請務必小心。在升級或安裝作業期間,系統會指派預設埠號以確保每一個埠都是唯一的。例如,如果 WebSphere Application Server 7.x 版設定檔 AppSrv01 的預設埠是埠 9080,當您升級至 8.0.x 版時,指派給 AppSrv01 的預設埠是 9081。如果您置換預設埠號,可能會有埠號衝突的風險。
  • 在 ClearQuest 升級處理程序期間,您不能修改設定檔安全設定。請使用 WebSphere Application Server 主控台來管理 WebSphere Application Server 管理安全。
  • 在連續作業之間,請重新啟動 IBM Installation Manager(如果系統未提示您重新啟動系統的話)。
  • ClearQuest Web 伺服器升級之後,請通知 ClearQuest Web Client 清除其瀏覽器快取,並刪除 Cookie 及網際網路暫存檔。 清除瀏覽器,可避免根據 ClearQuest Web Server 中快取資料(而非現行資料)的 ClearQuest 主從式通訊造成 ClearQuest 問題。

ClearQuest Report Server 與報告特性

若要從 ClearCase V7.1.x 升級為 ClearCase 8.x 版或更新版本,請先瞭解包含報告特性之 ClearQuest Web 環境在安裝及升級程序方面的變更。

ClearQuest 8.0 版引進一項新的產生報告策略,可能會影響您的升級程序。如果您的升級計劃包括更新或新增 Rational ClearQuest 產生報告支援,請參閱報告 Rational ClearQuest 資料來源以取得這些變更的相關資訊。

重要: 如果 ClearQuest 環境包括 Report Launcher 特性,則您必須安裝 WebSphere Application Server 32 位元版本。這些特性在 WebSphere Application Server 64 位元版本上不受支援。如需相關資訊,請參閱 Technote 1512059

Report Server for Crystal ReportsReport Launcher for ClearQuest Web Server 特性,安裝在與 ClearQuest Web Server 相同的 WebSphere Application Server 應用程式伺服器設定檔中。 因此,您必須在升級 ClearQuest Web Server 的同時升級報告特性。

全文檢索伺服器

將修正套件升級或套用至支援全文檢索的 ClearQuest Web 環境之前,請先備份全文檢索配置和資料。 視全文檢索特性最初安裝方式之不同,升級環境時可能需要進行其他作業。

您必須先備份「全文檢索伺服器」配置及資料,然後才能升級 WebSphere Application Server 及 ClearQuest Web Server。 表 2 主題提供不同升級路徑的升級處理程序概觀。如需相關資訊,請參閱設定及配置全文檢索的實務範例
重要: 如果 ClearQuest 環境包括「全文檢索」特性,則您必須安裝 WebSphere Application Server 32 位元版本。這些特性在 WebSphere Application Server 64 位元版本上不受支援。如需相關資訊,請參閱 IBM支援中心文章 #1512059
表 2. 依版本指出 ClearQuest 全文檢索的升級指示
ClearQuest 版本 升級概觀
ClearQuest 7.1.x 版到 8.0.x 版
  • 如果您已從 DCF 下載網站下載並安裝「ClearQuest 7.1.x 全文檢索管理者」工具,請先移除或重新命名全文檢索 Script cqtsadmin.pl 以及 ClearQuest 7.1.x 起始目錄中的 CQTsAdmin 目錄,然後才升級此特性。關於標準安裝,可以在下列預設目錄中找到這些全文檢索資源:
    • Windows:C:\Program Files\IBM\RationalSDLC\ClearQuest\
    • UNIX/Linux:/opt/ibm/RationalSDLC/clearquest/
    重新命名目錄之後,請繼續進行 ClearQuest 升級處理程序。
  • 如果原始全文檢索部署未使用全文檢索管理者工具,請參閱 IBM 支援中心網站上的 Technote # 1515900,以取得升級全文檢索伺服器的相關資訊。
ClearQuest 8.0.0.1 版或更新版本到 8.0.x 版 在 ClearQuest 8.x 版安裝處理程序期間,會將「全文檢索伺服器」特性的軟體複製到 ClearQuest Web Server 的 WebSphere Application Server 設定檔中。 若要在升級、移除特性或套用修正套件時保留這些資訊,請使用 ClearQuest cqtsadmin.pl Script 來備份全文檢索配置和資料。升級之後,請使用 cqtsadmin.pl Script 還原資料。如需相關指示,請參閱使用多個 WebSphere 設定檔在全文檢索部署中升級或重新安裝 ClearQuest
註: 在執行 Script 之前,請先執行此指令,以驗證 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
如果未設定此值,當您在執行 Script 時,便會顯示如下的錯誤訊息:無法判斷 WebSphere AppServer 的起始目錄

ClearQuest Web Server 環境與 OSLC 整合

檢閱您升級支援 OSLC 整合的 ClearQuest Web Server 環境之後,可能需要的配置作業相關資訊。

將 ClearQuest 配置為負載平衡 OSLC 提供者
在 ClearQuest 8.0.1.1 及更新版本中,您可將負載平衡 ClearQuest 環境配置為 OSLC 提供者。如需詳細資料,請參閱下列資訊:
啟用智慧卡鑑別
若要包含為 OSLC 整合啟用智慧卡鑑別的特性,升級為智慧卡鑑別而配置的 ClearQuest Web 部署時,必須更新及重新部署 ClearQuest Web 部署描述子檔案 web.xml。請在升級 ClearQuest Web Server 之後完成此作業。 如需相關指示,請參閱配置 ClearQuest Web 的用戶端憑證鑑別
解析因遺漏 oslc:versionoslc:domain 參數而造成的 OSLC 鏈結錯誤
如果您從 8.0.0.3 版或更舊版本升級 ClearQuest Web Server,則必須指定 oslc:versionoslc:domain 參數的值,這些參數已加入 ClearQuest 8.0.0.4 版。 升級之後,新參數沒有有效的值。 因此,當您嘗試在 ClearQuest 記錄中存取外部 OSLC 資源的鏈結時,可能會遇到 JavaScript 問題。若要解決此問題,請在升級至新版 ClearQuest Web Server 之後更新 OSLC 配置。 請參閱更新 OSLC 整合的鏈結配置

為 ClearQuest 使用者鑑別更新 LDAP 配置至 TLS 1.2

更新 ClearQuest 版本及 LDAP 配置,以新增美國國家標準與技術局(National Institute of Standards and Technology,NIST)特刊 (SP) 800-131A 準則的支援。

ClearQuest 8.0.1.1 版新增了 NIST SP 800-131A 準則的支援,提供管理加密金鑰的相關資訊。 準則包含下列範圍:
  • 金鑰管理程序。
  • 如何使用加密演算法。
  • 要使用的演算法及其基本強度。
  • 安全通訊的金鑰長度。

若要遵守這些準則,您必須為鑑別 ClearQuest 使用者,使用 LDAP 搭配傳輸層安全 1.2 通訊協定 (TLS 1.2)。此配置需要更新 LDAP 伺服器及 ClearQuest LDAP 配置,以支援 TLS 1.2。如需詳細資料,請參閱 Technote 1646724


意見