從 3.0.1.x 升級伺服器,並使用 WebSphere Application Server 和 DB2 for z/OS

這個主題說明將伺服器從「Rational® Collaborative Lifecycle Management (CLM) 解決方案」3.0.1.x 版應用程式升級至第 4 版,以及設定使用 WebSphere® Application Server 和 DB2® for z/OS® 所需的步驟。

開始之前

建立 BLZSAMP 成員副本,以便在必要時可以檢閱原始檔案。在提交工作之後,檢閱範例的工作日誌。預期的回覆碼是 0。

關於這項作業

下列步驟是將配置從 3.0.1.x 版移轉至 4.0 版配置。

程序

  1. 使用 SMP/E 安裝來安裝 CLM 第 4 版套件。第 4 版配置的位置必須不同於 3.0.1.x 版配置位置。 安裝 SMP/E 套件,會提供用來升級的新資料庫備份工具。如需詳細資料,請參閱 SMP/E 安裝程序概觀。
    註: 第 4 版 FMID 已變更,因此沒有 PTF 可從 3.0.1.x 版升級至第 4 版。
  2. 使用所提供的 DB2 for z/OS UNLOAD 和 LOAD 公用程式,來停止伺服器,並備份 3.0.1.x 儲存庫。 如需詳細資料,請參閱利用 DB2 卸載和載入程序進行備份。您可以利用其他工具來建立備份副本,但前提是該工具已經過測試和驗證。
    重要: 繼續升級之前,必須先為儲存庫建立備份副本,這是因為升級程序一旦對儲存庫模型變更之後,就無法再回復。
    1. 如果要驗證備份及還原程序,請對新資料庫和新綱目字首完成 UNLOAD 和 LOAD 步驟。
    2. 使用 3.0.1.x 版 BLZCREDB 範例工作,在新資料庫中建立表格。
    3. 如果要完整測試資料庫備份及還原程序,請為每一個儲存庫建立其他資料庫。新建資料庫的許可權,必須與現有資料庫相同。
    4. 如果您正在還原資料倉儲的副本,必須將它還原至不同的 DB2 z/OS 子系統,這是因為一個子系統中不能存在兩個資料倉儲。
    5. 為每一個資料庫建立個別的「UNIX 系統服務」目錄 (ussWorkDir)。
    6. 使用字元數相同的儲存庫綱目字首。
    7. 繼續升級步驟之前,先驗證已順利建立新的 3.0.1.x 儲存庫。
  3. 配置 Jazz™ Team Server (JTS),作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPJTS,以設定伺服器配置結構和工作目錄,包括「生命週期專案管理」應用程式在內。
    註: 您針對第 4 版建立的配置 (JAZZ_HOME) 和工作目錄,必須不同於 3.0.1.x 版目錄,這樣升級公用程式才能合併這兩個版本。舉例來說,3.0.1.x 版的預設配置目錄是 /etc/jazz,因此對於第 4 版,請使用 /etc/jazz40。同樣地,對於工作目錄,請使用 /u/jazz40。
    請遵循範例成員中的指示,或參閱為 Jazz Team Server 和 Rational Collaborative Lifecycle Management 應用程式解決方案建立其他目錄。
  4. 配置「變更與配置管理 (CCM)」伺服器,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPCCM,來設定含有 CCM 定義的新伺服器配置和工作目錄結構。 請遵循範例成員中的指示,或參閱為 Jazz Team Server 和 Rational Collaborative Lifecycle Management 應用程式解決方案建立其他目錄。
  5. 配置「品質管理 (QM)」伺服器,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPQM 來設定含有 QM 定義的新伺服器配置和工作目錄結構。 請遵循範例成員中的指示。
  6. 配置「需求管理 (RM)」伺服器,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPRM 來設定含有 RM 定義的新伺服器配置和工作目錄結構。 請遵循範例成員中的指示。
  7. 完成下列步驟,將 3.0.1.x 應用程式從 WebSphere Application Server 解除安裝:
    1. 登入 WebSphere Application Server Integrated Solutions Console,網址是:https://example.com:9043/ibm/console/logon.jsp
    2. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式。
    3. 記下下列 3.0.1.x 版應用程式的安全角色對映,以便針對第 4 版的對應項目重建它們:
      • jts_war
      • ccm_war
      • qm_war
    4. 停止並解除安裝下列 3.0.1.x 應用程式:
      • jts_war
      • ccm_war
      • qm_war
      • rm_war
      • clmhelp_war
      • admin_war
    5. 出現提示時,將變更儲存至主要配置。
  8. 完成下列步驟,以更新 JAZZ_HOME 和 log4j.configuration 自訂內容:
    1. 登入 WebSphere Application Server Integrated Solutions Console,網址是:https://example.com:9043/ibm/console/logon.jsp
    2. 按一下伺服器 > 伺服器類型 > Websphere Application Server。
    3. 按一下伺服器名稱來開啟它。預設伺服器名稱是 "server1"。
    4. 在「伺服器基礎架構」區段之下,選取 Java 和程序管理> 程序定義。
    5. 在「其他內容」之下,選取 Java 虛擬機器。
    6. 在「其他內容」下,選取自訂內容。
    7. 選取 JAZZ_HOME,並將其值更新為:file:///<4.0_configuration_dir>。舉例來說,file:///etc/jazz40。
    8. 選取 log4j.configuration,並將其值更新為 file:///<4.0_configuration_dir>/startup_log4j.properties。舉例來說,file:///etc/jazz40/startup_log4j.properties。
    9. 出現提示時,將變更儲存至主要配置。
    如需相關資訊,請參閱設定 WebSphere Application Server。
  9. 停止 WebSphere Application Server。
  10. 完成下列步驟,刪除 WebSphere 暫存檔和目錄,並且清除快取:
    1. 移至 WebSphere Application Server 設定檔之下的暫存目錄,通常類似於 <WAS_profile_root>/temp/<node_name>/<server_name>,並且刪除任何 <application>_war 目錄。
    2. 移至 <WAS_profile_root>/temp/wscache,如果 <application>_war 存在,請刪除它。
  11. 移轉 JTS 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZJTSU,以便將 3.0.1.x 版配置檔設定合併到 JTS 第 4 版配置檔。提交 BLZJTSU 工作之前,請先完成下列步驟:
    1. 刪除含有下列參數的字行:
      oldTomcatHome
      newTomcatHome 
    2. 變更下列字行: 將 updateTomcatFiles=yes 變更為 updateTomcatFiles=no
    3. 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
      註: 在 3.0.1 版中已新增這個範例成員使用的 migration_jts_updateConfigurationFiles 儲存庫工具指令。如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
    4. 完成範例 BLZJTSU 工作中的指示。
    提交 BLZJTSU 工作,並檢閱工作輸出和已更新的內容檔。
    註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
  12. 移轉 CCM 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZCCMU,以便將 3.0.1.x 版配置檔設定合併到 CCM 第 4 版配置檔。提交 BLZCCMU 工作之前,請先完成下列步驟:
    1. 刪除含有下列參數的字行:
      oldTomcatHome
      newJTSTomcatHome
      newApplicationTomcatHome
    2. 變更下列字行: 將 updateTomcatFiles=yes 變更為 updateTomcatFiles=no
    3. 變更下列字行: 將 applicationContextRoot=jazz 變更為 applicationContextRoot=ccm。除非 3.0.1.x 版伺服器是從 2.x 版移轉而來,應用程式環境定義應該是 /ccm。
    4. 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
      註: 在 3.0.1.x 版中已新增這個範例成員使用的 migration_ccm_updateConfigurationFiles 儲存庫工具指令。 如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
    5. 完成範例 BLZCCMU 工作中的指示。
    提交 BLZCCMU 工作,並檢閱工作輸出和已更新的內容檔。
    註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
  13. 移轉 QM 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZQMU,以便將 3.0.1.x 版配置檔設定合併到 QM 第 4 版配置檔。提交 BLZQMU 工作之前,請先完成下列步驟:
    1. 刪除含有下列參數的字行:
      oldTomcatHome
      newJTSTomcatHome
      newApplicationTomcatHome
    2. 變更下列字行: 將 updateTomcatFiles=yes 變更為 updateTomcatFiles=no
    3. 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
      註: 在 3.0.1.x 版中已新增這個範例成員使用的 migration_qm_updateConfigurationFiles 儲存庫工具指令。 如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
    4. 完成範例 BLZQMU 工作中的指示。
    提交 BLZQMU 工作,並檢閱工作輸出和已更新的內容檔。
    註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
  14. 移轉 RM 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZRMU,以便將 3.0.1.x 版配置檔設定合併到 RM 第 4 版配置檔。提交 BLZRMU 工作之前,請先完成下列步驟:
    1. 刪除含有下列參數的字行:
      oldTomcatHome
      newJTSTomcatHome
      newApplicationTomcatHome
    2. 變更下列字行: 將 updateTomcatFiles=yes 變更為 updateTomcatFiles=no
    3. 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
      註: 在 3.0.1.x 版中已新增這個範例成員使用的 migration_rm_updateConfigurationFiles 儲存庫工具指令。 如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
    4. 完成範例 BLZRMU 工作中的指示。
    提交 BLZRMU 工作,並檢閱工作輸出和已更新的內容檔。
    註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
  15. 完成下列步驟,來複製索引檔案:
    1. 將 JFS/文字索引從 3.0.1.x 版複製到第 4 版。 若為分散式系統,請移至適當的伺服器來複製檔案。
      • 開啟命令提示字元,輸入下列指令來清除預設 4.0 索引目錄:
        rm -rf <4.0_configuration_dir>/jts/indices
        rm -rf <4.0_configuration_dir>/ccm/indices
        rm -rf <4.0_configuration_dir>/qm/indices
      • 開啟命令提示字元,輸入下列指令,將索引從 3.0.1.x 版複製到第 4 版:
        cp -R <3.0.1.x_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
        cp -R <3.0.1.x_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
        cp -R <3.0.1.x_configuration_dir>/qm/indices <4.0_configuration_dir>/qm/indices
      編輯 JTS、CCM 和 QM teamserver.properties 檔,確定 com.ibm.team.fulltext.indexLocation 和 com.ibm.team.jfs.index.root.directory 具有正確的位置資訊。
  16. 升級 JTS 資料庫。利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZADDTB 副本,以便將 4.0 資料庫表格新增至 JTS 儲存庫。應用程式變數 @appl@ 應設為 jts。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
  17. 升級 CCM 資料庫。如果您已配置 CCM 應用程式,請利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZADDTB 副本,以便將 4.0 資料庫表格新增至 CCM 儲存庫。應用程式變數 @appl@ 應設為 ccm。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
  18. 升級 QM 資料庫。如果您已配置 QM 應用程式,請利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZADDTB 副本,以便將 4.0 資料庫表格新增至 QM 儲存庫。應用程式變數 @appl@ 應設為 qm。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
  19. 選用:配置資料倉儲。編輯 JTS、CCM 和 QM teamserver.properties 檔,使其包含資料倉儲儲存庫的設定。這三個檔案都採用相同的設定。
    重要: 如果您現在沒有實作獨立式資料倉儲,您可以跳過這個步驟。不過,如果您跳過這個步驟,使用 Jazz Team Server 安裝精靈時,必須跳過資料倉儲配置步驟。
    如果您現在正在配置資料倉儲,必須更新 JTS、CCM 和 QM teamserver.properties 檔,使其包含 db2z 資料倉儲參數,並且移除任何現有的 Derby 資料倉儲內容。具體來說,就是使用 # 註銷,如下列範例所示:
    #com.ibm.team.datawarehouse.db.net.port
    #com.ibm.team.datawarehouse.db.vendor=DERBY (or derby_net) 
    #com.ibm.team.datawarehouse.db.jdbc.location=/directoryInYourWorkdirectory or 
    #com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
    並新增下列資訊:
    com.ibm.team.datawarehouse.db.vendor = db2z
    com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password}; 
    com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
    # The database user for whom proper permissions will be granted
    com.ibm.team.datawarehouse.report.user = RPTUSER
    com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW 
  20. 升級資料倉儲。如果您已配置資料倉儲,請利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZDWHUP 副本,以便升級資料倉儲儲存庫。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
  21. 啟動 WebSphere Application Server。
  22. 完成下列步驟,將第 4 版 war 檔部署在 WebSphere Application Server 中:
    1. 登入 WebSphere Application Server Integrated Solutions Console,網址是:https://example.com:9043/ibm/console/logon.jsp
    2. 選取應用程式 > 應用程式類型 > WebSphere 企業應用程式,來開啟「企業應用程式」頁面
    3. 安裝下列第 4 版 .war 檔:
      • jts.war
      • ccm.war
      • qm.war
      • rm.war
      • clmhelp.war
      • admin.war
    4. 根據您在先前步驟中解除安裝應用程式時所記下的安全角色對映,來對映下列第 4 版應用程式的安全角色:
      • jts_war
      • ccm_war
      • qm_war
  23. 從 WebSphere Application Server Integrated Solutions Console 啟動應用程式:
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • clmhelp_war
    • admin_war
  24. 開啟瀏覽器,並貼上下列 URL,來重設伺服器:
    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://qm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    註: 您必須重新啟動伺服器,伺服器重設才會生效。
  25. 完成下列步驟,來啟動授權:
    1. 以管理者身分登入 4.0 Jazz Team Server。
    2. 導覽至伺服器管理 > 授權金鑰管理頁面,並啟動授權。
      註: 在 4.0 系統上不需要執行設定,因為一切都已設定完畢。
    授權注意事項:
    • 在里程碑版本中,您必須啟動里程碑隨附的「體驗版授權」。
    • 若為 4.0 最終版,您必須購買新的授權。第 4 版授權相容於第 3 版應用程式,但是第 4 版應用程式不會與第 3 版授權搭配運作。如需相關資訊,請參閱管理授權。
  26. 移轉 Rational Requirements Composer (RRC)。如果您已配置 RM 應用程式,您必須完成下列步驟,來執行 RM 線上移轉公用程式:
    1. 開啟瀏覽器,清除瀏覽器快取,然後導覽至 RM Web 用戶端。在下列 URL 中指定伺服器名稱和埠號: https://server_name:port/rdm/web/projects/migration。預設埠是 9443。頁面會偵測到移轉正在進行且移轉精靈啟動。
    2. 接受「Rational Requirements Composer - 分析師用戶端存取」授權。
    3. 按一下開啟移轉服務畫面,然後選取移轉精靈來啟動 Rational Requirements Composer 移轉。移轉進行期間,會在移轉網頁上,將狀態報告給管理者,指出正在處理哪個儲存區以及何時開始編製索引。
      重要: 移轉開始之後,您就無法取消這項作業,必須等到移轉完成。
      移轉完成之後,會重新編製 Rational Requirements Composer 資料的索引。
    4. 重新編製索引完成之後,應用程式會對移轉資料執行驗證和一致性檢查,並提供意見給管理者。
    5. 當顯示訊息,指出移轉完成時,請按一下關閉。接著,會將您重新導向至 RRC 應用程式。
    如需其他詳細資料,請參閱線上移轉的升級步驟。

意見