利用升級 Script,將 Rational Quality Manager 升級至 3.0.1

這個主題說明如何使用 qm_upgrade Script,將 Rational® Quality Manager 第 2 版升級至第 3 版。

開始之前

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

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

重要: 如果要在將「品質管理」和 Jazz™ Team Server 分開安裝的分散式環境中使用升級 Script,升級 Script 必須能夠存取安裝了 Jazz Team Server 的磁碟機或檔案系統。 例如,在 Windows 上,對映格式必須如下:mapped drive letter:\server\conf。 絕對路徑 (\\machine name\installdir\server\conf) 無法運作。 裝載的磁碟機必須以管理帳戶的讀寫執行專用權來配置。

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

如果您是從 iFix02 2.0.1 版或更新的版本升級,在匯出資料之前,請先升級至 2.0.1.1 版或更新的版本。 之後,再執行下列 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 及其他應用程式的關閉時間縮到最短,您可以選擇讓伺服器保持執行中,直到升級 Script 完成將第 2 版資料匯入第 3 版「品質管理 (QM)」資料庫。 這時,您就必須停止 Jazz Team Server。 您可以在 Script 將使用者和授權資料匯入 Jazz Team Server 之後,再重新啟動它。
  5. 將資料庫和 teamserver.properties 檔備份到暫時位置。 依預設,teamserver.properties 檔是在第 2 版的 InstallDir\server\conf\jazz\teamserver.properties 中。如需備份指示,請參閱下列主題:
    • 備份和還原 Derby 資料庫
    • 備份及還原其他受支援的資料庫
    • 備份及還原 Jazz Team Server(以備新增「品質管理」到現有的 Jazz Team Server 中)
  6. 從現有的第 2 版儲存庫匯出資料。
    1. 切換至第 2 版 RQM2InstallDir\server 目錄。
    2. 執行 repotools -export 指令,將檔案儲存在 Rational Quality Manager 目錄結構之外,如下列 2.0.1 版範例所示:

    Windows:repotools -export toFile=c:\tmp\export.tar

    UNIX/Linux:./repotools.sh -export toFile=/tmp/export.tar

    其中 toFile 指定匯出儲存庫時的目標 TAR 檔名稱。

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

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

  8. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  9. 如果您是部署於 WebSphere Application Server,請停止及解除安裝第 2 版 jazz.war 和 help.war 應用程式。
  10. 如果您使用的資料庫並非預設的 Derby 資料庫,請建立第 3 版資料庫。

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

    註: 如果您使用 Oracle 或 SQL Server 資料庫,請務必將資料庫驅動程式複製到正確位置。如需詳細資料,請參閱設定 Oracle 資料庫和設定 SQL Server 資料庫。
  11. 在第 3 版安裝架構中,開啟一個新的指令視窗,導覽至 JazzInstallDir\server,然後執行 upgrade\qm_upgrade.bat Script (Windows) 或 upgrade/qm_upgrade.sh Script(UNIX 系統)。
    註: 您可以在指令行中指定所有引數來執行 Script。 另一種方法是,如果您會重新執行升級 Script 許多次,您也可以編輯 Script 的參數檔,然後執行縮寫的指令行。 請參閱12,以取得參數檔的指示。
    重要: 雖然這個 Script 檔是在 upgrade 目錄之下,但它必須從 server 目錄執行。另外,如果您的路徑包含空格,請務必用雙引號括住它。

    如果您已將 3.0.1 版 Jazz Team Server 與 QM 應用程式安裝在一起,且這是您要升級的第一個或唯一應用程式,指令語法如下:

    Windows:

    upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables

    UNIX/Linux:

    ./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables
    註: -createJTSTables 參數適用於您第一次安裝 Jazz Team Server 3.0.1 的安裝架構。

    如果您將 3.0.1 版 Jazz Team Server 與 QM 應用程式分開安裝,例如在分散式部署中,您必須指定 3.0.1 版 Jazz Team Server 的位置,然後從 QM 3.0.1 安裝目錄執行 Script。 在這個情況下,請併入 -newJTSHome 引數。

    Windows:

    upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -newJTSHome JTS301InstallDir\server\conf

    UNIX/Linux:

    ./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -newJTSHome JTS301InstallDir\server\conf
    註:
    • 如果您有分散式部署,且還沒有配置 Jazz Team Server 3.0.1 版,您可以新增 -createJTSTables 參數到上述指令行範例中。
    • -jtsURL 參數是 Jazz Team Server 的公用 URI。 依預設,Jazz Team Server 公用 URI 是從應用程式的公用 URI 衍生而來。 這個參數必須指定在 Jazz Team Server 與 QM 應用程式分別執行於不同伺服器實例的分散式部署中。
    • 如果 Jazz Team Server 3.0.1 仍在執行中,您必須在 Script 啟動使用者和授權資訊的移轉程序之前,將它停止。 Jazz Team Server 及任何相依於它的應用程式都將會離線。

    如果您需要更多指令行選項的詳細資料,請輸入下列指令:

    Windows:upgrade\qm_upgrade.bat -help

    UNIX/Linux:./upgrade/qm_upgrade.sh -help

    這個 Script 會完成下列作業:

    1. 更新第 3 版配置檔,如下所示:
      • 執行 -migration_qm_updateConfigurationFiles 指令及更新配置和 Tomcat 檔。 請輸入 [E] 來執行指令,輸入 [S] 來跳過步驟,或按一下 [Enter] 鍵來取消執行 Script。
        註: 如果您還沒有安裝 Jazz Team Server3.0.1 版,這時您必須輸入先前在步驟Jazz Team Server 所建立之新 10資料庫的資料庫位置內容;或者,如果您要重複使用 Quality Manager 第 2 版資料庫,請確定資料庫已備份,以備需要重新啟動 Quality Manager 第 2 版伺服器的情況。
        重要: 請勿修改連接資料倉儲資料庫的內容,即使它們目前設為 Derby 也一樣。 請只用伺服器設定精靈來修改這些內容。
      • 順利合併配置檔之後,請輸入 [C],繼續作業。 這時會開啟一個「記事本」視窗(或 AIX 或 Linux 系統的 vi 編輯器),供您驗證 Jazz Team Server teamserver.properties 檔。 請確認 com.ibm.team.repository.server.webapp.url 內容所表示的「公用 URI 根目錄」正確。 另外,也請確認資料庫內容正確。 完成之後,如果有任何變更,請儲存變更,然後關閉編輯器,繼續執行 Script。
      • 複製第 2 版 Tomcat 使用者 xml 檔。
      • 將第 2 版 friendsconfig.rdf 檔與第 3 版合併,這個檔案含有設定要跨儲存庫進行整合的伺服器清單。
      • 將第 2 版 server.xml 和 web.xml(LDAP 設定)的內容,與第 3 版合併
    2. 使用 repotools-jazz -import 指令,將匯出的第 2 版資料,從 TAR 檔匯入到第 3 版「品質管理 (QM)」資料庫。
      註: 匯入「品質管理」3.0.1 的大型儲存庫,可能造成 OutOfMemoryException 錯誤。 有大量專案和構件的客戶應該將 repotools-jazz.bat 或 repotools-jazz.sh Script 中的 -Xmx 參數,從預設值 1500M 增加到較高的值。 如果機器有足夠的記憶體,且在執行 64 位元 OS,建議採用 4096M。
    3. 從「品質管理 (QM)」資料庫中,匯出使用者和授權資料。
    4. 將 QM 使用者和授權資料匯入到 Jazz Team Server 中。
    5. 將使用者對映資料匯入到 QM 資料庫。QM 應用程式會利用對映,來與 Jazz Team Server 資料庫通訊。
    註: 如果要檢視詳細的 Rational Quality Manager 配置檔變更清單,請參閱 Rational Quality Manager 變更
  12. 選用項目:上一步驟還有另一個方式,您可以開啟 Script 的參數檔,修改預設值,然後執行縮寫形式的指令行。

    參數檔的英文和翻譯版是在 JazzInstallDir\server\upgrade\params\qm_params.bat 目錄 (Windows) 或 ./params/qm_params.sh 目錄(UNIX 系統)中。

    1. 如果要取得您的語言的參數檔確切名稱,請從 JazzInstallDir\server\upgrade 目錄中,執行 locale.bat -qm -showParamFileName (Windows) 和 ./locale.sh -qm -showParamFileName(UNIX 系統)。
    2. 開啟 qm_params 或它的翻譯版來進行編輯,指定每個參數的值。 OLD_APPLICATION_HOME 目錄路徑是必須設定的參數之一。 如果您的路徑包含空格,請務必用雙引號括住它。請參閱 JazzInstallDir\server\upgrade\doc\qm_help.txt,以取得每個參數的相關資訊。
  13. 驗證您的配置檔。 如需詳細資料,請參閱在升級期間驗證配置檔和-migration_qm_updateConfigurationFiles。
  14. 如果您已建立安全憑證來搭配舊版使用,請複製舊版中的憑證,或者新建一個。如需詳細資料,請參閱配置安全憑證。
  15. 如果您以 Windows 服務形式來執行 Tomcat 應用程式伺服器,則必須將服務移除再重新安裝。如需指令語法,請參閱以 Windows 服務形式(32 位元)在 Apache Tomcat 中執行。
  16. 如果您是部署在 WebSphere Application Server,請部署 3.0 WAR 檔,並將安全角色對映至使用者或群組。如需詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server和將 CLM 應用程式部署在 WebSphere Application Server 上。
  17. 啟動應用程式伺服器,亦即第 3 版 Jazz Team Server 或 WebSphere Application Server。
    註: 如果個別安裝 QM 應用程式,您也必須啟動 CLM 應用程式。
  18. 配置伺服器及您安裝的任何 CLM 應用程式。

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

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

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

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

下一步

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

意見