手動升級至 Rational Quality Manager 和 Jazz Team Server 3.0.1

這個主題說明將 Rational® Quality Manager 第 2 版升級至第 3 版的手動程序。

開始之前

開始升級之前,請確定已利用「網路時間通訊協定 (NTP)」,將所有機器上的時鐘同步化。 時間是重要的元素,它可讓某個網路節點上的事件,對映到另一個節點上的對應事件。為了避免發生問題,可利用 NTP 服務的企業部署來克服這些挑戰。如需 NTP 的相關資訊,請造訪 http://www.ntp.org/。此外,所有伺服器必須使用相同的鑑別方法來鑑別其使用者。

如果您計劃要升級多個產品,請參閱升級順序,以協助您決定要先升級的產品。

在 WebSphere® Application Server 環境中,建議您將安裝路徑變更為一個沒有包含空格的路徑,例如 C:\IBM\JazzTeamServer。 如果有任何檔名或檔案路徑參數包含空格,您必須用雙引號括住參數。

如果您是從 iFix02 2.0.1 版或更新的版本升級,在匯出資料之前,請先升級至 2.0.1.1 版或更新的版本。 之後,在第 2 版伺服器執行下列 repotools 指令,以防止匯出/匯入程序發生潛在錯誤。

Windows:repotools -repairRequests

UNIX/Linux:./repotools.sh -clean -repairRequests

2.0.1 iFix02 之前各版的使用者可以忽略這個步驟。

程序

  1. 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
  2. 驗證您現有的第 2 版 teamserver.properties 檔中的公用 URL 內容 com.ibm.team.repository.server.webapp.url,以及用來連接資料庫伺服器的資訊,通常是 com.ibm.team.repository.db.vendor、com.ibm.team.repository.db.jdbc.location 和 com.ibm.team.repository.db.jdbc.password。

    在 3.0.1 版中,您必須使用相同的公用 URL。 如果未設定公用 URL,在升級之前,請利用第 2 版管理 Web 介面(進階內容)來設定完整主機名稱 URL (https://hostname.example.com:port)。

    teamserver.properties 中的公用 URL 行應該看起來類似於:
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. 在 Jazz.net,從適當的專案頁面中,下載 Rational Quality Manager 軟體。如需指示,請參閱下載產品安裝媒體。
  4. 停止第 2 版伺服器。
    註: 如果您在分散式環境中作業,且已安裝 Jazz™ Team Server 3.0.1,如果要將 Jazz Team Server 及其他應用程式的關閉時間縮到最短,您可以選擇讓伺服器保持執行中,直到第 2 版資料匯入第 3 版「品質管理 (QM)」資料庫完成。 這時,您就必須停止 Jazz Team Server。 您可以在使用者和授權資料匯入 Jazz Team Server (14) 之後,再重新啟動它。
  5. 將第 2 版資料庫和 teamserver.properties 檔備份到暫時位置。 依預設,teamserver.properties 檔是在第 2 版的 InstallDir\server\conf\jazz\teamserver.properties 中。如需備份指示,請參閱下列主題:
    • 備份和還原 Derby 資料庫
    • 備份及還原其他受支援的資料庫
    • 備份及還原 Jazz Team Server(以備新增「品質管理」到現有的 Jazz Team Server 中)
  6. 使用 repotools -export 指令,從現有第 2 版儲存庫匯出資料,並將檔案儲存在 Rational Quality Manager 目錄結構之外,如下列 2.0.1 版範例所示:
    repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM201\server\conf\jazz\teamserver.properties

    其中 toFile 會指定儲存庫匯出至的 TAR 檔名稱,而 teamserver.properties 則會指定 teamserver.properties 檔的路徑。

    註: 在儲存庫移轉入門和 Repotools 指令行參照中,有 repotools 的詳細使用指示。 請務必使用您現有第 2 版產品隨附的 repotools 版本。
  7. 如果您還沒有安裝 Jazz Team Server,請安裝伺服器、「品質管理」應用程式和「必要基本授權金鑰」到磁碟上的新位置。如果您已安裝伺服器,請安裝「品質管理」應用程式。 如需指示,請參閱利用 IBM Installation Manager 安裝。
    重要: 不同於第 2 版,需求、問題報告和其他工作項目已不再建立於「品質管理」應用程式之內。想利用這些功能的測試團隊,也必須安裝「需求管理」以及「變更與配置管理」。在分散式環境中,可以分別安裝這些應用程式。

    在安裝期間,選取使用 Rational Quality Manager 2.x 環境定義根目錄。這會將 QM 應用程式安裝到環境定義根目錄 /jazz,而非 /qm。保留 QM 構件鏈結需要這個選項。 如果無法選取這個選項,將造成升級失敗。如需詳細資料,請參閱瞭解部署及升級程序。

  8. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  9. 如果您使用的資料庫並非預設的 Derby 資料庫,請建立第 3 版資料庫。

    Jazz Team Server、「品質管理」、「變更與配置管理」和「資料倉儲」都需要資料庫。 您不需要建立「需求管理」的資料庫,因為「需求管理」利用 Jazz Team Server 資料庫作為資料儲存體。 如需每一個資料庫的詳細資料,請參閱設定資料庫中的主題。

    註: 如果您使用 Oracle 或 SQL Server 資料庫,請務必將資料庫驅動程式複製到正確位置。如需詳細資料,請參閱設定 Oracle 資料庫和設定 SQL Server 資料庫。
  10. 在 3.0.1 版 (RQM301InstallDir/server) 中,開啟一個新的指令視窗,輸入 repotools-jazz -migration_qm_updateConfigurationFiles oldApplicationHome=RQM2InstallDir/server/conf,將第 2 版 Jazz 配置檔與第 3 版配置檔合併起來。

    如果您將 3.0.1 版 Jazz Team Server 與 QM 應用程式分開安裝,例如在分散式部署中,請執行下列動作:

    • 在安裝了 Jazz Team Server 的檔案系統中,裝載磁碟機或檔案系統。
    • 在 -migration_qm_updateConfigurationFiles 指令行中,併入 -newJTSHome 引數來指定 3.0.1 Jazz Team Server 的位置。

    這個指令會完成下列作業:

    • 根據第 2 版 Jazz teamserver.properties 檔中的資訊,更新應用程式和 JTS 的第 3 版 teamserver.properties 檔
    • 複製 Tomcat 使用者 XML 檔的內容
    • 複製 friendsconfig.rdf 檔,這個檔案含有設定要跨儲存庫整合的伺服器清單
    • 將第 2 版 server.xml 和 web.xml(LDAP 設定)的內容,與第 3 版合併
  11. 驗證您的配置檔。 如需詳細資料,請參閱在升級期間驗證配置檔和-migration_qm_updateConfigurationFiles。
  12. 如果您是部署於 WebSphere Application Server,請停止及解除安裝第 2 版 jazz.war 和 help.war 應用程式。
  13. 使用 repotools-jazz -import 指令,將 Rational Quality Manager 資料,從匯出的第 2 版儲存庫,匯入到新的第 3 版「品質管理 (QM)」儲存庫,如下列範例所示:
    repotools-jazz -import fromFile=c:\export.tar

    其中 fromFile 指定匯入儲存庫時的來源 TAR 檔名稱。

    註: 匯入「品質管理」3.0.1 的大型儲存庫,可能造成 OutOfMemoryException 錯誤。 有大量專案和構件的客戶應該將 repotools-jazz.bat 或 repotools-jazz.sh Script 中的 -Xmx 參數,從預設值 1500M 增加到較高的值。 如果機器有足夠的記憶體,且在執行 64 位元 OS,建議採用 4096M。
  14. 建立新的 Jazz Team Server (JTS) 資料庫,並從「品質管理」資料庫傳送使用者與授權資料。
    1. 使用下列 repotools-jazz 指令,從「品質管理」應用程式匯出使用者資料:
      repotools-jazz -migration_exportJTSData toFile=jtsData.tar 
    2. 使用下列 repotools-jts 指令,將使用者和授權資料匯入到 Jazz Team Server 資料庫。
      重要: 如果這是 Jazz Team Server 和任何 Collaborative Lifecycle Management 產品的新安裝,repotools-jts 指令可以包含 createTables 參數,這會建立新的 JTS 資料庫。如果已有現有的 JTS 資料庫,請不要在指令行中包含 createTables 參數,因為這會改寫現有的資料庫。
      repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=mapping-qm.txt createTables 
    3. 使用下列 repotools-jazz 指令,將使用者對映資料匯入到 QM 資料庫。QM 應用程式會利用對映,來與 JTS 資料庫通訊。
      repotools-jazz -migration_importUserMapping fromMappingFile=mapping-qm.txt   
  15. 如果您已建立安全憑證來搭配舊版使用,請複製舊版中的憑證,或者新建一個。如需詳細資料,請參閱配置安全憑證。
  16. 如果您以 Windows 服務形式來執行 Tomcat 應用程式伺服器,則必須將服務移除再重新安裝。如需指令語法,請參閱以 Windows 服務形式在 Apache Tomcat 中執行 (32 位元,Rational Quality Manager)。
  17. 如果您是部署在 WebSphere Application Server,請部署 3.0 WAR 檔,並將安全角色對映至使用者或群組。如需詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server和將 CLM 應用程式部署在 WebSphere Application Server 上。
  18. 啟動應用程式伺服器,亦即第 3 版 Jazz Team Server 或 WebSphere Application Server。
  19. 配置伺服器及您安裝的任何 CLM 應用程式。

    如果您要連同「品質管理」或任何 CLM 應用程式來升級 Jazz Team Server,請執行伺服器設定精靈(請參閱執行設定精靈)。 如果您要新增「品質管理」到已建立的 Jazz Team Server 中,請使用管理 Web 介面(請參閱將應用程式登錄於 Jazz Team Server)。

  20. 移至 jazz/admin,並且驗證未發生任何錯誤。
  21. 將您的需求從第 2 版移轉至「需求管理 (RM)」應用程式。如需詳細資料,請參閱移轉工作項目型需求。
    註: 如果您是在 Rational Quality Manager 內部維護您的第 2 版需求,則必須執行這個步驟。如果您使用外部需求提供者,則不需執行這個步驟。
  22. 開啟瀏覽器、清除瀏覽器快取,並重新連接專案。
  23. 升級您的授權。如需簡要概觀,請參閱瞭解授權。然後遵循安裝和管理授權金鑰中的步驟進行。
    註: 第 2 版中的「品質管理員」和「實驗室管理員」授權,在第 3 版中現在稱為「品質專業人員」授權。已沒有另外的「實驗室管理員」授權。第 2 版中的「連結器」授權仍然稱為「連結器」授權,而第 2 版中的「檢視者」授權現在稱為「貢獻者」授權。
  24. 如果您的說明應用程式 (clmhelp.war) 與現行應用程式是在不同的伺服器上,請配置說明的位置。 如需詳細資料,請參閱在分散式環境中配置說明的位置。
  25. 升級儀表板。

    以管理使用者身分登入應用程式,並導覽至任何含有儀表板的頁面。然後按一下移轉,來升級所有的儀表板。

  26. 更新您的報告。
    1. 首先,請移轉第 2 版資料倉儲。如需詳細資料,請參閱從第 2 版移轉報告資料。
    2. 然後,啟動 Rational Team Concert 用戶端,更新為最新的報告範本。如需詳細資料,請參閱更新預先定義的報告範本。
    3. 如果您在第 2 版中使用 Rational Common Reporting,您必須將報告移轉至 Rational Reporting for Development Intelligence。 如需詳細資料,請參閱移轉至 Rational Reporting for Development Intelligence。
  27. 確認升級已完成。如需詳細資料,請參閱驗證升級。

下一步

升級完成之後,請繼續升級之後配置 Jazz Team Server 及第一個應用程式。
註: 如果您是從 Rational Common Reporting 進行移轉,在配置伺服器之前,請先備份您現有的 Rational Common Reporting 資料倉儲資料庫。如需備份指示,請參閱管理資料倉儲的關聯式資料庫管理系統的說明文件。
註: Jazz.net 程式庫中關於升級 Rational Quality Manager 的最新項目
上層主題: 升級 Rational Quality Manager
相關概念:
設定資料庫
授權管理概觀
相關工作:
設定 WebSphere Application Server

意見