您可以遵循若干實務,將舊版升級到 Rational Team Concert™ for System z® 2.0.0.2。
在 z/OS 以外的平台上,通常您可以從 .zip 檔或使用 IBM Installation Manager,來升級 Rational Team Concert for System z 用戶端與伺服器。
升級至 Rational Team Concert for System z 2.0.0.2 的程序類似於
升級至
Rational Team Concert 2.0.0.2,但是會有下列的注意事項:
- 以下說明在 z/OS 上從 Rational Team Concert for System z 1.0.1 升級。
- 有關在 z/OS 上從 Rational Team Concert for System z 2.0.0.1 升級,則記載在必須安裝才成升級的 PTF ++HOLD 資訊中。
- Rational Team Concert 的各種版本和版本號碼資訊不是直接對應至
Rational Team Concert for System z。
- 您可以從 Rational Team Concert 升級至 Rational Team Concert
for System z,不過,若要如此做,就必須移轉儲存庫。
您可以使用若干方式來升級至 Rational
Team Concert for System
z 2.0.0.2,其中包括下列實務:
- 從 Rational Team Concert 舊版或從 Rational Team Concert for System z 1.0.1 升級至
Rational Team Concert for System z 2.0.0.2。
- 在 z/OS® 上,從 Rational
Team Concert for System
z 1.0.1 升級至 Rational
Team Concert for System
z 2.0.0.2
- 從 Rational
Team Concert for System
z 2.0.0.1 升級至 Rational
Team Concert for System
z 2.0.0.2
- 在 z/OS 上,從 Rational
Team Concert for System
z 2.0.0.1 升級至 Rational
Team Concert for System
z 2.0.0.2
升級時安裝其他的語言: 如果您使用 IBM® Installation Manager 將 Rational Team Concert for System z 2.0.0.2
安裝在目前未安裝 Rational Team Concert for System z 的電腦上,Installation Manager 會提示您選取要安裝的語言。不過,如果您是從舊版更新成
Rational Team Concert for System z 2.0.0.2,Installation Manager 會假設您希望使用現行語言,而不會提示您選取語言。如果要選取其他的語言,在更新至 2.0.0.2 之後,請從 Installation Manager 的主畫面選取
修改,然後選取供應項目。
下個畫面會顯示支援的語言清單。請選取您需要的語言。
在您更新成 2.0.0.2 之後,如果您是在選取
修改來新增或移除語言之前,就啟動 Jazz™ Team Server for System z,則必須按如下所示來重設伺服器:
- 在 Web 瀏覽器中,導覽至 https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset。
- 按一下要求伺服器重設。
- 關閉伺服器。
之後,您可以在 Installation Manager 中選取修改來新增或移除語言。
升級 Rational Team Concert for System z Client
for Eclipse IDE
任何 Eclipse 整合開發環境 (IDE) 都必須是 2.0.0.1 版或更新的版本,才能連接 2.x 版伺服器。雖然 Rational Team Concert for System z 2.0.0.1
用戶端將連接 2.0.0.2 伺服器,建議您安裝
Rational Team Concert for System z 2.0.0.2 用戶端,以連接您的
Rational Team Concert for System z 2.0.0.2 伺服器。您可以使用 .zip 檔來安裝這個用戶端,或更新您先前的 IBM Installation Manager 安裝架構。
註: Rational Team Concert 2.0 用戶端可以連接到 Rational Team Concert for System z 伺服器;不過,Rational Team Concert 用戶端將會無法使用 Rational Team Concert for System z 專用功能。
將伺服器從 Rational Team Concert 或 Rational
Team Concert for System z 1.0.1 升級
您可以從舊版 Rational
Team Concert 或 Rational Team Concert for System z,直接升級至 Rational Team Concert for System z 2.0 版。
必須移轉資料庫。
註: 在您開始升級 WebSphere® Application Server 之前,請導覽至
https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset,並按一下要求伺服器重設,以重設伺服器。
如果您是從 .zip 檔來安裝先前的版本
(例如,在 Linux® for System z 上),就不會與舊版安裝產生交集。您可以從 .zip 將 2.0 版安裝在新位置,或使用 IBM Installation Manager 來安裝一個 2.0 實例。
如果當初您使用 IBM Installation
Manager 來安裝舊版,則可以將 2.0 安裝成個別的實例,或者將舊有實例更新成 2.0。
如果您想針對 2.0 版安裝個別的伺服器實例,請在安裝精靈的安裝套件頁面上,選取建立新套件群組。
註: 如果要升級
Jazz Team Server for System z 的 WebSphere Application Server 部署,請移除先前的 jazz.war 檔,並部署 2.0 jazz.war 檔。
如需完成升級,請參閱複製先前伺服器安裝中的必要配置檔和安裝 2.0 啟動鍵。
在 z/OS 上從 Rational Team Concert for System z 1.0.1 升級
在 2.0 版中,儲存資料庫有了結構性變更,會阻止您重複使用 z/OS 上 Rational Team Concert for System z 1.0.1 的資料庫。從 Rational Team Concert for System z 1.0.1 版升級至 2.0 的程序,由下列三個步驟組成:
- 利用 repotools 匯出 1.0.1 版資料庫。
- 在想要的目標平台上,安裝和配置 Jazz Team
Server for System z 2.0 版。在這個步驟期間,會建立一個新資料庫。
請參閱在 z/OS 上安裝 Rational Team Concert for System z,以取得在目標平台上安裝 Jazz Team Server for System z 的詳細資料。
- 利用 repotools,將您在步驟 1 建立的 .tar 檔匯入至 2.0 版儲存資料庫。
- 匯出 Rational
Team Concert for System
z 1.0.1 儲存資料庫
- 利用 hlq101.SBLZSAMP 中的 BLZEXPOR 成員來匯出儲存資料庫的內容。
這個成員中的範例 JCL 利用 repotools 匯出指令,來建立含有儲存庫內容的 .tar 檔。
請遵循範例 JCL 中的指示來配置 BLZEXPOR。
提交已修改的 JCL,並檢查工作日誌。只有在結束時回覆碼為 300 時,才表示工作已順利執行。
匯出檔會放在 @jazzExport@ 所指定的 HFS 位置中。
檔案名稱將是 @dbexport@.tar,如 BLZEXPOR 所定義。
- 在 z/OS 上,將匯出的資料庫匯入至 Jazz Team
Server for System z 2.0 版
- 在 z/OS 上,匯入至 Derby 資料庫
- 利用 hlq200.SBLZSAMP 中的 BLZIMPO2 成員,將 1.0.1 版 .tar 檔匯入至 Jazz Team
Server for System z 2.0 版 Derby 資料庫中。依照 JCL 註解所說明,指定從 1.0.1 版資料庫匯出的 .tar 檔來配置 BLZIMPO2。
提交已修改的 JCL,檢查日誌檔來確認 repotools 已順利完成。
- 在 z/OS 上,匯入至 DB2® 資料庫
- 利用 hlq200.SBLZSAMP 中的 BLZIMPOR 成員,將 1.0.1 版 .tar 檔匯入至 Jazz Team
Server for System z 2.0 版 DB2 資料庫中。依照 JCL 註解所說明,指定從 1.0.1 版資料庫匯出的 .tar 檔來配置 BLZIMPOR。
提交已修改的 JCL,檢查日誌檔來確認 repotools 已順利完成。
如果要完成升級,請參閱複製先前伺服器安裝中的必要配置檔。
將 Rational Team Concert for System z 伺服器從 2.0.0.1 升級至 2.0.0.2
您可以從舊版直接升級至 Rational
Team Concert for System z 2.0.0.2 版。可能需要執行其他的儲存庫更新動作,如需詳細資料,請參閱 Jazz.net 的 Rational
Team Concert for System
z Release Notes 頁面。
註: 在您開始升級 WebSphere Application Server 之前,請導覽至
https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset,並按一下要求伺服器重設,以重設伺服器。
如果您是從 .zip 檔來安裝先前的版本
(例如,在 Linux for System z 上),就不會與舊版安裝產生交集。您可以從 .zip 將新版本安裝在新位置,或使用 IBM Installation Manager 來安裝一個 2.0 實例。
如果當初您使用 IBM Installation
Manager 來安裝舊版,則可以將 2.0 安裝成個別的實例,或者將舊有實例更新成 2.0。
如果您想針對 2.0 版安裝個別的伺服器實例,請在安裝精靈的安裝套件頁面上,選取建立新套件群組。
註: 如果要升級
Jazz Team Server for System z 的 WebSphere Application Server 部署,請移除先前的 jazz.war 檔,並部署 2.0 jazz.war 檔。
如需完成升級,請參閱複製先前伺服器安裝中的必要配置檔和安裝 2.0 啟動鍵。
將伺服器從某種 Rational Team Concert for System z 版本升級至另一種版本
Rational Team Concert for System z 版本(Starter、Standard 與 Enterprise)全都以試用模式出貨。如果要從某版本升級至另一版本,您必須載入一組目標版本的組合試用版啟動鍵。
您可以下載這些組合的試用版啟動鍵,位置如下:https://jazz.net/downloads/rational-team-concert-z/。
組合的試用版啟動鍵併在目標版本的 .zip 檔中。
這個組合的 .zip 檔是利用您伺服器管理 Web 介面上的「授權金鑰管理」頁面來安裝。
必須安裝在 z/OS 上,Rational Team Concert for System z 在 2.0.0.1 版中才會以 Starter
Edition 試用模式出貨,若在 2.0.0.2 版中,則是以 Standard Edition 出貨。如果您需要在 z/OS 上升級至另一種 Rational Team Concert for System z 版本,必須先升級至所需要的版本,然後載入您的版本適用的永久「伺服器啟動套件」和「用戶端存取授權」。
在 z/OS 上,從 Rational Team Concert for System z
2.0.0.1 升級至 Rational Team Concert for System z 2.0.0.2
SMP/E 安裝套件包含 RTCz 2.0.0.1。需要 PTF,才能將 z/OS 元件升級至 2.0.0.2。PTF 可從
ShopzSeries、
IBM Support Portal、Jazz.net 或正規的服務管道取得。
請搜尋下列 APAR,並訂購對應的 PTF:PM04798、PM04800、PM04802、PM05340、PM05341、PM05342 與 PM05701。
您必須使用 SMP/E,將這些 PTF 套用至基本 Rational Team Concert for System z 2.0.0.1 安裝架構。PTF 會隨附 PTF 套用步驟的額外資訊。
套用 PTF 之後,還必須執行額外的配置步驟,以便更新現有的配置。
WebSphere Application
Server 配置更新項目
需要執行下列步驟,以便在 Rational
Team Concert for System
z 2.0 中,適當配置
WebSphere Application
Server。
- 確定已安裝 WebSphere Application Server 及相關的 Java™ SDK 最新修正套件。如果是部署在 WebSphere Application Server 7.0 中,至少必須安裝 WebSphere Application Server 7.0.0.3。至於 WebSphere Application Server 6.1,至少必須安裝 WebSphere Application Server 6.1.0.25。
- 移除先前的自訂 JVM 內容:
- com.ibm.team.repository.provision.profile
- com.ibm.team.server.configURL
- log4j.configuration
- 在 z/OS 以外的系統上,如果沒有可用的自訂 JVM 內容 JAZZ_HOME,請新增它,並將值設為:
file:///<JazzInstallDir>/server/conf
。在 z/OS 上,將值設為:
file:///@confPath@
其中
@confPath@ 是 BLZCPDIR 中所設的配置路徑。
- 確定您已選取下列的 WebSphere Application Server 設定:當存取不受保護的 URI 時,使用可用的鑑別資料。如果您使用
WebSphere Application
Server Integrated Solutions Console,則可以執行下列步驟:
- 導覽至。
- 選取當存取不受保護的 URI 時,使用可用的鑑別資料。
- 確定您已部署 Rational Team Concert for System
z jazz.war 檔。jazz.war 應更新為最新的
Rational Team Concert for System z 版本。
複製先前伺服器安裝中的必要配置檔
將下列檔案從來源伺服器複製至目標伺服器。首先,將已升級伺服器中的原始檔案重新命名,以建立備份。如果您使用 IBM Installation Manager
來更新成 Rational Team Concert for System z 2.0,會在安裝位置的 server 子目錄中,以 backup-config-<timestamp> 之類的名稱來建立一個備份目錄,其中含有您的 1.0.1 配置檔。
如果您正在升級至 Standard Edition 或 Enterprise Edition,且已購買 Starter Edition 的「開發人員用戶端啟動套件」,請購買並安裝 Standard Edition 或 Enterprise Edition 的「開發人員用戶端啟動套件」,如此便能使用這些用戶端授權。您的開發人員授權指派仍舊有效,但開發人員授權將會停用,直到您安裝正確的啟動套件為止。
安裝 2.0 啟動鍵
Rational Team Concert for System z 2.0 版本使用
Rational Team Concert for System z 2.0 啟動金鑰。如果您將伺服器從
1.0.1 升級至 2.0,或是從 Rational Team Concert 升級至 Rational
Team Concert for System z,升級之後,它會回復成試用軟體授權,您必須向 Rational License Key Center 取得 Rational Team Concert for System
z 2.0 啟動金鑰。以下是各套件的適當金鑰名稱:
- IBM Rational Team Concert for System z Starter Edition - 伺服器授權啟動套件 2.0 多平台版 (jazz_team_server_starter_zSeries-release.jar)
- IBM Rational Team Concert for System z Starter Edition - 開發人員用戶端授權啟動套件 2.0 多平台版 (rtcz_starter_developer_unlocked.jar)
- IBM - Rational Team Concert for System z 貢獻者用戶端授權啟動套件 2.0 多平台版 (rtcz_all_contributor_unlocked.jar)
- IBM Rational Team Concert for System z Standard Edition - 伺服器授權啟動套件 2.0 多平台版 (jazz_team_server_standard_zSeries-release.jar)
- IBM Rational Team Concert for System z - 開發人員用戶端授權啟動套件 2.0 多平台版 (rtcz_standard_developer_unlocked.jar)
- IBM Rational Team Concert for System z - 浮動開發人員用戶端授權啟動套件 2.0 多平台版 (rtcz_std_floating-developer_unlocked.jar)
- IBM - Rational Team Concert for System z 浮動貢獻者用戶端授權啟動套件 2.0 多平台版 (rtcz_std_floating-contrib_unlocked.jar)
- IBM Rational Team Concert for System z Enterprise Edition - 伺服器授權啟動套件 2.0 多平台版 (jazz_team_server_enterprise_zSeries-release.jar)
設定專案時間表
在 Rational Team Concert 1.0.1 或 Rational Team Concert for System z 1.0.1 中,專案可以有多份時間表(舊稱「開發線」),且所有的這些時間表都視為相等。
在 Rational Team Concert for System z 2.0 中,專案仍可以有多份時間表,但是其中只能有一個標示為「專案時間表」。當將資料庫移轉至 2.0 時,並不知道主要專案時間表,因此,您的專案將不會設定一個專案時間表。升級至 2.0 之後,您可以手動更新專案以設定專案時間表。
配置來源控制管理 Snapshot
資料倉儲的「來源控制管理 (SCM)」Snapshot 會收集串流的資料,其中包括串流大小與其中之活動(變更集與檔案/資料夾變更)的相關資訊。
在 1.0.1 版中,這個 Snapshot 會自動收集所有串流的相關資訊。這樣的作業頗耗成本,因此 2.0 版中的 SCM Snapshot 多了可配置選項,可讓您決定應收集哪些串流的資料。這項變革的立即影響是除非您配置它,否則並不會收集資料。
如果要配置 SCM Snapshot,請執行下列步驟:
- 對於您要收集其資料的串流,您必須具備寫入權。
- 跳至 Rational Team Concert for System z Web 介面中的報告頁面。
- 在左導覽畫面中,選取管理 SCM Snapshot。這時會顯示一份串流清單。
- 選取一或多個串流,然後選取儲存變更。
這樣就會在後續所有的 Snapshot 中,收集所選串流的資料。
不相容的 BIRT 報告變更
如果您已使用 BIRT 報告設計程式來建立自己的報告範本,當您嘗試在 2.0 版中使用這些報告時,可能會遇到一些問題。
您應注意下列問題:
- Java 與 JavaScript™ 類別解析順序的變更:如果您已在 BIRT 報告中撰寫 JavaScript 程式碼,且利用 importPackage() 陳述式來匯入 java.lang 套件,請注意,如果程式碼中原本用來參照 Java 類別的 Object 參照不完整,現在可能會參照 JavaScript 類別,因而無法適當運作。而在 JavaScript 與 Java 中名稱相同的其他類別(例如 java.util.Date),可能會有相同的問題。解決方案是完整定義 Java 類別的參照,並移除 importPackage() 陳述式。
- 資料集處理的變更:過去,將元素(例如,標籤)連結至資料集的動作,會造成在呈現元素時,處理整個資料集。這很有用,因為這表示您可以按照資料集所應遵循的處理順序,利用連結至資料集的隱藏標籤來施行資料集處理順序。現在,這樣的連結只會處理資料集中的第一列。如果要套用以往的行為,請使用「動態文字」元素,並呼叫某些會強迫處理整個資料集的 JavaScript 程式碼。Total.count()
就是一個好的選擇。
- BIRT 報告設計程式的錯誤可能造成資料遺失:當您使用 BIRT 2.3.2(Rational
Team Concert 2.0)報告設計程式,來開啟在 BIRT 2.2.2(Rational
Team Concert 1.0)中建立的 BIRT 報告設計檔時,就會出現這些問題。已觀察到的問題如下:
- 當第一次使用 BIRT 2.3.2 編輯資料集時,在「參數」頁面中,「預設值」與「報告參數」欄位可能遺失。暫行解決方法是重新輸入值,或者從舊版編輯器複製並貼上值。在儲存含有新值的檔案之後,就不會再發生問題。
- 當第一次使用 BIRT 2.3.2 編輯報告設計檔時,報告參數的預設值可能遺失。在前述問題之後,也可能會發生這個問題。暫行解決方法是重新輸入值,或者從舊版編輯器複製並貼上值。在儲存含有新值的檔案之後,就不會再發生問題。
註: 如果不監控,這些問題可能會很嚴重,因為報告所收集的資料可能不正確。在您第一次使用 BIRT 2.3.2 報告設計程式來編輯報告時,請檢查每一個資料集與每一個報告參數。如果是以 BIRT 2.3.2 工具來建立的新報告,就不會發生這些問題。
以上是針對 Rational Team Concert for System z 2.0 所有的現成報告所做的變更。
您這邊不需要執行任何動作。不過,如果您已使用 Rational Team Concert for System z 2.0 現成報告,在您的專案區域中手動建立報告範本,且尚未指定適當的 ID(Rational Team Concert for System z 的用法一致),則您的報告範本在移轉時並不會重新整理。亦即,其內容不會是最新的,且將無法運作。在該情況下,您應使用適當的現行 .rptdesign 檔,上傳受影響範本的新內容。
匯入資料倉儲中的工作項目資料
在 Rational Team Concert for System z 2.0 中,資料倉儲中的工作項目表格做了一些綱目變更。因此,當從 1.0.1 移轉至 2.0 時,匯入器會忽略倉儲中的任何工作項目資料。如此一來,在您第一次啟動 2.0 伺服器時,您的工作項目報告可能無法正確運作。
暫行解決方法是等待第一次執行工作項目 Snapshot,或者在您啟動伺服器之後,手動讓它執行。在移轉之後的第一次執行時,工作項目 Snapshot 會重新建構資料倉儲中的整個歷程工作項目資訊。這也意味著移轉之後第一次執行 Snapshot 時,耗費的時間比夜間執行的平均時間來得久。
探索新報告
在 Rational Team Concert for System z 2.0 中,會新增一些報告。儘管這些報告會出現在 Rational
Team Concert for System z 隨附的新程序範本中,但是當您將資料移轉至 Rational
Team Concert for System z 2.0 時,並不會自動將它們新增至現有的專案區域。如果要在移轉之後於現有的專案區域中,探索與部署這些新的報告範本,請執行下列步驟:
- 在 Eclipse 用戶端中,開啟團隊構件視圖。
- 展開您的專案區域,然後展開報告。
- 用滑鼠右鍵按一下報告範本,並選取部署新範本。
開啟的對話框會協助您探索任何可用但尚未部署至您專案區域的報告範本。您可以從中選取一或多個,以便建立它們。在建立之後,您可以使用可用的功能表動作,從這些範本來建立新報告。
自訂
當您從 1.0.1 升級至 2.0 時,會保留您對工作項目類型、屬性、工作流程、角色與事件處理程式的變更。如果您曾自訂預先定義的程序範本
(例如 Scrum),要注意的是,如果您重新部署預先定義的範本(在「程序範本」視圖中),將會改寫您的自訂內容。如果您需要重新部署預先定義的範本,應先變更您所自訂之預先定義範本的名稱與 ID,這樣就不會遭到改寫。