這個主題說明將 3.0 版 Jazz™ Team Server 升級至第 4 版「Rational® Collaborative Lifecycle Management (CLM) 解決方案」應用程式,以及設定使用 WebSphere® Application Server 和 DB2® for z/OS® 所需的步驟。
開始之前
建立 BLZSAMP 成員副本,以便在必要時可以檢閱原始檔案。在提交工作之後,檢閱範例的工作日誌。預期的回覆碼是 0。
關於這項作業
下列步驟是將配置從 3.0 版移轉至 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。
- 移轉 JTS 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZJTSU,以便將 3.0 版配置檔設定合併到 JTS 第 4 版配置檔。提交 BLZJTSU 工作之前,請先完成下列步驟:
- 刪除含有下列參數的字行:
oldTomcatHome
newTomcatHome
- 變更下列字行: 將 updateTomcatFiles=yes 變更為 updateTomcatFiles=no
- 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
註: 在 3.0.1 版中已新增這個範例成員使用的 migration_jts_updateConfigurationFiles 儲存庫工具指令。如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
- 完成範例 BLZJTSU 工作中的指示。
提交 BLZJTSU 工作,並檢閱工作輸出和已更新的內容檔。註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
- 完成下列步驟,將 3.0 應用程式從 WebSphere Application Server 解除安裝:
- 登入 WebSphere Application
Server Integrated Solutions Console,網址是:https://example.com:9043/ibm/console/logon.jsp
- 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式。
- 記下下列 3.0 版應用程式的安全角色對映,以便針對第 4 版的對應項目重建它們:
- 停止並解除安裝下列 3.0 應用程式:
- jts_war
- ccm_war
- clmhelp_war
- 出現提示時,將變更儲存至主要配置。
- 完成下列步驟,以更新 JAZZ_HOME 和 log4j.configuration 自訂內容:
- 登入 WebSphere Application
Server Integrated Solutions Console,網址是:https://example.com:9043/ibm/console/logon.jsp
- 按一下伺服器 > 伺服器類型 > Websphere Application Server。
- 按一下伺服器名稱來開啟它。預設伺服器名稱是 "server1"。
- 在「伺服器基礎架構」區段之下,選取 Java 和程序管理> 程序定義。
- 在「其他內容」之下,選取 Java 虛擬機器。
- 在「其他內容」下,選取自訂內容。
- 選取 JAZZ_HOME,並將其值更新為:file:///<4.0_configuration_dir>。舉例來說,file:///etc/jazz40。
- 選取 log4j.configuration,並將其值更新為 file:///<4.0_configuration_dir>/startup_log4j.properties。舉例來說,file:///etc/jazz40/startup_log4j.properties。
- 出現提示時,將變更儲存至主要配置。
如需相關資訊,請參閱設定 WebSphere Application Server。
- 停止 WebSphere Application Server。
- 完成下列步驟,刪除 WebSphere 暫存檔和目錄,並且清除快取:
- 移至 WebSphere Application Server 設定檔之下的暫存目錄,通常類似於 <WAS_profile_root>/temp/<node_name>/<server_name>,並且刪除任何 <application>_war 目錄。
- 移至 <WAS_profile_root>/temp/wscache,如果 <application>_war 存在,請刪除它。
- 移轉 CCM 伺服器配置。利用儲存庫工具,修改第 4 版 SBLZSAMP 範例成員 BLZCCMU,以便將 3.0 版配置檔設定合併到 CCM 第 4 版配置檔。提交 BLZCCMU 工作之前,請先完成下列步驟:
- 刪除含有下列參數的字行:
oldTomcatHome
newJTSTomcatHome
newApplicationTomcatHome
- 變更下列字行: 將 updateTomcatFiles=yes 變更為 updateTomcatFiles=no
- 變更下列字行: 將 applicationContextRoot=jazz 變更為 applicationContextRoot=ccm。除非 3.0 版伺服器是從 2.x 版移轉而來,應用程式環境定義應該是 /ccm。
- 取代 @pathPrefix@ 變數,以指向第 4 版二進位檔的路徑字首。
註: 在 3.0.1 版中已新增這個範例成員使用的 migration_ccm_updateConfigurationFiles 儲存庫工具指令。如果 @pathPrefix@ 指向舊版,儲存庫工具指令不會使用第 4 版更新指令。
- 完成範例 BLZCCMU 工作中的指示。
提交 BLZCCMU 工作,並檢閱工作輸出和已更新的內容檔。註: 執行這項合併期間,會維護指向 Derby 資料倉儲的資料倉儲內容,但是是在之後的步驟才會處理。
- 完成下列步驟,來複製索引檔案:
- 將 JFS/文字索引從 3.0 版複製到第 4 版。
若為分散式系統,請移至適當的伺服器來複製檔案。
- 開啟命令提示字元,輸入下列指令來清除預設 4.0 索引目錄:
rm -rf <4.0_configuration_dir>/jts/indices
rm -rf <4.0_configuration_dir>/ccm/indices
- 開啟命令提示字元,輸入下列指令,將索引從 3.0 版複製到第 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。
- 啟動 WebSphere Application Server。
- 完成下列步驟,將第 4 版 war 檔部署在 WebSphere Application Server 中:
- 登入 WebSphere Application
Server Integrated Solutions Console,網址是:https://example.com:9043/ibm/console/logon.jsp
- 選取應用程式 > 應用程式類型 > WebSphere 企業應用程式,來開啟「企業應用程式」頁面
- 安裝下列第 4 版 .war 檔:
- jts.war
- ccm.war
- clmhelp.war
- admin.war
- 根據您在先前步驟中解除安裝應用程式時所記下的安全角色對映,來對映下列第 4 版應用程式的安全角色:
- 從 WebSphere Application Server Integrated Solutions Console 啟動應用程式:
- jts_war
- ccm_war
- clmhelp_war
- admin_war
- 開啟瀏覽器,並貼上下列 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
註: 您必須重新啟動伺服器,伺服器重設才會生效。
- 完成下列步驟,來啟動授權:
- 以管理者身分登入 4.0 Jazz Team Server。
- 導覽至伺服器管理 > 授權金鑰管理頁面,並啟動授權。
註: 在 4.0 系統上不需要執行設定,因為一切都已設定完畢。
授權注意事項: - 在里程碑版本中,您必須啟動里程碑隨附的「體驗版授權」。
- 若為 4.0 最終版,您必須購買新的授權。第 4 版授權相容於第 3 版應用程式,但是第 4 版應用程式不會與第 3 版授權搭配運作。如需相關資訊,請參閱管理授權。
- 如果您想新增「品質管理 (QM)」或「需求管理 (RM)」應用程式,請遵循新安裝作業的指示。如需詳細資料,請參閱在 z/OS 上安裝及配置 Jazz Team Server 和 Rational Collaborative Lifecycle Management 應用程式解決方案。