升級至 3.0.1 版修正套件版次

請利用這個主題來將您現有的 Rational® CLM 解決方案產品升級至 3.0.1 版修正套件版次。

開始之前

重要:
  • 在下面的範例中,3.0.1 是指安裝 3.0.1 版伺服器的目錄,3.0.1.x 是指安裝新的 3.0.1.x 版修正套件(3.0.1.1 或更高的版本)伺服器的目錄。
  • 所有範例都是針對 Linux。您必須針對 Windows 或其他作業系統,做對應的修改。
  • 3.0.1 到 3.0.1 修正套件版次的升級程序使用現有的 CLM 資料庫。addTables 和 createWarehouse 指令會將這些資料庫升級為 3.0.1.x 格式。
  • 如果您已經將所有 Jazz™ 應用程式安裝在相同的應用程式伺服器上, 您必須同時將所有的應用程式升級為 3.0.1 修正套件。如果您將每一個應用程式部署在個別的應用程式伺服器中,則可以獨立升級應用程式。
  • 請勿執行 jts/setup。所有項目都已設定。請使用 jts/admin 來檢視或變更設定。
  • 提供使用升級封套 Script 以及手動執行升級的指示。
上層主題: 升級 Jazz Team Server 和 CLM 應用程式

從第 2 版升級

關於這項作業

從第 2 版升級至 3.0.1 修正套件版次的指示,與從第 2 版升級至 3.0.1 版相同。如需詳細資料,請參閱升級至 Rational CLM 解決方案。

從使用 Tomcat 的 3.0.1 版升級

程序

  1. 安裝 CLM 3.0.1.x。請勿執行設定。 若為分散式配置,請安裝與已安裝的 3.0.1 應用程式相對應的 CLM 3.0.1.x 應用程式。
    註: 您必須一律先升級 Jazz Team Server。
  2. 停止 3.0.1 伺服器。
  3. 如果使用 Derby,請將 Derby DB 從 3.0.1 移至 3.0.1.x:
    cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
    cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
    cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
  4. 如果使用 DB2®、Oracle 或 SQL Server,請備份資料庫。
  5. 如果使用升級封套 Script,請跳至步驟 11
  6. 保留您的 3.0.1 使用者登錄檔案。
    1. 如果使用 Tomcat 使用者登錄,請保留您的 3.0.1 tomcat-users.xml 和 server.xml 檔:
      cp <3.0.1_install_dir>/server/tomcat/conf/tomcat-users.xml  <3.0.1.x_install_dir>/server/tomcat/conf/tomcat-users.xml
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xml
    2. 如果使用 LDAP 使用者登錄,請在適當地應用程式伺服器上,保留您的 3.0.1 server.xml 和 web.xml 檔案:
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xmlcp <3.0.1_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml
  7. 將您的 JFS/text 索引從 3.0.1 複製到 3.0.1.x。(若為分散式系統,請移至適當的伺服器來複製檔案。)
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  8. 將您的應用程式配置檔從 3.0.1 複製到 3.0.1.x。(若為分散式系統,請移至適當的伺服器來複製檔案。)
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  9. 執行 repotools -addTables 指令以確保資料庫具備正確的表格。(若為分散式系統,請至適當的伺服器並執行 repotools 指令。)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  10. 如果您已配置資料倉儲,請執行 repotools-jts -createWarehouse 指令,將資料倉儲綱目更新至 3.0.1.x。
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  11. 如果使用升級封套 Script,請切換至 <3.0.1.x_install_dir>/server 目錄。
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  12. 啟動伺服器。
  13. 必要的話,請啟動 3.0.1.x 授權。例如,若為里程碑版本,您必須啟動里程碑隨附的「早期存取授權」。如果是 3.0.1.x 最終版本,您可以繼續使用您的 3.0.1 授權。
    1. 以管理者身分登入 3.0.1.x Jazz Team Server。
    2. 導覽至伺服器管理 > 授權金鑰管理頁面,然後啟動授權。
    註: 您不需要執行 3.0.1.x 系統的設定,因為所有項目都已設定完成。

從使用 WebSphere Application Server 的 3.0.1 版升級

程序

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

  1. 安裝 CLM 3.0.1.x。請勿執行設定。 若為分散式配置,請安裝與已安裝的 3.0.1 應用程式相對應的 CLM 3.0.1.x 應用程式。
    註: 您必須一律先升級 Jazz Team Server。
  2. 備份 WebSphere® Application Server 設定檔。
    1. 開啟命令提示字元,並且切換至 <WAS_Install>/bin 目錄。例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin。
    2. 執行下列指令:
      ./backupConfig <建立設定檔備份的新壓縮檔路徑>(例如,./backupConfig /root/was_backups/clm_301_profile.zip)
      註: 如果需要還原備份的設定檔,可以執行 ./restoreConfig 指令。例如,./restoreConfig /root/was_backups/clm_301_profile.zip。
  3. 解除安裝 WebSphere Application Server 中的 3.0.1 應用程式。
    1. 登入 WebSphere Application Server Integrated Solutions 主控台,網址:https://<host name>:9043/ibm/console/logon.jsp。
    2. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式。
    3. 寫下 jts_war、ccm_war 和 qm_war 3.0.1 應用程式的安全角色對映,以協助您在步驟 16 中,針對 3.0.1.x 的對應項目來重新對映它們。
    4. 停止並解除安裝下列 3.0.1 應用程式:jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war。
    5. 當提示時,將所做的變更儲存到主要配置。
  4. 更新 JAZZ_HOME 和 log4j.configuration 自訂內容。
    1. 登入 WebSphere Application Server Integrated Solutions 主控台,網址:https://<host name>:9043/ibm/console/logon.jsp。
    2. 按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器。
    3. 按一下伺服器名稱來開啟它。預設伺服器名稱是 server1。
    4. 在「伺服器基礎架構」區段之下,按一下 Java 和程序管理 > 程序定義。
    5. 在「其他內容」之下,按一下 Java 虛擬機器。
    6. 在「其他內容」之下,按一下自訂內容。
    7. 按一下 JAZZ_HOME,將其值更新為 file:///<3.0.1.x_install_dir>/server/conf。 例如,file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf。
    8. 按一下 log4j.configuration,將其值更新為 file:///<3.0.1.x_install_dir>/server/conf/startup_log4j.properties。 例如,file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf/log4j.properties。
    9. 如果您要連接 Oracle 或 SQL Server 資料庫,請確定 ORACLE_JDBC_DRIVER_FILE 或 SQLSERVER_JDBC_DRIVER_FILE 指向正確的 JDBC 驅動程式檔案。
    10. 當提示時,將所做的變更儲存到主要配置。
      註: 如需詳細資料,請參閱設定 WebSphere Application Server。
  5. 停止 WebSphere Application Server。
  6. 從設定檔中的 wstemp 和 temp 目錄中移除 CLM 相關內容。視先前安裝的應用程式而定,設定檔之下會出現下列目錄,而且可以移除:jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war。
    <profile directory>/wstemp(例如 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wstemp)
    <profile directory>/temp(例如 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
  7. 從設定檔中的 logs 目錄移除 CLM 相關日誌。
    <profile directory>/logs(例如 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
  8. 準備 CLM 3.0.1.x 應用程式的資料庫。
    1. 如果使用 Derby,請將 Derby DB 從 3.0.1 移至 3.0.1.x:
      cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
      cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
      cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
    2. 如果使用 DB2、Oracle 或 SQL Server,請備份資料庫。
  9. 如果使用升級封套 Script,請跳至步驟 14
  10. 將您的 JFS/text 索引從 3.0.1 複製到 3.0.1.x。(若為分散式系統,請移至適當的伺服器來複製檔案。)
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  11. 將您的應用程式配置檔案從 3.0.1 複製到 3.0.1.1。(若為分散式系統,請至適當的伺服器來複製檔案。)
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  12. 執行 repotools -addTables 指令以確保資料庫具備正確的表格。(若為分散式系統,請至適當的伺服器並執行 repotools 指令。)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  13. 如果您已配置資料倉儲,請執行 repotools-jts -createWarehouse 指令,將資料倉儲綱目更新至 3.0.1.x。
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  14. 如果使用升級封套 Script,請切換至 <3.0.1.x_install_dir>/server 目錄。
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf)
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  15. 啟動 WebSphere Application Server。
  16. 在 WebSphere Application Server 中部署 3.0.1.x 的 war 檔。
    1. 登入 WebSphere Application Server Integrated Solutions 主控台,網址:https://<host name>:9043/ibm/console/logon.jsp。
    2. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式。
    3. 安裝 jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war 檔。
    4. 適當地對映下列應用程式的安全角色:jts_war、ccm_war、qm_war。
      註: 如需詳細資料,請參閱將 CLM 應用程式部署在 WebSphere Application Server 上。
  17. 在「企業應用程式」頁面中,啟動下列應用程式:jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war。
  18. 對 JTS、CCM 和 QM 執行伺服器重設:
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://rqm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    註: 您必須重新啟動伺服器,使伺服器重設生效。
  19. 必要的話,請啟動 3.0.1.x 授權。例如,若為里程碑版本,您必須啟動里程碑隨附的「早期存取授權」。如果是 3.0.1.x 最終版本,您可以繼續使用您的 3.0.1 授權。
    1. 以管理者身分登入 3.0.1.x Jazz Team Server。
    2. 導覽至伺服器管理 > 授權金鑰管理頁面,然後啟動授權。
    註: 您不需要執行 3.0.1.x 系統的設定,因為所有項目都已設定完成。
    註: 如需有關升級程序的最新資訊,請參閱 CLM 升級知識集。

意見