這個主題說明將伺服器從 Rational® Team Concert (RTC) 3.0 版升級至
「Rational Collaborative Lifecycle Management (CLM) 解決方案」第 4 版應用程式,以及設定使用 Tomcat 應用程式伺服器和 DB2® for z/OS® 所需的步驟。
開始之前
建立 BLZSAMP 成員副本,以便在必要時可以檢閱原始檔案。在提交工作之後,檢閱範例的工作日誌。預期的回覆碼是 0。
關於這項作業
下列步驟是將配置從 RTC 3.0 版移轉至 CLM 4.0 版配置。
程序
- 使用 SMP/E 安裝來安裝 CLM 第 4 版套件。第 4 版配置的位置必須不同於 3.0 版配置位置。 安裝 SMP/E 套件,會提供用來升級的新資料庫備份工具。如需詳細資料,請參閱 SMP/E 安裝程序概觀。
註: 第 4 版 FMID 已變更,因此沒有 PTF 可從 3.0 版升級至第 4 版。
- 使用所提供的 DB2 for z/OS UNLOAD 和 LOAD 公用程式來備份 3.0 儲存庫。 如需詳細資料,請參閱 利用 DB2 卸載和載入程序進行備份。您可以利用其他工具來建立備份副本,但前提是該工具已經過測試和驗證。
重要: 繼續升級之前,必須先為儲存庫建立備份副本,這是因為升級程序一旦對儲存庫模型變更之後,就無法再回復。
- 如果要驗證備份及還原程序,請對新資料庫和新綱目字首完成 UNLOAD 和 LOAD 步驟。
- 使用 3.0 版 BLZCREDB 範例工作,在新資料庫之建立表格。
- 如果要完整測試資料庫備份及還原程序,請為每一個儲存庫建立其他資料庫。新建資料庫的許可權,必須與現有資料庫相同。
- 為每一個資料庫建立個別的「UNIX 系統服務」目錄 (ussWorkDir)。
- 使用字元數相同的儲存庫綱目字首。
- 繼續升級步驟之前,先驗證已順利建立新的 3.0 儲存庫。
- 配置 Jazz™ Team Server (JTS),作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCPJTS,以設定伺服器配置結構和工作目錄,包括「生命週期專案管理」應用程式在內。
註: 您針對第 4 版建立的配置 (JAZZ_HOME) 和工作目錄,必須不同於 3.0 版目錄,這樣升級公用程式才能合併這兩個版本。舉例來說,3.0 版的預設配置目錄是 /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 應用程式解決方案建立其他目錄。
- 建立名稱為 RIDW 的 DB2 for z/OS 新資料庫來作為資料倉儲,並授與許可權。 如需詳細資料,請參閱 設定 DB2 for z/OS,以搭配使用 Jazz Team Server。
- 啟動與停止第 4 版 Tomcat 伺服器,來部署應用程式
(或部署 ccm.war 和 jts.war 檔)。
註: 如果已自訂 3.0 版應用程式 web.xml 檔
(例如:支援 LDAP 登錄),剩下的步驟是將那些自訂檔案移轉至第 4 版應用程式,並且修改每一個應用程式中的 web.xml 檔。不過,.war 檔已簽署,因此只能對 .war 檔的部署版本進行修改。如果在移轉之後重新部署了應用程式,必須手動重新自訂 3.0 版檔案。
- 移轉 JTS 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZJTSU,以便將 3.0 版配置檔設定合併到 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 版伺服器是從 2.x 版移轉而來,應用程式環境定義應該是 /ccm。
- 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
註: 在第 3 版中已新增這個範例成員使用的 migration_ccm_updateConfigurationFiles 儲存庫工具指令。
如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
- 完成範例 BLZCCMU 工作中的指示。
提交 BLZCCMU 工作,並檢閱工作輸出和已更新的內容檔。註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
- 停止 RTC 第 3 版 Tomcat 伺服器。
- 完成下列步驟,來複製索引檔案:
- 將 JFS/文字索引從第 3 版複製到第 4 版。
若為分散式系統,請移至適當的伺服器來複製檔案。
- 開啟命令提示字元,輸入下列指令來清除預設 4.0 索引目錄:
rm -rf <4.0_configuration_dir>/jts/indices
rm -rf <4.0_configuration_dir>/ccm/indices
開啟命令提示字元,輸入下列指令,將索引從第 3 版複製到第 4 版:cp -R <3.0_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
cp -R <3.0_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
編輯 JTS 和 CCM 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。請遵循範例成員提供的指示,並仔細檢閱工作輸出。
- 選用:配置資料倉儲。編輯 JTS 和 CCM teamserver.properties 檔,使其包含資料倉儲儲存庫的設定。這三個檔案都採用相同的設定。
重要: 如果您現在沒有實作獨立式資料倉儲,您可以跳過這個步驟。不過,如果您跳過這個步驟,使用 Jazz Team Server 安裝精靈時,必須跳過資料倉儲配置步驟。
如果您現在正在配置資料倉儲,必須更新 JTS 和 CCM 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
- 如果您已更新資料倉儲的 teamserver.properties 檔,請建立資料倉儲儲存庫,作法是修改並提交第 4 版 SBLZSAMP 範例成員 BLZCREDB,以建立資料倉儲表格。將應用程式變數 @appl@ 設為 jts。儲存庫工具指令 @repotoolsCommand@ 是 -createWarehouse。
- 修改並提交第 4 版 SBLZSAMP 範例成員 BLZSRVD,來啟動第 4 版 Tomcat 伺服器。請確定配置目錄
@confPath@ 變數和工作目錄 @workPath@ 變數是設為新的第 4 版目錄值。
- 完成下列步驟,來啟動授權:
- 以管理者身分登入 4.0 Jazz Team Server。
- 導覽至伺服器管理 > 授權金鑰管理頁面,並啟動授權。
註: 在 4.0 系統上不需要執行設定,因為一切都已設定完畢。
授權注意事項: - 在里程碑版本中,您必須啟動里程碑隨附的「體驗版授權」。
- 若為 4.0 最終版,您必須購買新的授權。第 4 版授權相容於第 3 版應用程式,但是第 4 版應用程式不會與第 3 版授權搭配運作。如需相關資訊,請參閱管理授權。
- 如果您想新增「品質管理 (QM)」或「需求管理 (RM)」應用程式,請遵循新安裝作業的指示。如需詳細資料,請參閱在 z/OS 上安裝及配置 Jazz Team Server 和 Rational Collaborative Lifecycle Management 應用程式解決方案。