使用 IBM Installation Manager
來安裝 Rational Team Concert 用戶端
使用 IBM Installation Manager 來安裝用戶端
用戶端是透過 IBM® Installation
Manager 以可下載的檔案方式配送。
執行這項作業的原因和時機
註:
如果您想將用戶端安裝至現有的 Eclipse 工作台,請使用 IBM Installation Manager。IBM Installation Manager 安裝會提示您提供您想擴充的工作台,並顧及未來工作台更新、回復和修改等的管理。
註:
若有啟用 Security-Enhanced Linux® (SELinux),您
必須停用它,或變更「Java 執行時期環境 (JRE)」的安全環境定義,以容許重新定位文字,如此才能安裝和執行 Rational Team Concert。如需相關資訊,請參閱
在設定了 Security-Enhanced Linux 的情況下安裝 Rational Team Concert。
- 下載下列其中一個安裝套件。
Rational® Team Concert 用戶端有三種安裝方法。
- 用戶端 CD 內容 .zip 檔 - Installation Manager 的用戶端本端安裝方式:這種保存檔含有 Installation Manager 啟動程式和
Rational Team Concert 用戶端的本端副本。使用本端安裝套件的好處是,安裝可在沒有網際網路連線下繼續進行。這是一個不會自行解壓縮的 .zip 檔。
- Installation Manager 的用戶端、伺服器和選用元件 Web 安裝方式:
這個保存檔含有 Installation Manager 啟動程式和預先定義的安裝儲存庫位置。這是一個自行解壓縮檔,它會在解壓縮內容後,啟動 IBM Installation Manager 啟動程式。使用 Web 安裝套件的好處是,它可減少起始的下載,且安裝程序只會下載您選擇要安裝的資源。
註:
Web 安裝在安裝程序期間需要網際網路連線。
- 完整 DVD 內容 .zip 檔:這種保存檔含有 Installation Manager 啟動程式和所有可安裝資源的本端副本。使用本端安裝套件的好處是,安裝可在沒有網際網路連線下繼續進行。這是一個不會自行解壓縮的 .zip 檔。
- 啟動啟動程式。
如果 Installation Manager 已不在執行中,請完成下列步驟來啟動它。
註:
您必須具備管理者專用權,才能執行啟動程式。
註:
用來啟動啟動程式的 Linux 指令僅適用於
Rational Team Concert for
Eclipse IDE。
如果要啟動啟動程式於:
- 如果您使用用戶端 CD 內容 .zip 檔,請將保存檔內容解壓縮至一個暫存目錄,並執行啟動程式。如果要啟動啟動程式於:
- 如果要在 Windows 上執行檔案,請執行下列指令:
launchpad.exe
- 如果要在 Linux 上執行檔案,請執行下列指令:
sh launchpad.sh
- 如果您使用 Installation Manager Web 安裝方式,請執行執行檔。檔案會解壓縮至目錄,並出現啟動程式。如果要啟動執行檔於:
- 如果您使用完整 DVD 內容 .zip 檔,請將保存檔內容解壓縮至一個暫存目錄,並執行啟動程式。如果要啟動啟動程式於:
- 如果要在 Windows 上執行檔案,請執行下列指令:
launchpad.exe
- 如果要在 Linux 上執行檔案,請執行下列指令:
sh launchpad.sh
- 您可以安裝下列用戶端:
- 如果要安裝 Rational Team Concert Client
for Eclipse,請按一下 Rational Team Concert Client
for Eclipse IDE 鏈結。
- 如果要安裝 Rational Team Concert Client
for Microsoft Visual Studio,請按一下 Rational Team Concert Client for Microsoft® Visual Studio IDE 鏈結。
這時會顯示 Installation Manager 精靈。精靈會引導您完成用戶端的安裝。
- 按一下安裝所建立的 Rational Team Concert 捷徑,來啟動用戶端。
- 連接伺服器。 連接伺服器最簡單的方式是使用「團隊邀請」。如果您未獲邀請,可手動連接。
- 按一下檔案 -> 接受團隊邀請。精靈會引導您完成程序。
註:
如果您未獲邀請,必須向您的伺服器管理者取得 URI 或 URL。(例如,格式可以是 https://example.com:9443/jazz)。按一下位於接受團隊邀請視窗右下角的連接現有的專案區域超鏈結。
- 遵循精靈中的指示,來設定您的連線。
範例
疑難排解:建議採用以下的問題管理技術。
- 一開始即使用空工作區。
- 用戶端和伺服器的建置必須相符。請確定在配送用戶端與伺服器時,兩者的建置 ID 相符。
- 確定伺服器已啟動。請使用以下的狀態 URL 來確認:https://example.com:9443/jazz。
- 在 Linux 上,如果您想從 JazzInstallDir/client/eclipse 目錄外來啟動用戶端,必須變更 JazzInstallDir/client/eclipse/links/ 中的每一個檔案,並包含所指名目錄的絕對路徑。依預設,會採用相對路徑。例如 JazzInstallDir/client/eclipse/links/build.link
含有 "path=jazz/build" 文字。如果您的用戶端安裝在 /home/username/teamconcert 目錄,請將檔案編輯成類似如下:"path=/home/username/teamconcert/jazz/client/eclipse/build"。
下一步
在順利安裝用戶端後,應參考下列主題,以協助您開始進行
Rational Team Concert。
升級至 Rational Team Concert 2.0
一般而言,您可以執行 zip 或 IBM Installation Manager 安裝,來升級 Rational Team Concert 用戶端與伺服器。
註:
如果您使用 IBM Installation Manager 將 Rational Team Concert 2.0 安裝在
目前未安裝 Rational Team Concert 的電腦上,Installation Manager 會提示您選取要安裝的語言。而如果您是從舊版更新成
2.0,IBM Installation Manager 會假設您希望使用現行語言,而不會提示您選取語言。如果要選取其他的語言,在您更新成 2.0 之後,請從 IBM Installation Manager 的主畫面選取
修改,然後選取供應項目。下個畫面會顯示支援的語言清單。請選取您需要的語言。
在您更新成 2.0 之後,如果您是在選取修改來新增或移除語言之前,就啟動 Jazz™ Team Server,則必須按如下所示來重設伺服器:
- 在 Web 瀏覽器中,導覽至 https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset。
- 按一下要求伺服器重設。
- 關閉伺服器。
然後您可以在 IBM Installation Manager 中選取修改,來新增或移除語言。
升級 Rational Team Concert Client for Eclipse IDE
如果您具有 Client for Eclipse IDE 1.0、1.0.1 或 1.0.1.1 版,則必須取得 2.0 用戶端,才能連接新的 2.0 版伺服器。您可以使用 zip 檔來安裝這項,或更新您先前的
IBM Installation Manager 安裝。
安裝 Rational Team Concert Client
for Microsoft Visual Studio IDE
如果您具有 Client for Microsoft Visual Studio IDE 1.0.1.1 版,則必須取得 2.0 用戶端,才能連接新的 2.0 版伺服器。
記住:
不提供
Client for Microsoft Visual Studio 的 .zip 檔。如果要安裝或升級至 2.0 版,必須使用 IBM Installation Manager。
將伺服器從「試用版」或「體驗版」升級至「永久版」
如果您執行的是
Rational Team Concert 體驗版,請先升級至 2.0 試用版。
從 2.0 試用版開始,伺服器可變成「永久版」,其做法是購買和安裝適合您版本的「伺服器啟動套件」,此套件可在 http://www.ibm.com/software/awdtools/rtc/ 中找到。啟動套件由一個 JAR 檔組成,內含「永久版」伺服器金鑰。您可以使用伺服器管理 Web 介面的「授權金鑰管理」頁面來安裝它。
從 1.0、1.0.1 或 1.0.1.1 升級伺服器
您可以從 Rational Team Concert 舊版,直接升級至 2.0 版。如果是從 1.x 更新成 2.x,就必須移轉資料庫。
註:
在您開始升級 WebSphere® Application Server 之前,請導覽至
https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset,並按一下要求伺服器重設,以重設伺服器。
如果您是從 zip 檔安裝舊版,則不會提供先前安裝的相關指示。您可以從 zip 將 2.0 版安裝在新位置,或使用 IBM Installation Manager 來安裝一個 2.0 實例。
如果當初您使用 IBM Installation
Manager 來安裝舊版,則可以將 2.0 安裝成個別的實例,或者將舊有實例更新成 2.0。
如果您想針對 2.0 版安裝個別的伺服器實例,請在安裝精靈的安裝套件頁面上,選取建立新套件群組。
註:
如果要升級
Jazz Team Server 的 WebSphere Application Server 部署,請移除舊有的 jazz.war 檔,並部署 2.0 jazz.war 檔。
如需完成升級,請參閱複製先前伺服器安裝中的必要配置檔和安裝 2.0 啟動金鑰。
將伺服器從 Rational Team Concert 某種版本升級成另一種
您可以在 Rational Team Concert版本之間升級。
一般的升級包括從 Express-C 升級至 Express™,或從 Express 升級至 Standard。您也可以遵循相同的程序以相反的方向降級。
由於所有的
Rational Team Concert 2.0 版皆支援 Derby 資料庫,如果您是從 Express-C 升級至 Express 或 Standard,則不需從 Derby 移轉至 DB2® 或 Oracle。建議您先移轉伺服器版本,並確定透過現有資料庫能平順地運作事物,然後再視需要執行資料庫移轉。如需執行資料庫移轉的相關資訊,請參閱在升級 Jazz Team
Server 之後移轉 Jazz 儲存庫。
如果您已安裝
Rational Team Concert 2.0 版且希望升級成另一版,請下載和安裝新版本(和現有的版本並排),然後複製必要的配置檔以執行新版本。以下的小節說明您需要的配置檔。
如果您是從 zip 檔來安裝先前的版本,則不會提供先前安裝的相關指示。您可以從 zip 將新版本安裝在新位置,或使用 IBM Installation Manager 來安裝新版本。如果是正式作業伺服器,建議您使用 IBM Installation Manager,以便能夠套用未來的更新項目。
如果您曾用過 IBM Installation Manager 來執行先前的伺服器安裝,而想使用 IBM Installation Manager 來安裝新版本,在新的 Installation Manager 安裝期間,請勿覆蓋掉先前的版本。在安裝精靈的安裝套件頁面上,選取建立新套件群組。
這會將新版本安裝在不同的位置中,並使用新的套件群組名稱來建立程式的捷徑。
如果您不執行這項作業,安裝將因檔案衝突而失敗。如果您看到標題為安裝失敗的對話框,表示發生此情況,其詳細資料的文字如下:
安裝失敗。
「安裝」階段期間發生錯誤:
無法解壓縮 zip 標準 1.0.1.I20081018-1820。檔案
D:\JazzTeamServer\server\license-update-site\site.xml 已存在。
如果發生此情況,它並不嚴重;您可以重新啟動安裝,並正確地建立新套件群組。
WebSphere Application
Server 配置更新項目
必須執行下列步驟,以便在 Rational Team Concert 2.0 中,適當配置 WebSphere Application
Server。
- 確定已安裝 WAS 與 WASDK 最新的修正套件。如果是在 WAS 7.0 中部署,至少必須安裝 WebSphere Application Server 7.0.0.3。
- 移除舊的自訂 JVM 內容:
- com.ibm.team.repository.provision.profile
- com.ibm.team.server.configURL
- log4j.configuration
- 新增自訂 JVM 內容 JAZZ_HOME,並將值設為:
file:///<JazzInstallDir>/server/conf
- 確定已勾選「當存取不受保護的 URI 時,使用可用的鑑別資料」這項 WAS 安全設定。如果您使用
WAS Integrated Solutions Console,則可以採行下列做法:
- 導覽至「安全 -> 安全管理、應用程式和基礎架構 -> Web 安全 - 一般設定」。
- 選取「當存取不受保護的 URI 時,使用可用的鑑別資料」勾選框。
複製先前伺服器安裝中的必要配置檔
將下列檔案從來源伺服器複製至目標伺服器。首先,將已升級伺服器中的原始檔案重新命名,以建立備份。如果您使用 IBM Installation Manager 從 1.0、1.0.1 或 1.0.1.1 更新至 2.0,則會在安裝位置的 server 子目錄中,以 backup-config-timestamp 等之類的名稱,建立一個內含 1.0.x 配置檔的備份目錄。
如果您正在升級至 Standard 或 Enterprise Edition,且已購買 Express 版「開發人員用戶端啟動套件」,請購買並安裝 Standard 或 Enterprise Edition 的「開發人員用戶端啟動套件」,如此便能使用這些用戶端授權。您的「開發人員」授權指派仍舊有效,但「開發人員」授權將會停用,直到您安裝正確的啟動套件為止。
安裝 2.0 啟動金鑰
2.0 版本使用 2.0 啟動金鑰。如果伺服器是從 1.0.x.x 升級至 2.0,在升級之後會回復成試用軟體授權,而您必須從 Passport Advantage® 取得 2.0 啟動金鑰。以下是各套件的適當金鑰名稱:
- IBM Rational Team Concert Express Edition - 伺服器授權啟動套件 2.0 多平台版 (jazz_team_server_express_release.jar)
- IBM Rational Team Concert Express Edition - 開發人員用戶端授權啟動套件 2.0 多平台版 (rtc_express_developer_unlocked.jar)
- IBM Rational Team Concert - 貢獻者用戶端授權啟動套件 2.0 多平台版 (rtc_all_contributor_unlocked.jar)
- IBM Rational Team Concert Standard Edition - 伺服器授權啟動套件 2.0 多平台版 (jazz_team_server_standard_release.jar )
- IBMRational Team Concert 開發人員用戶端授權啟動套件 2.0 多平台版 (rtc_standard_developer_unlocked.jar)
- IBM Rational Team Concert 浮動開發人員用戶端授權啟動套件 2.0 多平台版 (rtc_standard_floating_developer_unlocked.jar)
- IBM Rational Team Concert - 浮動貢獻者用戶端授權啟動套件 2.0 多平台版 (rtc_standard_floating-developer_unlocked.jar)
- IBMRational Team Concert Enterprise Edition - 伺服器授權啟動套件 2.0 多平台版 (jazz_team_server_enterprise_release.jar )
設定專案時間表
在 Rational Team Concert 1.x 中,專案可以有多份時間表(舊稱「開發線」),且這些時間表皆會視為同等。
在 Rational Team Concert 2.0 中,專案仍可以有多份時間表,但是可將其中一個標示為「專案時間表」。當將資料庫移轉至 2.0 時,並不會知道專案的主要時間表,因此,您的專案將不會設定一個專案時間表。在升級至 2.0 之後,您可以手動更新專案以設定專案時間表。
配置來源控制 Snapshot
「資料倉儲」的「來源控制管理 (SCM)」Snapshot 會收集串流中的資料,包括串流大小與其中的活動(變更集與檔案/資料夾變更)等相關資訊。在 1.0 版中,這個 Snapshot 會自動收集所有串流的相關資訊。這樣的作業頗耗成本,因此 2.0 版中的 SCM Snapshot 多了可配置選項,可讓使用者決定應收集哪些串流的資料。這項變革的立即影響是除非您配置它,否則並不會收集資料。
如果要配置 SCM Snapshot,請執行下列動作:
- 對於您要收集其資料的串流,您必須具備寫入權。
- 移至 Web 使用者介面中的報告頁面。
- 在左導覽畫面中,選取管理 SCM Snapshot。這時會顯示一份串流清單。
- 選取一或多個串流的勾選框,然後選取儲存變更。
這樣就會在後續所有的 Snapshot 中,收集所選串流的資料。
不相容的 BIRT 報告變更
如果您已使用 BIRT 報告設計程式來建立自己的報告範本,當您嘗試在 2.0 版中使用這些報告時,可能會遇到一或多個問題。您應注意下列問題:
- 對 Java 與 JavaScript 類別解析順序的變更。如果您已在 BIRT 報告中撰寫 JavaScript 程式碼,並使用 importPackage() 陳述式來匯入
java.lang 套件,要注意的是,如果程式碼中原本用來參照 Java 類別的「物件」參照不完整,現在可能會參照 JavaScript 類別(因而無法適當運作)。而在 JavaScript 與 Java 兩邊名稱相同的其他類別
(例如 java.util.Date),可能會有相同的問題。解決方案是完整定義 Java 類別的參照,並移除 importPackage() 陳述式。
- 對資料集處理的變更。過去,單獨一個將元素(例如「標籤」)連結至資料集的動作,就會造成系統在呈現元素時,全盤處理資料集。這是頗為方便的做法,因為這表示只要按照資料集應處理的順序,來使用連結至它們的(隱藏)標籤,就可以強制施行所要的資料集處理順序。現在,這樣的連結只會處理資料集中的第一列。如果要採行以往的行為,請使用「動態文字」元素,並呼叫某些會強迫處理整個資料集的 JavaScript 程式碼。Total.count()
就是一個好的選擇。
- BIRT 報告設計程式錯誤可能造成資料遺失。當您使用 BIRT 2.3.2(亦即 RTC 2.0)報告設計程式,來開啟在 BIRT 2.2.2
(亦即 RTC 1.0)中建立的 BIRT 報告設計檔時,就會出現這些問題。
已觀察到的問題如下:
- 當第一次使用 BIRT 2.3.2 編輯資料集時,在「參數」頁面中,「預設值」與「報告參數」欄位可能遺失。暫行解決方法是重新輸入值,或者從舊版編輯器複製並貼上值。在儲存已輸入新值的檔案之後,就不會再發生問題。
- 當第一次使用 BIRT 2.3.2 編輯報告設計檔時,報告參數的預設值可能遺失。在前述問題之後,也可能會發生這個問題。暫行解決方法是重新輸入值,或者從舊版編輯器複製並貼上值。在儲存已輸入新值的檔案之後,就不會再發生問題。
如果不注意,這些問題可能會很嚴重,因為報告所收集的資料可能不正確。在第一次使用 BIRT 2.3.2 報告設計程式來編輯報告時,最好能夠檢查每一個資料集與每一個報告參數。如果是以 BIRT 2.3.2 工具來建立的新報告,就不會發生這些問題。
上述的變更都是針對 Rational Team Concert 2.0 的所有現成報告 -
您這邊不需要執行任何動作。不過,如果您已使用我們的現成報告,在您的專案區域中手動建立報告範本,且尚未指定適當的 ID(與我們的用法一致),則您的報告範本在移轉時並不會重新整理。亦即,其內容不會是最新的,且將無法運作。在該情況下,您應使用適當的現行 .rptdesign 檔,上傳受影響範本的新內容。
匯入資料倉儲中的工作項目資料
在 Rational Team Concert 2.0,資料倉儲中的工作項目表格做了一些綱目變更。因此,當從 1.0 移轉至 2.0 時,匯入器會忽略倉儲中的任何工作項目資料。如此一來,在您第一次啟動 2.0 伺服器時,您的工作項目報告可能無法正確運作。暫行解決方法是等待第一次執行工作項目 Snapshot,或者在您啟動伺服器之後,手動讓它執行。在移轉之後的第一次執行時,工作項目 Snapshot 會重新建構資料倉儲中的整個歷程工作項目資訊。這也意味著移轉之後第一次執行 Snapshot 時,耗費的時間比夜間執行的平均時間來得久。
探索新報告
在 Rational Team Concert 2.0 中,新增了一些報告。儘管這些報告會出現在產品隨附的新程序範本中,但在移轉時,並不會自動將它們新增至現有的專案區域。我們新增了一個動作,來協助您在移轉之後於現有的專案區域中,探索與部署這些新的報告範本。如果要部署新報告範本,請執行下列動作:
- 在 Rich 用戶端中,開啟團隊構件視圖。
- 展開您的專案區域,然後展開報告。
- 用滑鼠右鍵按一下報告範本,並選取部署新範本。
對話框會協助您探索任何可用但尚未部署至您專案區域的報告範本。您可以從中選取一或多個,以便建立它們。在建立之後,您可以使用可用的功能表動作,從這些範本來建立新報告。
自訂
當您從 1.x 升級至 2.0 時,會保留您對工作項目類型、屬性、工作流程、角色與事件處理程式的變更。如果您曾自訂預先定義的程序範本(例如
Scrum),要注意的是,如果您重新部署預先定義的範本(在「程序範本」視圖中),將會改寫您的自訂內容。如果您需要重新部署預先定義的範本,應先變更您已自訂之預先定義範本的名稱與 ID,這樣就不會遭到改寫。
在設定了 Security-Enhanced Linux 的情況下安裝 Rational Team Concert
若有啟用 Security-Enhanced Linux (SELinux),您必須停用它,或者變更安裝和執行 Rational Team Concert 時所用的 Java™ 執行時期環境 (JRE),以容許重新定位文字。
執行這項作業的原因和時機
如果您設定機器的目的只在於評估 Rational Team Concert,且 SELinux 特性對您來說不重要,則繼續進行最簡單的方法是停用 SELinux。
註:
- 在 Red Hat Enterprise Linux 5 上,依預設會安裝和啟用 SELinux。
- SELinux 不會安裝在 Suse Linux Enterprise Server 10 或 Suse Linux Enterprise
Desktop 10 上。
- 如果要停用 SELinux,請執行下列之一:
- 從視窗系統:
- 選取系統 -> 管理 -> 安全層次和防火牆。
- 切換至 SELinux 標籤。
- 將 SELinux 設定變更為「停用」。
- 按一下確定,儲存新設定。
- 從指令行:
- 執行 "setup" 指令(這是 /usr/bin/setup)
- 選取防火牆配置,然後按 Enter 鍵。
- 使用 Tab 鍵和方向鍵,將 SELinux 變更為「停用」。
- 選取確定,然後按 Enter 鍵。
-
如果要變更 JRE 的安全環境定義,請執行下列動作:
-
如果您直接從 DVD 媒體安裝,請跳到步驟 2。否則,請變更安裝 JRE 的安全環境定義。
- 在安裝檔案目錄中,找出 jre 目錄 (linux/jre_5.0.2.sr5_20070511/jre)。如果您將安裝檔案解壓縮至
/tmp/rtc,則 jre 目錄位於
/tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre。
- 針對 jre 目錄執行 chcon -R -t textrel_shlib_t 指令。這個指令會遞迴地處理檔案,並容許重新定位文字。例如,如果您將安裝檔案解壓縮至 /tmp/rtc,請執行下列指令:
chcon -R -t textrel_shlib_t /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre
-
安裝 Rational Team Concert 伺服器、用戶端和連接器,但不要啟動它們。
- 在啟動 Rational Team Concert 之前,您必須先變更產品 JRE 的安全環境定義。針對您安裝的每一項產品,執行相同的指令 (chcon -R -t textrel_shlib_t) ,並使用合適的產品特定 JRE 目錄。以下列出預設目錄。
註:
如果您是以使用者 root 身分來安裝產品,則這些路徑為預設路徑。如果您以非 root 使用者身分來安裝,請在安裝使用者起始目錄中的 opt/IBM 結構內,尋找這些目錄。
- IBM Installation Manager:
- /opt/IBM/InstallationManager/eclipse/jre_5.0.2.sr5_20070511/jre
- Jazz Team
Server:
- /opt/IBM/JazzTeamServer/server/linux/ibm-java2-i386-50/jre
- Rational Team Concert - 用戶端(對這 4 個目錄都執行 chcon)
- /opt/IBM/TeamConcert/jdk/bin
- /opt/IBM/TeamConcert/jdk/lib
- /opt/IBM/TeamConcert/jdk/jre/bin
- /opt/IBM/TeamConcert/jdk/jre/lib
- Rational Team Concert - Build System Toolkit:
- Rational Team Concert - ClearCase® Connector:(對這 4 個目錄都執行 chcon)
- /opt/IBM/ClearCaseConnector/jdk/bin
- /opt/IBM/ClearCaseConnector/jdk/lib
- /opt/IBM/ClearCaseConnector/jdk/jre/bin
- /opt/IBM/ClearCaseConnector/jdk/jre/lib
- Rational Team Concert - ClearQuest® Connector:
- /opt/IBM/ClearQuestConnector/gateway/linux/ibm-java2-i386-50/jre