這個主題說明將伺服器從「Rational® Collaborative Lifecycle Management (CLM) 解決方案」3.0.1.x 版應用程式升級至第 4 版,以及設定使用 Tomcat 應用程式伺服器和 DB2® for z/OS® 所需的步驟。
開始之前
建立 BLZSAMP 成員副本,以便在必要時可以檢閱原始檔案。在提交工作之後,檢閱範例的工作日誌。預期的回覆碼是 0。
關於這項作業
下列步驟是將配置從 3.0.1.x 版移轉至 4.0 版配置。
程序
- 使用 SMP/E 安裝來安裝 CLM 第 4 版套件。第 4 版配置的位置必須不同於 3.0.1.x 版配置位置。 安裝 SMP/E 套件,會提供用來升級的新資料庫備份工具。如需詳細資料,請參閱 SMP/E 安裝程序概觀。
註: 第 4 版 FMID 已變更,因此沒有 PTF 可從 3.0.1.x 版升級至第 4 版。
- 停止所有的 3.0.1.x 版伺服器。
- 使用所提供的 DB2 for z/OS UNLOAD 和 LOAD 公用程式來備份 3.0.1.x 儲存庫。 如需詳細資料,請參閱 利用 DB2 卸載和載入程序進行備份。您可以利用其他工具來建立備份副本,但前提是該工具已經過測試和驗證。
重要: 繼續升級之前,必須先為儲存庫建立備份副本,這是因為升級程序一旦對儲存庫模型變更之後,就無法再回復。
- 如果要驗證備份及還原程序,請對新資料庫和新綱目字首完成 UNLOAD 和 LOAD 步驟。
- 使用 3.0.1.x 版 BLZCREDB 範例工作,在新資料庫中建立表格。
- 如果要完整測試資料庫備份及還原程序,請為每一個儲存庫建立其他資料庫。新建資料庫的許可權,必須與現有資料庫相同。
- 如果您正在還原資料倉儲的副本,必須將它還原至不同的 DB2 z/OS 子系統,這是因為一個子系統中不能存在兩個資料倉儲。
- 為每一個資料庫建立個別的「UNIX 系統服務」目錄 (ussWorkDir)。
- 使用字元數相同的儲存庫綱目字首。
- 繼續升級步驟之前,先驗證已順利建立新的 3.0.1.x 儲存庫。
- 配置 Tomcat 伺服器,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZPOPT,以設定新的 Tomcat 伺服器配置結構和工作目錄。請確定配置目錄不同於 3.0.1.x 版安裝中使用的配置目錄。請遵循範例成員中的指示,或參閱為 Jazz Team Server 和 Rational Collaborative Lifecycle Management 應用程式解決方案建立其他目錄。
- 配置 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 應用程式解決方案建立其他目錄。
- 配置「變更與配置管理 (CCM)」伺服器,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPCCM,來設定含有 CCM 定義的新伺服器配置和工作目錄結構。 請遵循範例成員中的指示,或參閱為 Jazz Team Server 和 Rational Collaborative Lifecycle Management 應用程式解決方案建立其他目錄。
- 配置「品質管理 (QM)」伺服器,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPQM
來設定含有 QM 定義的新伺服器配置和工作目錄結構。 請遵循範例成員中的指示。
- 配置「需求管理 (RM)」伺服器,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPRM
來設定含有 RM 定義的新伺服器配置和工作目錄結構。 請遵循範例成員中的指示。
- 啟動與停止第 4 版 Tomcat 伺服器,來部署應用程式
(或部署 ccm.war 和 jts.war 檔)。
註: 如果已自訂 3.0.1.x 版應用程式 web.xml 檔
(例如:支援 LDAP 登錄),剩下的步驟是將那些自訂檔案移轉至第 4 版應用程式,並且修改每一個應用程式中的 web.xml 檔。不過,.war 檔已簽署,因此只能對 .war 檔的部署版本進行修改。如果在移轉之後重新部署了應用程式,必須手動重新自訂第 4 版檔案。
- 移轉 JTS 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZJTSU,以便將 3.0.1.x 版配置檔設定合併到 JTS 第 4 版配置檔。提交 BLZJTSU 工作之前,請先完成下列步驟:
- 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
註: 在 3.0.1 版中已新增這個範例成員使用的 migration_jts_updateConfigurationFiles 儲存庫工具指令。如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
- 完成範例 BLZJTSU 工作中的指示。
提交 BLZJTSU 工作,並檢閱工作輸出和已更新的內容檔。註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
- 移轉 CCM 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZCCMU,以便將 3.0.1.x 版配置檔設定合併到 CCM 第 4 版配置檔。提交 BLZCCMU 工作之前,請先完成下列步驟:
- 變更下列字行: 將 applicationContextRoot=jazz 變更為 applicationContextRoot=ccm。除非 3.0.1.x 版伺服器是從 2.x 版移轉而來,應用程式環境定義應該是 /ccm。
- 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
註: 在 3.0.1.x 版中已新增這個範例成員使用的 migration_ccm_updateConfigurationFiles 儲存庫工具指令。
如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
- 完成範例 BLZCCMU 工作中的指示。
提交 BLZCCMU 工作,並檢閱工作輸出和已更新的內容檔。註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
- 移轉 QM 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZQMU,以便將 3.0.1.x 版配置檔設定合併到 QM 第 4 版配置檔。提交 BLZQMU 工作之前,請先完成下列步驟:
- 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
註: 在 3.0.1.x 版中已新增這個範例成員使用的 migration_qm_updateConfigurationFiles 儲存庫工具指令。
如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
- 完成範例 BLZQMU 工作中的指示。
提交 BLZQMU 工作,並檢閱工作輸出和已更新的內容檔。註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
- 移轉 RM 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZRMU,以便將 3.0.1.x 版配置檔設定合併到 RM 第 4 版配置檔。提交 BLZRMU 工作之前,請先完成下列步驟:
- 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
註: 在 3.0.1.x 版中已新增這個範例成員使用的 migration_rm_updateConfigurationFiles 儲存庫工具指令。
如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
- 完成範例 BLZRMU 工作中的指示。
提交 BLZRMU 工作,並檢閱工作輸出和已更新的內容檔。註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
- 完成下列步驟,來複製索引檔案:
- 將 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 具有正確的位置資訊。
- 升級 JTS 資料庫。利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZADDTB 副本,以便將 4.0 資料庫表格新增至 JTS 儲存庫。應用程式變數 @appl@ 應設為 jts。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
- 升級 CCM 資料庫。如果您已配置 CCM 應用程式,請利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZADDTB 副本,以便將 4.0 資料庫表格新增至 CCM 儲存庫。應用程式變數 @appl@ 應設為 ccm。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
- 升級 QM 資料庫。如果您已配置 QM 應用程式,請利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZADDTB 副本,以便將 4.0 資料庫表格新增至 QM 儲存庫。應用程式變數 @appl@ 應設為 qm。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
- 選用:配置資料倉儲。編輯 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
- 升級資料倉儲。如果您已配置資料倉儲,請利用儲存庫工具,修改並提交第 4 版 SBLZSAMP 範例成員 BLZDWHUP 副本,以便升級資料倉儲儲存庫。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
- 修改並提交第 4 版 SBLZSAMP 範例成員 BLZSRVD,來啟動第 4 版 Tomcat 伺服器。請確定配置目錄
@confPath@ 變數和工作目錄 @workPath@ 變數是設為新的第 4 版目錄值。
- 完成下列步驟,來啟動授權:
- 以管理者身分登入 4.0 Jazz Team Server。
- 導覽至伺服器管理 > 授權金鑰管理頁面,並啟動授權。
註: 在 4.0 系統上不需要執行設定,因為一切都已設定完畢。
授權注意事項: - 在里程碑版本中,您必須啟動里程碑隨附的「體驗版授權」。
- 若為 4.0 最終版,您必須購買新的授權。第 4 版授權相容於第 3 版應用程式,但是第 4 版應用程式不會與第 3 版授權搭配運作。如需相關資訊,請參閱管理授權。
- 移轉 Rational Requirements Composer (RRC)。如果您已配置 RM 應用程式,您必須完成下列步驟,來執行 RM 線上移轉公用程式:
- 開啟瀏覽器,清除瀏覽器快取,然後導覽至 RM Web 用戶端。在下列 URL 中指定伺服器名稱和埠號:
https://server_name:port/rdm/web/projects/migration。預設埠是 9443。頁面會偵測到移轉正在進行且移轉精靈啟動。
- 接受「Rational Requirements
Composer - 分析師用戶端存取」授權。
- 按一下開啟移轉服務畫面,然後選取移轉精靈來啟動 Rational Requirements Composer 移轉。移轉進行期間,會在移轉網頁上,將狀態報告給管理者,指出正在處理哪個儲存區以及何時開始編製索引。
重要: 移轉開始之後,您就無法取消這項作業,必須等到移轉完成。
移轉完成之後,會重新編製 Rational Requirements Composer 資料的索引。
- 重新編製索引完成之後,應用程式會對移轉資料執行驗證和一致性檢查,並提供意見給管理者。
- 當顯示訊息,指出移轉完成時,請按一下關閉。接著,會將您重新導向至 RRC 應用程式。
如需其他詳細資料,請參閱線上移轉的升級步驟。