升級至 4.0 版

本手冊說明如何將 Rational Team Concert 3.0 或 Collaborative Lifecycle Management (CLM) 3.0.1 版伺服器應用程式升級至 CLM 4.0 版。

附註:從第 2 版至第 4 版的升級程序包含兩個步驟。您必須先將伺服器升級至 3.0.1 版,然後再升級至 4.0 版。如需從第 2 版升級至 3.0.1 版的相關指示,請參閱 3.0.1 資訊中心。

如需在 z/OS 上升級 CLM 應用程式的相關資訊,請參閱 z/OS 上升級的特殊指示。

選取最能說明您安裝環境的選項

選擇一或多個要升級的應用程式:
已升級 Jazz Team Server 了嗎?
選擇您的部署拓蹼:
選擇您應用程式伺服器的作業系統:
選擇您的應用程式伺服器:
選擇您的資料庫伺服器:
選擇您是否已在 CLM 3.0.1 中配置資料倉儲:
選擇是否與其他產品整合:

根據您在上一頁中所做的下列配置,本手冊產生了您產品升級的完整指示:

重要事項:

規劃核對清單

在您升級 Rational Collaborative Lifecycle Management 產品解決方案之前,請務必檢閱下列規劃核對清單中的資訊。

  規劃作業 其他資訊
使用升級資料表:升級資料表可用來協助收集及記錄升級程序期間所需的特定資料片段。這些包括升級和配置部署時所需的 URL、使用者 ID 及其他元素等項目。 升級資料表
驗證您的軟硬體符合最低系統需求:4.0 版會有一些新的需求,例如:只支援 64 位元伺服器作業系統。按一下右側鏈結以瞭解這些新需求,及查看您的現行系統是否符合最低系統需求。 系統需求
取得產品安裝媒體:如果是本端儲存庫下載,您需要大約 5 GB 的硬碟空間,以便下載及解壓縮您的產品安裝媒體。 伺服器安裝檔案可以從 jazz.net 下載
檢閱升級拓蹼範例 分散式企業拓蹼範例
將所有機器上的時鐘同步化:在分散式環境中,請確定已利用「網路時間通訊協定 (NTP)」,將所有機器上的時鐘同步化。 如需 NTP 的相關資訊,請造訪 ntp.org
瞭解部署和升級程序:請參閱這個主題,以瞭解升級程序,瞭解限制和考量,以及升級每一個應用程式所需要的預估時間。 瞭解部署及升級程序
規劃讓您的應用程式離線:請規劃在您備份每一個項目,並將應用程式升級至 4.0 版時,讓您的應用程式有一小段時間離線。當 Jazz Team Server 離線時,所有連接到 Jazz Team Server 的應用程式都會離線。另外,也請準備一些時間來執行現有應用程式的完整備份。  
知道您的資料庫必要條件:
  • 您具備第 3 版資料庫的存取權,並且可以複製 derby/repositoryDB 目錄。
  • 您具有正確的使用者名稱與密碼。
    • 在 UNIX 系統中,取得 DB2 實例擁有者的密碼,通常是 db2inst1 使用者。
  • 在啟動升級程序之前,需要先備份資料庫。
  • 您具有正確的使用者名稱與密碼。
  • 在啟動升級程序之前,需要先備份資料庫。請參閱資料庫供應商說明文件,取得備份資料庫的相關資訊。
  • Rational CLM 解決方案 4.0 不再支援 JRE 5.0。支援的 JRE 版本是 6.0 及 7.0。ojdbc5.jar 類別庫需要 JRE 5.0,ojdbc6.jar 類別庫需要 JRE 6.0 或更新版本。您必須使用 ojdbc6.jar。
  • 建立名為 ORACLE_JDBC_DRIVER_FILE 的環境變數並指向 ojdbc6.jar JDBC 驅動程式。
  • 您具有正確的使用者名稱與密碼。
  • 在啟動升級程序之前,需要先備份資料庫。請參閱資料庫供應商說明文件,取得備份資料庫的相關資訊。
  • 已安裝「Java 資料庫連線功能 (JDBC)」驅動程式。Rational CLM 解決方案 4.0 不再支援 JRE 5.0。支援的 JRE 版本是 6.0 及 7.0。sqljdbc4.jar 類別庫需要 JRE 6.0 或更新的版本。您必須使用 sqljdbc4.jar。
  • SQL 服務已啟動。
瞭解授權。您必須購買新的第 4 版授權。第 4 版授權相容於第 3 版應用程式,但是第 4 版應用程式不會與第 3 版授權搭配運作。 管理授權
檢查瀏覽器相容性:
  • 如果要容許精靈顯示出來,請在 Web 瀏覽器中啟用 JavaScript。
  • 針對用於移轉的 Web 瀏覽器,請確定已停用快顯封鎖程式。
 

[選用] 為升級程序建立暫置測試環境

在升級您的正式作業環境之前,請先設定測試環境,來避免問題。如需相關資訊,請參閱為升級程序建立暫置測試環境。

要求伺服器重設

指向位於 https://qualified.host.name:port/jts/admin?internal#action=com.ibm.team.repository.admin.serverReset 的 3.0.1 Jazz Team Server 管理網站,並按一下要求伺服器重設。

指向位於 https://qualified.host.name:port/ccm/admin?internal#action=com.ibm.team.repository.admin.serverReset 的 3.0.1「變更與配置管理」管理網站,並按一下要求伺服器重設。

指向位於 https://qualified.host.name:port/qm/admin?internal#action=com.ibm.team.repository.admin.serverReset 的 3.0.1「品質管理」管理網站,並按一下要求伺服器重設。

記錄伺服器名稱、節點名稱和所安裝的 3.0.1 應用程式名稱

  1. 登入 WebSphere Application Server Integrated Solutions Console。
  2. 展開伺服器 > 伺服器類型,然後選取 WebSphere Application Server。
  3. 記錄伺服器名稱和節點名稱。
  4. 展開應用程式 > 應用程式類型,然後選取 WebSphere Enterprise Application。
  5. 記錄下列已安裝的應用程式名稱:
    • Jazz Team Server
    • CLMHelp
    • 變更與配置管理
    • 品質管理
    • 需求管理
    • 轉換器

升級 Rational Reporting for Development Intelligence (RRDI)

附註:在升級 Rational Collaborative Lifecycle Management 解決方案之前,您必須先升級 Rational Reporting for Development Intelligence。資料倉儲不需要隨 Rational Reporting for Development Intelligence 一起升級,因為它們會在 Rational CLM 解決方案升級期間升級。

如果您具有 Rational Reporting for Development Intelligence 1.0.2 版,並且想升級至 2.0 版,請遵循下列步驟:

  1. 備份 Rational Reporting for Development Intelligence 1.0.2 安裝。如需相關資訊,請參閱備份 Rational Reporting for Development Intelligence 1.0.2.x 的檔案。
  2. 解除安裝 Rational Reporting for Development Intelligence 1.0.2 和 WebSphere Application Server。
  3. 安裝 Rational Reporting for Development Intelligence 2.0。
  4. 安裝 WebSphere Application Server。
  5. 執行設定應用程式,來配置 Rational Reporting for Development Intelligence。
  6. 配置和測試報告伺服器。
  7. 執行現有的報告與儀表板來測試 Java ETL 工作的執行,以驗證沒有回歸。

如需相關資訊,請參閱將 Rational Reporting for Development Intelligence 從 1.0.2.x 版升級至 2.0 版。

升級至 Rational CLM 4.0 解決方案之後,請下載最新報告範例和資源,並將它們載入報告伺服器中。如需完整指示,請參閱升級報告構件。

安裝 CLM 4.0

安裝 CLM 4.0 應用程式,但是不要執行安裝精靈。若為分散式配置,請對應於您已安裝的 3.0.1 應用程式來安裝 CLM 4.0 應用程式。如需安裝伺服器的相關資訊,請參閱使用 IBM Installation Manager 來安裝。

安裝 CLM 4.0 應用程式,但是不要執行安裝精靈。若為分散式配置,請對應於您已安裝的 3.0.1 應用程式來安裝 CLM 4.0 應用程式。如需安裝伺服器的相關資訊,請參閱使用授權程式來安裝在 IBM i 上。

附註:必須一律先升級 Jazz Team Server。在分散式環境中,請務必先安裝第 4 版授權,再安裝其他的 CLM 應用程式。如需相關資訊,請參閱「啟動試用或安裝第 4 版授權」步驟。

備份 WebSphere Application Server 設定檔

如果要備份 WebSphere Application Server 設定檔,請移至每一部應用程式伺服器,並執行下列步驟。
  1. 開啟命令提示字元,切換至 WebSphere Application Server 安裝目錄的 bin 資料夾。例如,C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin。
  2. 執行下列指令。請注意,若有開啟 WebSphere Application Server 安全,您也必須提供使用者名稱與密碼:
  3. backupConfig.bat用來建立設定檔 WAS 主要管理使用者名稱和 WAS 管理密碼備份的新建壓縮檔路徑 (例如 backupConfig.bat C:\WAS_backup\clm_301_profile.zip -username WAS admin -password WAS admin password)

    附註:目錄必須事先存在。

    提示:必要的話,執行 restoreConfig.bat 指令即可還原已備份的設定檔。例如, restoreConfig.bat C:\WAS_backup\clm_301_profile.zip。

  1. 開啟命令提示字元,切換至 WebSphere Application Server 安裝目錄的 bin 資料夾。例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin。
  2. 執行下列指令。請注意,若有開啟 WebSphere Application Server 安全,您也必須提供使用者名稱與密碼:
  3. ./backupConfig.sh 用來建立設定檔 WAS 主要管理使用者名稱和 WAS 管理密碼備份的新建壓縮檔路徑 (例如,./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS admin -password WAS admin password)

    附註:目錄和 .zip 檔案必須事先存在。

    提示: 必要的話,執行 ./restoreConfig.sh 指令即可還原已備份的設定檔。例如, ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip。

  1. 開啟命令提示字元,切換至 WebSphere Application Server 安裝目錄的 bin 資料夾。例如,/usr/IBM/WebSphere/AppServer/profiles/AppSrv01/bin。
  2. 執行下列指令。請注意,若有開啟 WebSphere Application Server 安全,您也必須提供使用者名稱與密碼:
  3. ./backupConfig.sh 用來建立設定檔 WAS 主要管理使用者名稱和 WAS 管理密碼備份的新建壓縮檔路徑 (例如,./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS admin -password WAS admin password)

    附註:目錄和 .zip 檔案必須事先存在。

    提示: 必要的話,執行 ./restoreConfig.sh 指令即可還原已備份的設定檔。例如, ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip。

從 WebSphere Application Server 解除安裝 3.0.1 應用程式

如果要解除安裝 3.0.1 應用程式 WAR 檔,請移至每一部應用程式伺服器,並執行下列步驟。
  1. 登入 WebSphere Application Server Integrated Solutions Console,網址是 https://hostname:9043/ibm/console/logon.jsp。
  2. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式。
  3. 寫下以下 3.0.1 應用程式的安全角色對映,協助您針對 4.0 的對應部分來進行重新對映:
    • jts_war
    • ccm_war
    • qm_war
  4. 停止並解除安裝下列 3.0.1 應用程式:
    • jts_war
    • clmhelp_war
    • admin_war
    • ccm_war
    • qm_war
    • rm_war
    • converter_war
  5. 出現提示時,將變更儲存至主要配置。

更新 JAZZ_HOME 及 log4j.configuration 自訂內容

在每一部應用程式伺服器上執行下列步驟。
  1. 登入 WebSphere Application Server Integrated Solutions Console,網址是 https://hostname:9043/ibm/console/logon.jsp。
  2. 按一下伺服器 > 伺服器類型 > Websphere Application Server。
  3. 按一下伺服器名稱來開啟它。預設伺服器名稱是 server1。
  4. 在「伺服器基礎架構」區段之下,按一下 Java 和程序管理 > 程序定義。
  5. 在「其他內容」之下,按一下 Java 虛擬機器。
  6. 在「其他內容」之下,按一下自訂內容。
  7. 按一下 JAZZ_HOME,將值更新為 file:///4.0_install_dir/server/conf。例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0/server/conf。
  8. 按一下 JAZZ_HOME,將值更新為 file:///4.0_install_dir/server/conf。例如,file:///opt/IBM/JazzTeamServer_4.0/server/conf。
  9. 按一下 JAZZ_HOME,將值更新為 file:///4.0_install_dir/server/conf。例如,file:///usr/IBM/JazzTeamServer_4.0/server/conf。
  10. 按一下 log4j.configuration,將值更新為 file:///4.0_install_dir/server/conf/startup_log4j.properties。例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0/server/conf/startup.log4j.properties。
  11. 按一下 log4j.properties,將值更新為 file:///4.0_install_dir/server/conf/startup_log4j.properties。例如,file:///opt/IBM/JazzTeamServer_4.0/server/conf/startup_log4j.properties。
  12. 按一下 log4j.properties,將值更新為 file:///4.0_install_dir/server/conf/startup_log4j.properties。例如,file:///usr/IBM/JazzTeamServer_4.0/server/conf/startup_log4j.properties。
  13. 如果您連接 Oracle 資料庫,請確定 ORACLE_JDBC_DRIVER_FILE 指向正確的 JDBC 驅動程式檔案。
  14. 如果您連接 SQL Server 資料庫,請確定 SQLSERVER_JDBC_DRIVER_FILE 指向正確的 JDBC 驅動程式檔案。
  15. 出現提示時,將變更儲存至主要配置。

附註:如需詳細資訊,請參閱設定 WebSphere Application Server。

停止 WebSphere Application Server

如果要停止 WebSphere Application Server,請移至每一部伺服器,並執行下列步驟。
  1. 開啟命令提示字元,切換至 WAS_profile_root\bin 目錄。
  2. 輸入下列指令:
  3. stopServer.bat server1 -user admin_userid -password admin_password

  1. 開啟命令提示字元,切換至 WAS_profile_root/bin 目錄。
  2. 輸入下列指令:
  3. ./stopServer.sh server1 -user admin_userid -password admin_password

清除 WebSphere Application Server 暫存目錄

移至每一部應用程式伺服器,並從設定檔的下列 wscache 和 temp 目錄中移除 CLM 相關內容。視先前安裝的應用程式而定,設定檔之下會有下列目錄,並且可以移除:
在設定檔中,從下列 wscache 和 temp 目錄中移除 CLM 相關內容。視先前安裝的應用程式而定,設定檔之下會有下列目錄,並且可以移除:
  • jts_war
  • ccm_war
  • qm_war
  • rm_war
  • converter_war
  • admin_war
  • clmhelp_war

WAS_profile_root\wscache(例如 C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
WAS_profile_root\temp(例如:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)

WAS_profile_root/wscache(例如 opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS_profile_root/temp(例如:opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)

WAS_profile_root/wscache(例如 usr/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS_profile_root/temp(例如:usr/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)

清除日誌目錄

移至每一部應用程式伺服器,並從設定檔的日誌目錄中移除 CLM 相關日誌。
從設定檔的日誌目錄中移除 CLM 相關的日誌。

WAS_profile_root\logs(例如:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs)

WAS_profile_root/logs(例如:opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)

WAS_profile_root/logs(例如:usr/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)

停止伺服器

停止所有 3.0.1 應用程式伺服器。

  1. 開啟命令提示字元,切換至 3.0.1_install_dir\server 目錄。
  2. 輸入下列指令:
  3. server.shutdown.bat

  1. 開啟命令提示字元,切換至 3.0.1_install_dir/server 目錄。
  2. 輸入下列指令:
  3. ./server.shutdown.sh

從 3.0.1 安裝目錄複製 Derby 資料庫

開啟命令提示字元,輸入下列指令來清除預設 4.0 Derby repositoryDB 目錄。

del /s /f 4.0_install_dir\server\conf\jts\derby\repositoryDB
del /s /f 4.0_install_dir\server\conf\jts\derby\warehouseDB
del /s /f 4.0_install_dir\server\conf\ccm\derby\repositoryDB
del /s /f 4.0_install_dir\server\conf\qm\derby\repositoryDB
rm -rf 4.0_install_dir/server/conf/jts/derby/repositoryDB
rm -rf 4.0_install_dir/server/conf/jts/derby/warehouseDB
rm -rf 4.0_install_dir/server/conf/ccm/derby/repositoryDB
rm -rf 4.0_install_dir/server/conf/qm/derby/repositoryDB

開啟命令提示字元,輸入下列指令將 Derby DB 從 3.0.1 複製到 4.0。

附註:下面指令假設您使用套裝產品隨附的 Derby DB。如果您已變更 Derby DB 位置,則應該更新指令來改用您現有的 3.0.1 DB 位置。

xcopy /s 3.0.1_install_dir\server\conf\jts\derby\repositoryDB 4.0_install_dir\server\conf\jts\derby\repositoryDB
xcopy /s 3.0.1_install_dir\server\conf\jts\derby\warehouseDB 4.0_install_dir\server\conf\jts\derby\warehouseDB
xcopy /s 3.0.1_install_dir\server\conf\ccm\derby\repositoryDB 4.0_install_dir\server\conf\ccm\derby\repositoryDB
xcopy /s 3.0.1_install_dir\server\conf\qm\derby\repositoryDB 4.0_install_dir\server\conf\qm\derby\repositoryDB
cp -R 3.0.1_install_dir/server/conf/jts/derby/repositoryDB 4.0_install_dir/server/conf/jts/derby/repositoryDB
cp -R 3.0.1_install_dir/server/conf/jts/derby/warehouseDB 4.0_install_dir/server/conf/jts/derby/warehouseDB
cp -R 3.0.1_install_dir/server/conf/ccm/derby/repositoryDB 4.0_install_dir/server/conf/ccm/derby/repositoryDB
cp -R 3.0.1_install_dir/server/conf/qm/derby/repositoryDB 4.0_install_dir/server/conf/qm/derby/repositoryDB

備份資料庫

備份您的 DB2 資料庫,包括資料倉儲資料庫在內。如需備份 DB2 資料庫的相關資訊,請參閱備份及還原 DB2 資料庫。

備份您的 Oracle 資料庫,包括資料倉儲資料庫在內。如需備份資料庫的指示,請參閱 Oracle 說明文件。

備份您的 SQL Server 資料庫,包括資料倉儲資料庫在內。如需備份資料庫的指示,請參閱 SQL Server 說明文件。

驗證索引位置

在開始升級之前,請遵循這些步驟,以驗證應用程式內容檔中的索引位置是指向檔案系統上的絕對路徑,而不是相對路徑。

  1. 在 Jazz Team Server 方面,請移至 JTS_3.0.1_install_dir/server/jts,開啟 temserver.properties 檔來編輯。
  2. 在變更及配置管理應用程式方面,請移至 CCM_3.0.1_install_dir/server/ccm,開啟 temserver.properties 檔來編輯。
  3. 在品質管理應用程式方面,請移至 QM_3.0.1_install_dir/server/qm,開啟 temserver.properties 檔來編輯。
  4. 搜尋 com.ibm.team.fulltext.indexlocation 一行。
  5. 如果位置是相對路徑,索引位置將相對於管理應用程式的 WebSphere Application Server 設定檔。請將位置變更為絕對路徑:
    • 在 Jazz Team Server 方面, 請輸入 com.ibm.team.fulltext.indexLocation=WAS_Install_Dir/IBM/WebSphere/appServer/profiles/Appsrv01/conf/jts/indices/workitemindex, 其中 WAS_Install_Dir 是 WebSphere Application Server 安裝目錄, Appsrv01 是應用程式伺服器設定檔名稱。
    • 在變更及配置管理應用程式方面, 請輸入 com.ibm.team.fulltext.indexLocation=WAS_Install_Dir/IBM/WebSphere/appServer/profiles/Appsrv01/conf/ccm/indices/workitemindex, 其中 WAS_Install_Dir 是 WebSphere Application Server 安裝目錄,Appsrv01 是應用程式伺服器設定檔名稱。
    • 在品質管理應用程式方面, 請輸入 com.ibm.team.fulltext.indexLocation=WAS_Install_Dir/IBM/WebSphere/appServer/profiles/Appsrv01/conf/qm/indices/workitemindex, 其中 WAS_Install_Dir 是 WebSphere Application Server 安裝目錄,Appsrv01 是應用程式伺服器設定檔名稱。
  6. 在升級期間,於合併內容之後,Script 會開啟 4.0 teamserver.properties 檔,並可讓您預覽內容。此時,請將索引檔的位置切換到磁碟機上固定位置的絕對路徑。固定位置是指不會因為應用程式解除安裝而遭到刪除的目錄。絕對固定位置應類似如下:
    • com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex, 其中 JTS_4.0_install_dir 是 Jazz Team Server 應用程式 4.0 的安裝位置。
    • com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex, 其中 CCM_4.0_install_dir 是「變更及配置管理」應用程式 4.0 的安裝位置。
    • com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex, 其中 QM_4.0_install_dir 是「品質管理」應用程式 4.0 的安裝位置。
    然後,Script 會將索引從 3.x 複製到新的 4.0 固定目錄。

執行儲存庫工具指令 upgrade

如果要升級 Jazz Team Server 配置檔,請移至 4.0JTS_install_dir/server,並執行下列指令:

repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf

repotools-jts.bat -addTables

repotools-jts.bat -upgradeWarehouse

repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf updateTomcatFiles=no

repotools-jts.bat -addTables

repotools-jts.bat -upgradeWarehouse

./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf

./repotools-jts.sh -addTables

./repotools-jts.sh -upgradeWarehouse

./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf updateTomcatFiles=no

./repotools-jts.sh -addTables

./repotools-jts.sh -upgradeWarehouse

如果要升級「變更與配置管理」應用程式配置檔,請移至 4.0CCM_install_dir/server,並執行下列指令:

預設應用程式環境定義根目錄是 jazz。如果升級路徑是源自 3.x 版,請在該指令中使用 applicationContextRoot=ccm 切換參數。

repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm

repotools-ccm.bat -addTables

repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no

repotools-ccm.bat -addTables

./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm

./repotools-ccm.sh -addTables

./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no

./repotools-ccm.sh -addTables

如果要升級「品質管理」應用程式配置檔,請移至 4.0QM_install_dir/server,並執行下列指令:

預設應用程式環境定義根目錄是 jazz。如果升級路徑是源自 3.x 版,請在該指令中使用 applicationContextRoot=qm 切換參數。

repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm

repotools-qm.bat -addTables

repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no

repotools-qm.bat -addTables

./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm

./repotools-qm.sh -addTables

./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no

./repotools-qm.sh -addTables

如果要升級「需求管理」應用程式配置檔,請遵循下列步驟:

  1. 移至已安裝「需求管理」應用程式(包括舊版本和 4.0 版)的實體機器。
  2. 將 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的內容複製到可攜式磁碟機上的兩個不同目錄。
  3. 移至已安裝 Jazz Team Server 4.0 的實體機器,並將可攜式磁碟機的內容複製到暫存目錄。每一個 RM 版本都應該有一個目錄。例如,C:\Temp\RM4.0 和 C:\Temp\RM3.0.1。
  4. 開啟命令提示字元,並將目錄切換至 C:\Temp\RM4.0\server,然後執行下列指令:

    upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome 3.0.1JTS_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf applicationContextRoot=rm

    預設應用程式環境定義根目錄是 rdm。如果升級路徑是源自 3.x 版,請在該指令中使用 applicationContextRoot=rm 切換參數。

  5. 在 JTS 機器上完成升級之後,請將 C:\Temp\RM4.0 的內容複製到可攜式磁碟機。
  6. 移至已安裝「需求管理」應用程式的實體機器,並將可攜式磁碟機的內容貼到 4.0RM_install_dir/server 目錄來改寫現有內容。
  1. 移至已安裝「需求管理」應用程式(包括舊版本和 4.0 版)的實體機器。
  2. 將 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的內容複製到可攜式磁碟機上的兩個不同目錄。
  3. 移至已安裝 Jazz Team Server 4.0 的實體機器,並將可攜式磁碟機的內容複製到暫存目錄。每一個 RM 版本都應該有一個目錄。例如,C:\Temp\RM4.0 和 C:\Temp\RM3.0.1。
  4. 開啟命令提示字元,並將目錄切換至 C:\Temp\RM4.0\server,然後執行下列指令:

    upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome 3.0.1JTS_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf -updateTomcatFiles=no applicationContextRoot=rm

    預設應用程式環境定義根目錄是 rdm。如果升級路徑是源自 3.x 版,請在該指令中使用 applicationContextRoot=rm 切換參數。

  5. 在 JTS 機器上完成升級之後,請將 C:\Temp\RM4.0 的內容複製到可攜式磁碟機。
  6. 移至已安裝「需求管理」應用程式的實體機器,並將可攜式磁碟機的內容貼到 4.0RM_install_dir/server 目錄來改寫現有內容。
  1. 移至已安裝「需求管理」應用程式(包括舊版本和 4.0 版)的實體機器。
  2. 將 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的內容複製到可攜式磁碟機上的兩個不同目錄。
  3. 移至已安裝 Jazz Team Server 4.0 的實體機器,並將可攜式磁碟機的內容複製到暫存目錄。每一個 RM 版本都應該有一個目錄。例如 opt/tmp/rm4.0 和 opt/tmp/rm3.0.1。
  4. 開啟指令 Shell,並將目錄切換至 opt/tmp/rm4.0/server,然後執行下列指令:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome 3.0.1JTS_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf applicationContextRoot=rm

    預設應用程式環境定義根目錄是 rdm。如果升級路徑是源自 3.x 版,請在該指令中使用 applicationContextRoot=rm 切換參數。

  5. 在 JTS 機器上完成升級之後,請將 opt/tmp/rm4.0 的內容複製到可攜式磁碟機。
  6. 移至已安裝「需求管理」應用程式的實體機器,並將可攜式磁碟機的內容貼到 4.0RM_install_dir/server 目錄來改寫現有內容。
  1. 移至已安裝「需求管理」應用程式(包括舊版本和 4.0 版)的實體機器。
  2. 將 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的內容複製到可攜式磁碟機上的兩個不同目錄。
  3. 移至已安裝 Jazz Team Server 4.0 的實體機器,並將可攜式磁碟機的內容複製到暫存目錄。每一個 RM 版本都應該有一個目錄。例如 opt/tmp/rm4.0 和 opt/tmp/rm3.0.1。
  4. 開啟指令 Shell,並將目錄切換至 opt/tmp/rm4.0/server,然後執行下列指令:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome 3.0.1JTS_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf -updateTomcatFiles=no applicationContextRoot=rm

    預設應用程式環境定義根目錄是 rdm。如果升級路徑是源自 3.x 版,請在該指令中使用 applicationContextRoot=rm 切換參數。

  5. 在 JTS 機器上完成升級之後,請將 opt/tmp/rm4.0 的內容複製到可攜式磁碟機。
  6. 移至已安裝「需求管理」應用程式的實體機器,並將可攜式磁碟機的內容貼到 4.0RM_install_dir/server 目錄來改寫現有內容。

上述指令執行下列作業:

  • 根據 3.0.1 版檔案中的資訊來更新第 4 版的 teamserver.properties 檔。
  • 將表格新增至資料庫。
  • 升級資料倉儲綱目。
  • 複製 Tomcat 使用者 XML 檔的內容。

    記住:僅適用於 Tomcat 使用者資料庫。會複製 tomcat-users.xml 檔(不會與現有的檔案合併)。 如果您升級具有共同 JTS 的多個 CLM 應用程式,您必須在 tomcat-users.xml 檔中,手動合併使用者和群組資訊。 如果使用者在不同應用程式中,屬於不同的群組,使用者和群組資訊就會不同。 例如,userA 在 CCM 中有 JazzAdmins 角色,在 QM 中有 JazzUsers 角色。 另外,如果某些使用者只出現在一個應用程式中,未出現在另一個應用程式中(反之亦然),就必須將他們手動新增到 tomcat-users.xml 檔中。

  • 將 3.0.1 版 server.xml 和 web.xml 檔的內容,與第 4 版合併。
  • 將 3.0.1 版 fronting.properties 檔的內容複製到第 4 版。
  • 將 3.0.1 版 friendsconfig.rdf 檔的內容複製到第 4 版。

如需這些「儲存庫工具」指令的相關資訊,請參閱:

執行升級 Script

重要事項:雖然 Script 檔位於 upgrade/應用程式環境定義根目錄目錄之下,但必須從 server 目錄執行。另外,如果您的路徑包含空格,請務必用雙引號括住路徑名稱。

附註:如果要在 CLM 應用程式和 Jazz Team Server 分開安裝的分散式環境中使用升級 Script,升級 Script 必須能夠存取已安裝此應用程式的磁碟機或檔案系統。例如,在 Windows 上,裝載必須為此格式:mounted drive letter:\server\conf。絕對路徑無效,例如 \\machine name\JTS40InstallDir\server\conf。裝載的磁碟機必須以管理者帳戶的讀寫執行專用權來配置。

如果要升級 Jazz Team Server,請開啟命令提示字元,移至 JTS_4.0_install_dir\server 目錄, 並執行下列指令:

upgrade\jts\jts_upgrade.bat

upgrade\jts\jts_upgrade.bat -oldJTSHome JTS_3.0.1_install_dir\server\conf

在升級期間,於配置檔合併之後,會開啟「記事本」視窗,供您驗證 Jazz Team Server 的 teamserver.properties 檔。如果 com.ibm.team.fulltext.indexlocation 內容的位置是相對路徑,則不需要變更路徑。如果位置是絕對路徑, 請確定目錄是固定的,不會因解除安裝而遭到刪除。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex, 其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安裝位置。

如果要升級「變更與配置管理」應用程式,請開啟命令提示字元,移至 CCM_4.0_install_dir\server 目錄, 並執行下列指令:

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf

在升級期間,於配置檔合併之後,會開啟「記事本」視窗,供您驗證「變更與配置」的 teamserver.properties 檔。如果位置是絕對路徑, 請確定目錄是固定的,不會因解除安裝而遭到刪除。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex, 其中 CCM_4.0_install_dir 是「變更及配置」應用程式 4.0 的安裝位置。

如果要升級「品質管理」應用程式,請開啟命令提示字元,移至 QM_4.0_install_dir\server 目錄, 並執行下列指令:

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf

在升級期間,於配置檔合併之後,會開啟「記事本」視窗,供您驗證「品質管理」的 teamserver.properties 檔。如果位置是絕對路徑, 請確定目錄是固定的,不會因解除安裝而遭到刪除。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex, 其中 QM_4.0_install_dir 是「品質管理」應用程式 4.0 的安裝位置。

如果要升級「需求管理」應用程式,請開啟命令提示字元,移至 RM_4.0_install_dir\server 目錄,並執行下列指令:

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -oldJTSHome JTS_3.0.1_install_dir\server\conf

如果要升級 Jazz Team Server,請開啟指令 Shell,移至 JTS_4.0_install_dir/server 目錄,並執行下列指令:

upgrade/jts/jts_upgrade.sh

upgrade/jts/jts_upgrade.sh -oldJTSHome JTS_3.0.1_install_dir/server/conf

在升級期間,於配置檔合併之後,會開啟 vi 編輯器,供您驗證 Jazz Team Server 的 teamserver.properties 檔。如果位置是絕對路徑, 請確定目錄是固定的,不會因解除安裝而遭到刪除。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex, 其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安裝位置。

如果要升級「變更與配置管理」應用程式,請開啟指令 Shell,移至 CCM_4.0_install_dir/server 目錄,並執行下列指令:

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf

在升級期間,於配置檔合併之後,會開啟 vi 編輯器,供您驗證「變更與配置管理」的 teamserver.properties 檔。如果位置是絕對路徑, 請確定目錄是固定的,不會因解除安裝而遭到刪除。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex, 其中 CCM_4.0_install_dir 是「變更及配置」應用程式 4.0 的安裝位置。

如果要升級「品質管理」應用程式,請開啟指令 Shell,移至 QM_4.0_install_dir/server 目錄,並執行下列指令:

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf

在升級期間,於配置檔合併之後,會開啟 vi 編輯器,供您驗證「品質管理」的 teamserver.properties 檔。如果位置是絕對路徑, 請確定目錄是固定的,不會因解除安裝而遭到刪除。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex, 其中 QM_4.0_install_dir 是「品質管理」應用程式 4.0 的安裝位置。

如果要升級「需求管理」應用程式,請開啟指令 Shell,移至 RM_4.0_install_dir/server 目錄,並執行下列指令:

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -oldJTSHome JTS_3.0.1_install_dir/server/conf

如果要升級 Jazz Team Server,請開啟命令提示字元,移至 JTS_4.0_install_dir\server 目錄, 並執行下列指令:

upgrade\jts\jts_upgrade.bat -updateTomcatFiles=no

upgrade\jts\jts_upgrade.bat -oldJTSHome JTS_3.0.1_install_dir\server\conf -updateTomcatFiles=no

在升級期間,於配置檔合併之後,會開啟「記事本」視窗,供您驗證 Jazz Team Server 的 teamserver.properties 檔。如果在這個檔案中, com.ibm.team.fulltext.indexlocation property 的位置是一個相對路徑, 您必須將它變更為絕對路徑,並確定特定目錄是固定的, 且不會因解除安裝而遭到刪除。3.0.1_install_dir 為不固定目錄的範例,它可能會被解除安裝,而讓您失去索引檔。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex, 其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安裝位置。

如果要升級「變更與配置管理」應用程式,請開啟命令提示字元,移至 CCM_4.0_install_dir\server 目錄, 並執行下列指令:

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -updateTomcatFiles=no

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -updateTomcatFiles=no

在升級期間,於配置檔合併之後,會開啟「記事本」視窗, 供您驗證「變更與配置」應用程式的 teamserver.properties 檔。如果在這個檔案中, com.ibm.team.fulltext.indexlocation property 的位置是一個相對路徑, 您必須將它變更為絕對路徑,並確定特定目錄是固定的, 且不會因解除安裝而遭到刪除。3.0.1_install_dir 為不固定目錄的範例,它可能會被解除安裝,而讓您失去索引檔。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex, 其中 CCM_4.0_install_dir 是「變更及配置管理」應用程式 4.0 的安裝位置。

如果要升級「品質管理」應用程式,請開啟命令提示字元,移至 QM_4.0_install_dir\server 目錄, 並執行下列指令:

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -updateTomcatFiles=no

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf -updateTomcatFiles=no

在升級期間,於配置檔合併之後,會開啟「記事本」視窗,供您驗證「品質管理」應用程式的 teamserver.properties 檔。如果在這個檔案中, com.ibm.team.fulltext.indexlocation property 的位置是一個相對路徑, 您必須將它變更為絕對路徑,並確定特定目錄是固定的, 且不會因解除安裝而遭到刪除。3.0.1_install_dir 為不固定目錄的範例,它可能會被解除安裝,而讓您失去索引檔。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex, 其中 QM_4.0_install_dir 是「品質管理」應用程式 4.0 的安裝位置。

如果要升級「需求管理」應用程式,請開啟命令提示字元,移至 4.0RM_install_dir\server 目錄,並執行下列指令:

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -updateTomcatFiles=no

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -oldJTSHome JTS_3.0.1_install_dir\server\conf -updateTomcatFiles=no

如果要升級 Jazz Team Server,請開啟指令 Shell,移至 JTS_4.0_install_dir/server 目錄,並執行下列指令:

upgrade/jts/jts_upgrade.sh -updateTomcatFiles=no

upgrade/jts/jts_upgrade.sh -oldJTSHome JTS_3.0.1_install_dir/server/conf -updateTomcatFiles=no

在升級期間,於配置檔合併之後,會開啟 vi 編輯器,供您驗證 Jazz Team Server 的 teamserver.properties 檔。如果在這個檔案中, com.ibm.team.fulltext.indexlocation property 的位置是一個相對路徑, 您必須將它變更為絕對路徑,並確定特定目錄是固定的, 且不會因解除安裝而遭到刪除。3.0.1_install_dir 為不固定目錄的範例,它可能會被解除安裝,而讓您失去索引檔。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex, 其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安裝位置。

如果要升級「變更與配置管理」應用程式,請開啟指令 Shell,移至 4.0CCM_install_dir/server 目錄,並執行下列指令:

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -updateTomcatFiles=no

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -updateTomcatFiles=no

在升級期間,於配置檔合併之後,會開啟 vi 編輯器,供您驗證「變更與配置管理」應用程式的 teamserver.properties 檔。如果在這個檔案中, com.ibm.team.fulltext.indexlocation property 的位置是一個相對路徑, 您必須將它變更為絕對路徑,並確定特定目錄是固定的, 且不會因解除安裝而遭到刪除。3.0.1_install_dir 為不固定目錄的範例,它可能會被解除安裝,而讓您失去索引檔。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex, 其中 CCM_4.0_install_dir 是「變更及配置管理」應用程式 4.0 的安裝位置。

如果要升級「品質管理」應用程式,請開啟指令 Shell,移至 QM_4.0_install_dir/server 目錄,並執行下列指令:

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -updateTomcatFiles=no

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -updateTomcatFiles=no

在升級期間,於配置檔合併之後,會開啟 vi 編輯器,供您驗證「品質管理」應用程式的 teamserver.properties 檔。如果在這個檔案中, com.ibm.team.fulltext.indexlocation property 的位置是一個相對路徑, 您必須將它變更為絕對路徑,並確定特定目錄是固定的, 且不會因解除安裝而遭到刪除。3.0.1_install_dir 為不固定目錄的範例,它可能會被解除安裝,而讓您失去索引檔。絕對固定位置應類似如下:com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex, 其中 QM_4.0_install_dir 是「品質管理」應用程式 4.0 的安裝位置。

如果要升級「需求管理」應用程式,請開啟指令 Shell,移至 RM_4.0_install_dir/server 目錄,並執行下列指令:

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -updateTomcatFiles=no

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -oldJTSHome JTS_3.0.1_install_dir/server/conf -updateTomcatFiles=no

上述 Script 使用「儲存庫工具」指令來更新配置檔,並將資料庫和資料倉儲綱目更新為 4.0 版。如需相關資訊,請參閱升級 Script 檔。

在 IBM i 上執行升級 Script

  1. 使用具備 QSECOFR 權限的使用者 ID 登入 IBM i 作業系統。
  2. 在 QShell 中,導覽至 Jazz Team Server 4.0 安裝目錄 /QIBM/UserData/JazzTeamServer40/server。
  3. 輸入下列指令來升級 Jazz Team Server:

    upgrade/jts/jts_upgrade.sh -oldJTSHome /QIBM/UserData/JazzTeamServer301/server/conf -oldJTSVersion 3.0.1

  4. 輸入下列指令來升級「變更與配置管理」應用程式:

    upgrade/ccm/ccm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  5. 輸入下列指令來升級「品質管理」應用程式:

    upgrade/qm/qm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  6. 輸入下列指令來升級「需求管理」應用程式:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  7. 執行下列指令來更新 3.0.1 WebSphere Application Server,以及部署 CLM 4.0 的 .war 檔。這個 Script 也會執行備份、更新 JVM 設定、更新環境變數設定、刪除暫存目錄,並重新啟動伺服器:

     

    upgrade/was_upgrade.sh profileName serverName nodeName wasVersion wasOption maxHeapSize adminId adminPwd jvmVersion jazzAppName jtsAppName clmHelpAppName qmAppName rmAppName adminAppName

    其中:

    • profileName 是 3.0.1 設定檔名稱。
    • serverName 是 3.0.1 伺服器名稱。
    • nodeName 是 3.0.1 伺服器節點名稱。
    • wasVersion 是 WebSphere Application Server 版本(第 7 版或第 8 版)。
    • wasOption 是您針對 IBM i 上的 Jazz Team Server 3.0.1 選擇的 WebSphere Application Server 選項(Base、ND 或 Express)。
    • maxHeapSize 是應用程式伺服器所需要的資料堆大小上限。
    • adminId 和 adminPwd 是您在 IBM i 上用來維護 WebSphere Application Server 安全的 ID 和密碼。
    • jvmVersion 是 Java 虛擬機器 (JVM) 版本(若為 V6R1 /V7R1,則為 std64)。
    • jazzAppName 是「變更與配置管理」應用程式的名稱。
    • jtsAppName 是 Jazz Team Server 的名稱。
    • qmAppName 是「品質管理」應用程式的名稱。
    • rmAppName 是「需求管理」應用程式的名稱。
    • clmHelpAppName 是 CLM 說明應用程式的名稱。
    • adminAppName 是「生命週期專案管理」應用程式的名稱。

複製索引檔

重要事項:唯有當 teamserver.properties 檔中的索引檔位置是相對路徑,或是不固定目錄的絕對路徑時,才執行這些步驟。3.0.1_install_dir 為不固定目錄的範例,它可能會被解除安裝,而讓您失去索引檔。

將 JFS/文字索引從 3.0.1 複製到 4.0。若為分散式系統,請移至適當的伺服器來複製檔案。

  1. 開啟命令提示字元,輸入下列指令來清除預設 4.0 索引目錄:
  2. Del /s /f JTS_4.0_install_dir\server\conf\jts\indices
    Del /s /f CCM_4.0_install_dir\server\conf\ccm\indices
    Del /s /f QM_4.0_install_dir\server\conf\qm\indices
    rm -rf JTS_4.0_install_dir/server/conf/jts/indices
    rm -rf CCM_4.0_install_dir/server/conf/ccm/indices
    rm -rf QM_4.0_install_dir/server/conf/qm/indices
  3. 開啟命令提示字元,輸入下列指令將索引從 3.0.1 複製到 4.0
  4. copy JTS_3.0.1_install_dir\server\conf\jts\indices JTS_4.0_install_dir\server\conf\jts\indices
    copy CCM_3.0.1_index_location\server\conf\ccm\indices CCM_4.0_install_dir\server\conf\ccm\indices
    copy QM_3.0.1_index_location\server\conf\qm\indices QM_4.0_install_dir\server\conf\qm\indices
    cp -R JTS_3.0.1_index_location/server/conf/jts/indices JTS_4.0_install_dir/server/conf/jts/indices
    cp -R CCM_3.0.1_index_location/server/conf/ccm/indices CCM_4.0_install_dir/server/conf/ccm/indices
    cp -R QM_3.0.1_index_location/server/conf/qm/indices QM_4.0_install_dir/server/conf/qm/indices

如果要將 JFS/文字索引從 3.0.1 複製到 4.0,請遵循這些步驟。若為分散式系統,請移至適當的伺服器來複製檔案。

  1. 開啟命令提示字元,輸入下列指令來清除預設 4.0 索引目錄:
  2. Del /s /f JTS_4.0_install_dir\server\conf\jts\indices
    Del /s /f CCM_4.0_install_dir\server\conf\ccm\indices
    Del /s /f QM_4.0_install_dir\server\conf\qm\indices
    rm -rf JTS_4.0_install_dir/server/conf/jts/indices
    rm -rf CCM_4.0_install_dir/server/conf/ccm/indices
    rm -rf QM_4.0_install_dir/server/conf/qm/indices
  3. 開啟每一個應用程式的 teamserver.properties 檔,並搜尋 com.ibm.team.fulltext.indexlocation。
  4. 如果 com.ibm.team.fulltext.indexlocation 內容指向相對路徑, 如 com.ibm.team.fulltext.indexLocation=conf/ccm/indices/workitemindex, 全文索引位置將相對於管理應用程式的 WebSphere Application Server 設定檔。例如, WAS_Install_Dir/IBM/WebSphere/AppServer/profiles/Appsrv01。在 CLM 4.0 應用程式的 teamserver.properties 檔中, 將這個相對路徑變更為固定位置的絕對路徑。舉例來說,絕對的固定位置類似如下:com.ibm.team.fulltext.indexLocation=4.0_install_dir/server/conf/ccm/indices/workitemindex, 其中 4.0_install_dir 是 CLM 4.0 應用程式的安裝位置。開啟命令提示字元,輸入下列指令,將全文索引從 3.0.1 複製到 4.0。
  5. copy WAS_profile_dir\conf\jts\indices JTS_4.0_install_dir\server\conf\jts\indices
    copy WAS_profile_dir\conf\ccm\indices CCM_4.0_install_dir\server\conf\ccm\indices
    copy WAS_profile_dir\conf\qm\indices QM_4.0_install_dir\server\conf\qm\indices
    cp -R WAS_profile_dir/conf/jts/indices JTS_4.0_install_dir/server/conf/jts/indices
    cp -R WAS_profile_dir/conf/ccm/indices CCM_4.0_install_dir/server/conf/ccm/indices
    cp -R WAS_profile_dir/conf/qm/indices QM_4.0_install_dir/server/conf/qm/indices
  6. 如果 com.ibm.team.fulltext.indexlocation 內容指向不固定的絕對路徑, 例如可能解除安裝和刪除的 3.0.1_install_dir 目錄, 請將它變更為固定位置的絕對路徑。舉例來說,絕對的固定位置類似如下:com.ibm.team.fulltext.indexLocation=4.0_install_dir/server/conf/ccm/indices/workitemindex, 其中 4.0_install_dir 是 CLM 4.0 應用程式的安裝位置。開啟命令提示字元,輸入下列指令,將全文索引從 3.0.1 複製到 4.0。
  7. copy JTS_3.0.1_install_dir\server\conf\jts\indices 4.0_install_dir\server\conf\jts\indices
    copy CCM_3.0.1_install_dir\server\conf\ccm\indices 4.0_install_dir\server\conf\ccm\indices
    copy QM_3.0.1_install_dir\server\conf\qm\indices 4.0_install_dir\server\conf\qm\indices
    cp -R JTS_3.0.1_install_dir/server/conf/jts/indices 4.0_install_dir/server/conf/jts/indices
    cp -R CCM_3.0.1_install_dir/server/conf/ccm/indices 4.0_install_dir/server/conf/ccm/indices
    cp -R QM_3.0.1_install_dir/server/conf/qm/indices 4.0_install_dir/server/conf/qm/indices
  8. 開啟命令提示字元,輸入下列指令,將 JFS 索引從 3.0.1 複製到 4.0。
  9. copy JTS_3.0.1_install_dir\server\conf\jts\indices JTS_4.0_install_dir\server\conf\jts\indices
    copy CCM_3.0.1_install_dir\server\conf\ccm\indices CCM_4.0_install_dir\server\conf\ccm\indices
    copy QM_3.0.1_install_dir\server\conf\qm\indices QM_4.0_install_dir\server\conf\qm\indices
    cp -R JTS_3.0.1_install_dir/server/conf/jts/indices JTS_4.0_install_dir/server/conf/jts/indices
    cp -R CCM_3.0.1_install_dir/server/conf/ccm/indices CCM_4.0_install_dir/server/conf/ccm/indices
    cp -R QM_3.0.1_install_dir/server/conf/qm/indices QM_4.0_install_dir/server/conf/qm/indices

啟動 WebSphere Application Server

如果要啟動 WebSphere Application Server,請移至每一部伺服器,並執行下列步驟:

附註:請確定您已將 JDBC 環境變數切換成指向 JRE6 JDBC 驅動程式。如需相關資訊,請參閱設定 Oracle 資料庫。

附註:請確定您已將 JDBC 環境變數切換成指向 JRE6 JDBC 驅動程式。如需相關資訊,請參閱設定 SQL Server 資料庫。

  1. 開啟命令提示字元,切換至 WAS_profile_root\bin 目錄。
  2. 輸入下列指令:
  3. startServer.bat server1 -user admin_userid -password admin_password

  1. 開啟命令提示字元,切換至 WAS_profile_root/bin 目錄。
  2. 輸入下列指令:
  3. ./startServer.sh server1 -user admin_userid -password admin_password

在 WebSphere Application Server 中部署 4.0 WAR 檔

如果要部署 4.0 應用程式 WAR 檔,請移至每一個應用程式伺服器,並執行下列步驟:

附註:如果您使用 IBM Installation Manager 來安裝 CLM 應用程式,且在安裝期間清除 Tomcat 7 Application Server 的勾選框,依預設,Web 應用程式檔案 (.war) 會複製到 JazzInstallDir/server/webapps 目錄。在安裝期間,如果您選取 Tomcat 7 Application Server,則 Web 應用程式檔案 (.war) 會複製到 JazzInstallDir/server/tomcat/webapps 目錄。

  1. 登入 WebSphere Application Server Integrated Solutions Console,網址是 https://hostname.example.com:9043/ibm/console/logon.jsp。
  2. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式。
  3. 安裝下列 Web 應用程式檔案:
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • converter_war
    • clmhelp_war
    • admin_war
  4. 適當地對映下列應用程式的安全角色:
    • jts_war
    • ccm_war
    • qm_war

如需詳細資訊,請參閱在 WebSphere Application Server 上部署 CLM 應用程式。

重要事項:如果您的環境不支援轉換器,例如 AIX 或 Solaris,您必須在專用的轉換器上安裝 4.0 版的 converter.war。如需詳細資訊,請參閱 Rational Requirements Composer 轉換器應用程式安裝。

啟動應用程式

在「企業應用程式」頁面中,啟動下列應用程式:
登入每一部應用程式伺服器的「整合解決方案主控台」,並啟動下列應用程式:
  • jts_war
  • ccm_war
  • qm_war
  • rm_war
  • converter_war
  • admin_war
  • clmhelp_war

啟動伺服器

附註:請確定您已將 JDBC 環境變數切換成指向 JRE6 JDBC 驅動程式。如需相關資訊,請參閱設定 Oracle 資料庫。

附註:請確定您已將 JDBC 環境變數切換成指向 JRE6 JDBC 驅動程式。如需相關資訊,請參閱設定 SQL Server 資料庫。

啟動所有 4.0 應用程式伺服器

  1. 開啟命令提示字元,切換至 4.0_install_dir\server 目錄。
  2. 輸入下列指令:
  3. server.startup.bat

  1. 開啟命令提示字元,切換至 4.0_install_dir/server 目錄。
  2. 輸入下列指令:
  3. ./server.startup.sh

啟動試用或安裝第 4 版授權

您必須購買新的 4.0 版授權。第 4 版授權相容於第 3 版應用程式,但是第 4 版應用程式不會與第 3 版授權搭配運作。若有使用其第 3 版對應項目,請安裝 4.0 版浮動、記號或「授權使用者單一安裝」的授權。在安裝第 4 版授權期間,會保留您現有的第 3 版使用者授權指派。

如果您尚未購買第 4 版授權,則可以啟動試用軟體授權,並在有限的時間內使用。如果要啟動試用軟體授權,請遵循下列步驟:

  1. 以管理者身分登入 4.0 Jazz Team Server。https://host.example.com:9443/jts/admin
  2. 按一下伺服器 > 授權金鑰管理。
  3. 按一下啟動試用,以啟動試用軟體授權。

附註:如果您使用試用軟體授權,在執行下一步驟「移轉 Rational Requirements Composer」之前,必須將試用軟體授權指派給執行 RRC 升級的 admin 使用者。

如需授權的相關資訊,請參閱管理授權。

移轉 Rational Requirements Composer

附註:自您重新啟動 Requirements Composer 應用程式開始,直到完成線上移轉精靈為止,在這段期間,Requirements Composer 升級至 4.0 版的程序會讓 Jazz Team Server 進入唯讀模式。

  1. 開啟瀏覽器,清除瀏覽器快取,然後導覽至 Requirements Manager Web 用戶端 。在下列 URL 中指定伺服器名稱和埠:https://hostname.example.com:port/rm/web/projects/migration。預設埠是 9443。這個頁面偵測到移轉在進行中,並啟動「移轉」精靈。
  2. 接受「Rational Requirements Composer - 分析師用戶端存取」授權。
  3. 在升級精靈中,按一下開啟升級服務畫面,再按下一步,開始執行 Rational Requirements Composer 升級。升級進行期間,移轉網頁上會將狀態報告給管理者,指出正在處理哪個儲存區以及何時開始編製索引。

    重要事項:升級開始之後,您就無法取消這項作業,必須等到升級完成。

  4. 升級完成之後,會重新編製 Rational Requirements Composer 資料的索引。
  5. 重新編製索引完成之後,應用程式會對移轉資料執行驗證和一致性檢查,並提供意見給管理者。 這時會顯示「升級完成」訊息。按一下關閉。您會重新導向至 Rational Requirements Composer 應用程式。
  6. 在啟動伺服器之後,請執行 Publish Service Initialize,網址是: https://[hostname.example.com]:9443/[application context root]/publish/initialize。

配置資料倉儲

如果您在 CLM 3.0.1 安裝中跳過配置資料倉儲,而想在 4.0 中配置資料倉儲,請遵循下列步驟:

  1. 建立資料庫來作為您的資料倉儲。如需相關資訊,請參閱設定資料庫。
  2. 執行安裝精靈,跳到配置資料倉儲步驟,然後配置資料倉儲。如需相關資訊,請參閱配置資料倉儲。

    附註:設定 4.0 伺服器時,並不需要執行安裝精靈,只有當您在 CLM 3.0.1 中跳過配置資料倉儲時,才會用到該精靈來配置。

驗證核對清單

完成升級程序之後,請使用下列核對清單,來判斷一切是否執行順利。

  驗證作業 其他資訊
驗證已將下列應用程式配置檔從 3.0.1 版複製到 4.0 版:
  • Jazz Team Server:[4.0_install_dir]/server/conf/jts/teamserver.properties
  • 「變更與配置管理」應用程式:[4.0_install_dir]/server/conf/ccm/teamserver.properties
  • 「品質管理」應用程式:[4.0_install_dir]/server/conf/qm/teamserver.properties
  • 「生命週期專案管理」應用程式:[4.0_install_dir]/server/conf/admin/admin.properties
  • 「生命週期專案管理」應用程式:[4.0_install_dir]/server/conf/admin/friends.rdf
  • 「需求管理」應用程式:[4.0_install_dir]/server/conf/rm/friendsconfig.rdf
  • 「需求管理」應用程式:[4.0_install_dir]/server/conf/rm/fronting.properties
 
驗證每一個 teamserver.properties 檔都包含下列資訊:
  • 複製自 3.0.1 版 teamserver.properties 的內容
  • 有效的特殊公用 URL com.ibm.team.repository.server.webapp.url(第 4 版應用程式的 URL 必須與第 3 版所用的 URL 相同)
  • 有效的資料庫供應商項目(確定 /conf/jts/teamserver.properties 所指定的資料庫存在)
 
驗證應用程式伺服器:
  • 驗證 [4.0_install_dir]/server/tomcat/conf/tomcat-users.xml 含有 3.0.1 版中的資訊。
  • 如果您使用 LDAP 登錄,或已停用 HTTPS 或 FORM 鑑別,請驗證 [4.0_install_dir]/server/tomcat/conf/server.xml 含有下列程式碼 Snippet:

    <Realm className="org.apache.catalina.realm.JNDIRealm"
    ...>
    </Realm>

    並且不包含下列程式碼 Snippet:

    Realm className="org.apache.catalina.realm.UserDatabaseRealm"
    resourceName="UserDatabase"
    ...>
    </Realm>

    附註: 如果在 [3.0.1_install_dir]/server/tomcat/conf/server.xml 檔中自訂了其他設定,請驗證已將它們複製到 [4.0_install_dir]/server/tomcat/conf/server.xml。

  • 驗證 web.xml 檔有正確的 <security-role> 標籤:
    • Jazz Team Server:[4.0_install_dir]/server/tomcat/webapps/jts/WEB-INF/web.xml
    • 「變更與配置管理」應用程式:[4.0_install_dir]/server/tomcat/webapps/ccm/WEB-INF/web.xml
    • 「品質管理」應用程式:[4.0_install_dir]/server/tomcat/webapps/qm/WEB-INF/web.xml
    • 「需求管理」應用程式:[4.0_install_dir]/server/tomcat/webapps/rm/WEB-INF/web.xml
    • 「生命週期專案管理」應用程式:[4.0_install_dir]/server/tomcat/webapps/admin/WEB-INF/web.xml
  • 請確定已部署和啟動下列應用程式:
    • jts.war
    • ccm.war
    • qm.war
    • rm.war
    • converter.war
    • admin.war
    • clmhelp.war
部署和啟動伺服器
驗證伺服器日誌:檢查下列伺服器日誌,驗證其中有後置升級資訊:
  • 如果您使用 Tomcat 伺服器,則日誌檔位於 [4.0_install_dir]/server/logs 目錄中。
  • 如果您使用 WebSphere Application Server,則日誌檔位於 [WAS_install_dir]/profiles/AppSrv01/logs 目錄中。
 
驗證公用 URL:如果您已將 Jazz Team Server、「變更與配置管理」或「品質管理」應用程式升級,請驗證應用程式狀態摘要頁面中的公用 URL 與舊版所用者相同。  
驗證 Jazz Team Server 管理 Web 介面中的鏈結: 請開啟 Web 瀏覽器,移至 Jazz Team Server 的「管理」頁面 (https://[hostname.example.com]:9443/jts/admin),並且驗證沒有顯示錯誤。 Jazz Team Server 管理 Web 介面
驗證應用程式管理 Web 介面中的鏈結: 請開啟 Web 瀏覽器,移至應用程式的「管理」頁面 (https://[hostname.example.com]:9443/[application context root]/admin),並且驗證沒有顯示錯誤。 應用程式管理 Web 介面
驗證使用者、授權和鏈結構件:
  • 檢查使用者和授權
  • 驗證鏈結的構件
  • 驗證 Web 用戶端
  • 使用搜尋來驗證檢索
  • 驗證 Rational Team Concert 或 Visual Studio 用戶端
驗證使用者、授權和鏈結構件

與其他產品整合

Rational Developer for System z

Rational Developer for System z 在 System z 上與 Rational Team Concert 整合,為 z/OS 開發人員提供一個整合的協同應用程式開發環境。這個整合性解決方案的價值在於提供有 Rational Developer for System z 的個別開發環境,以及 Rational Team Concert 的團隊協同作業功能。如需相關資訊,請參閱 Rational Team Concert 及 Rational Developer for System z。


Rational ClearQuest

Rational Team Concert 中有數個工具可以協助您整合您的工作與 Rational ClearQuest、Rational ClearQuest Synchronizer、Rational ClearQuest Bridge 及 Rational ClearQuest Importer。如需相關資訊,請參閱 Rational Team Concert 及 Rational ClearQuest。

您可以使用 ClearQuest Synchronizer(舊稱為 Connector)來整合 Rational Quality Manager 與 Rational ClearQuest 問題報告追蹤系統。如需相關資訊,請參閱 Rational Quality Manager 及 Rational ClearQuest。

您可以整合 Rational Requirements Composer 與 Rational ClearQuest,並配置應用程式將需求與問題報告、作業、加強功能要求及其他記錄類型產生關聯。如需相關資訊,請參閱 Rational Requirements Composer 及 Rational ClearQuest。


Rational ClearCase

Rational Team Concert 包含的 ClearCase Connector 支援 Rational Team Concert 與 Rational ClearCase 之間的作業。如需相關資訊,請參閱 Rational Team Concert 及 Rational ClearCase。


Rational Build Forge

Rational Team Concert 與 Rational Build Forge 之間的整合可讓您建立 Rational Build Forge 建置引擎和定義,以便與 Build Forge 專案整合。如需相關資訊,請參閱 Rational Team Concert 及 Rational Build Forge。


Hudson

Rational Team Concert 與 Hudson 之間的整合可讓您建立 Hudson 建置引擎和定義,以便與 Hudson 專案整合。如需相關資訊,請參閱 Rational Team Concert 及 Hudson。


Subversion

Rational Team Concert 提供數個方法,協助團隊利用 Subversion 及 Rational Team Concert 來源控制進行協同作業。如需相關資訊,請參閱 Rational Team Concert 及 Subversion。


Rational DOORS

您可以使用 Rational DOORS 來管理需求,也可以使用 Rational Team Concert 工作項目功能將這些需求置於變更控制下。如需相關資訊,請參閱 Rational Team Concert 及 Rational DOORS。

您可以整合 Rational Quality Manager 與 Rational DOORS,將 Rational DOORS 中的需求與測試計劃或測試案例建立關聯及進行追蹤。如需相關資訊,請參閱 Rational Quality Manager 及 Rational DOORS。


Rational Focal Point

您可以使用 Rational Focal Point 來擷取商業需求並設定優先順序,然後將這些需求當作專案匯出到 Rational Team Concert 中。如需相關資訊,請參閱 Rational Team Concert 及 Rational Focal Point。


Lotus Connections

Rational Team Concert 提供的 Lotus Connections 整合可以將「變更與配置管理」資源及構件,連接到 Lotus Connections 社群資源和構件。如需相關資訊,請參閱 Rational Team Concert 及 Lotus Connections。


Rational Developer for Power Systems Software

Rational Team Concert 與 Rational Developer for Power Systems Software 整合,為 IBM i 開發人員提供一個整合的協同應用程式開發環境。這個整合性解決方案的價值在於 Rational Team Concert 的團隊協同作業功能,以及 Rational Developer for Power Systems Software 的個別開發環境。如需相關資訊,請參閱 Rational Team Concert 及 Rational Developer for Power Systems Software。


Rational RequisitePro

透過 Rational Quality Manager 與 Rational RequisitePro 之間的整合,您可以從 Rational RequisitePro 新增需求視圖和套件,以在「品質管理」應用程式中測試計劃。如需相關資訊,請參閱 Rational Quality Manager 及 Rational RequisitePro。


Rational Change

您可以使用 IBM Rational Change Open Services for Lifecycle Collaboration Change Management (OSLC-CM) API 來提交新的變更要求,並直接從「品質管理」Web 介面將執行結果鏈結到這些變更要求。如需相關資訊,請參閱 Rational Quality Manager 及 Rational Change。


Rational 測試工具

您可以使用 Rational Quality Manager 來執行測試實驗機器上或共用網路位置上的自動化測試。如需相關資訊,請參閱 Rational Quality Manager 及 Rational 測試工具。


Selenium

與 Selenium 的整合是利用 JUnit Selenium 配接器來實作,這可讓您在「品質管理」應用程式中執行 Selenium 2.0 版 WebDriver JUnit4 測試。如需相關資訊,請參閱 Rational Quality Manager 及 Selenium。


軟體庫存與自動化工具

您可以整合 Rational Quality Manager 與軟體庫存和自動化工具,例如 Rational Build Forge、Software Testing Automation Framework (STAF) 及 Software Testing Automation Framework Execution Engine (STAX)。如需相關資訊,請參閱 Rational Quality Manager 及軟體庫存與自動化工具。


Rational Software Architect Design Manager

重要事項:設計管理被視為測試版功能,僅供評估之用。如需相關資訊,請參閱 Jazz.net 的「設計管理」專案。

您可以整合 IBM Rational Software Architect Design Manager 與 Rational Collaborative Lifecycle Management (CLM) 解決方案中的「需求管理 (RM)」及「變更與配置管理 (CCM)」應用程式。您可以使用此整合,將設計模型和模型資源鏈結至需求、需求相關構件、工作項目,以及其他開發構件。如需相關資訊,請參閱 Rational Requirements Composer 及 Rational Software Architect Design Manager。