手動從 3.0 升級至 3.0.1

這個主題說明使用儲存庫工具將 Rational Team Concert 3.0 版升級至 3.0.1 版的手動程序。

開始之前

在升級伺服器之前,請確定您有 Rational Team Concert 和 Jazz Team Server 3.0 版儲存資料庫的完全最新有效備份。

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

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

如果您使用 Derby 資料庫,請將 JTS 和 CCM 資料庫從 3.0 版複製到 3.0.1 版。如需相關資訊,請參閱備份和還原 Derby 資料庫。
註: 如果您利用相同的資料庫,就不需要移轉資料。 但如果在升級時切換資料庫,您就必須從先前的資料庫匯出資料,將它匯入新的資料庫中。

升級 Jazz Team Server (JTS)

  1. 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
  2. 關閉 JTS 3.0 伺服器。
  3. 如果您沒有將安裝 Jazz Team Server 納入 CLM 安裝之中,請將 Jazz Team Server 安裝在磁碟上的新位置。 如果您已安裝 Jazz Team Server、已升級至 3.0.1 版,且想要安裝及升級「變更與配置管理」應用程式,請繼續升級「變更與配置管理 (CCM)」。
  4. 在安裝期間,請選取使用預設 3.x 應用程式環境定義根目錄。
  5. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  6. 導覽至 <3.0.1JTS_install_dir>/server,然後執行下列指令:

    如果您使用 WebSphere Application Server,請在指令中指定 updateTomcatFiles=no 參數。如需這個指令能夠使用的所有可能參數的相關資訊,請參閱-migration_jts_updateConfigurationFiles。

    repotools-jts -migration_jts_updateConfigurationFiles oldJTSHome=<3.0JTS_install_dir>/server/conf 

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

    • 根據 3.0 版檔案中的資訊來更新 3.0.1 版的 teamserver.properties 檔。
    • 複製 Tomcat 使用者 XML 檔的內容。
      記住: 只適用於 Tomcat 使用者資料庫。 會複製 tomcat-users.xml 檔(不會與現有的檔案合併)。 如果您升級具有共同 JTS 的多個 CLM 應用程式,您必須在 tomcat-users.xml 檔中,手動合併使用者和群組資訊。 如果使用者在不同應用程式中,屬於不同的群組,使用者和群組資訊就會不同。 例如,userA 在 CCM 中有 JazzAdmins 角色,在 QM 中有 JazzUsers 角色。 另外,如果某些使用者只出現在一個應用程式中,未出現在另一個應用程式中(反之亦然),就必須將他們手動新增到 tomcat-users.xml 檔中。
    • 將 3.0 版 server.xml 與 web.xml 檔的內容,與 3.0.1 版合併。
  7. 導覽至 <3.0.1JTS_install_dir>/server,然後執行下列指令來建立 JTS 資料庫表格:
    repotools-jts -addTables
  8. 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
  9. 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 jts.war、admin.war 和 clmhelp.war。如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
  10. 啟動 JTS 伺服器。
  11. 繼續執行設定精靈來配置伺服器。

升級「變更與配置管理 (CCM)」

  1. 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
  2. 關閉 CCM 3.0 伺服器。
  3. 將 CCM 應用程式安裝到磁碟上新的位置。
  4. 在安裝期間,請選取使用預設 3.x 應用程式環境定義根目錄。
    重要: 如果您的 Rational Team Concert 3.0 版是從第 2 版升級而來,請選取使用 Rational Team Concert 2.x 環境定義根目錄來保留 /jazz 環境定義根目錄。
  5. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  6. 導覽至 <3.0.1CCM_install_dir>/server,然後執行下列指令:

    如果您使用 WebSphere Application Server,請在指令中指定 updateTomcatFiles=no 參數。如需這個指令能夠使用的所有可能參數的相關資訊,請參閱-migration_ccm_updateConfigurationFiles。

    註: 預設的 applicationContextRoot 是 jazz。 如果您從第 3 版升級,請務必指定 applicationContextRoot 參數,將它設為 ccm。
    repotools-ccm -migration_ccm_updateConfigurationFiles oldApplicationHome=<3.0CCM_install_dir>/server/conf applicationContextRoot=ccm

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

    • 根據 3.0 版檔案中的資訊來更新 3.0.1 版應用程式的 teamserver.properties 檔。
    • 複製 tomcat-users.xml 檔的內容。
      記住: 只適用於 Tomcat 使用者資料庫。 會複製 tomcat-users.xml 檔(不會與現有的檔案合併)。 如果您升級具有共同 JTS 的多個 CLM 應用程式,您必須在 tomcat-users.xml 檔中,手動合併使用者和群組資訊。 如果使用者在不同應用程式中,屬於不同的群組,使用者和群組資訊就會不同。 例如,userA 在 CCM 中有 JazzAdmins 角色,在 QM 中有 JazzUsers 角色。 另外,如果某些使用者只出現在一個應用程式中,未出現在另一個應用程式中(反之亦然),就必須將他們手動新增到 tomcat-users.xml 檔中。
    • 將 3.0 版 server.xml 和 web.xml 檔的內容,與 3.0.1 版合併。
  7. 導覽至 <3.0.1CCM_install_dir>/server,然後執行下列指令來建立 CCM 資料庫表格:
    repotools-ccm -addTables 
  8. 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
  9. 如果您使用 IBM WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 版安裝架構提供的 ccm.war。 如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
  10. 啟動 CCM 伺服器。
  11. 如果您要新增「變更與配置管理」到已建立的 Jazz Team Server 中,請使用管理 Web 介面。 請參閱將應用程式登錄於 Jazz Team Server。
註: Jazz.net 程式庫中關於升級 Rational Team Concert 的最新項目
上層主題: 升級 Rational Team Concert

意見