使用 IBM Installation Manager 來安裝 IBM Rational Team Concert Standard Edition 或 Enterprise Edition
安裝 Rational Team Concert Standard Edition 與 Enterprise Edition
升級至 Rational Team Concert 2.0.0.2
一般而言,您可以執行 zip 或 IBM® Installation Manager 安裝,來升級 Rational Team Concert™ 用戶端與伺服器。
註:
如果您使用 IBM Installation Manager 將 Rational Team Concert 2.0.0.2 安裝在
目前未安裝 Rational Team Concert 的電腦上,Installation Manager 會提示您選取要安裝的語言。而如果您是從舊版更新成
2.0.0.2,IBM Installation Manager 會假設您希望使用現行語言,而不會提示您選取語言。如果要選取其他的語言,在您更新成 2.0.0.2 之後,
請從 IBM Installation Manager 的主畫面選取
修改,然後選取供應項目。下個畫面會顯示支援的語言清單。請選取您需要的語言。
在您更新成 2.0.0.2 之後,
如果您是在選取修改來新增或移除語言之前,
就啟動 Jazz™ Team Server,則必須依照下面的指示重設伺服器:
- 在 Web 瀏覽器中,導覽至
https://<server-host>:<jazz-port>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
- 按一下要求伺服器重設。
- 關閉伺服器。
然後您可以在 IBM Installation Manager 中選取修改,來新增或移除語言。
Rational Team Concert 用戶端與伺服器的相容性
下表顯示
Rational Team Concert 用戶端版本與
Jazz Team Server 版本的相容性。
表 1. 用戶端與伺服器的相容性
Rational Team Concert 用戶端版本 |
相容的 Jazz Team Server 版本 |
1.0.x for Eclipse |
0.6.x |
2.0.x for Eclipse |
1.0.x |
2.0.0.0 for Microsoft Visual Studio |
1.0.0.0 |
2.0.x for Microsoft Visual Studio |
1.0.x |
升級 Rational Team Concert Client for Eclipse IDE
如果您具有 Client for Eclipse IDE 1.0、1.0.1 或 1.0.1.1 版,
則必須取得 2.0.x 用戶端,才能連接新的 2.0.x 版伺服器。您可以使用 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.x 用戶端,才能連接新的 2.0.x 版伺服器。
記住:
不提供
Client for Microsoft Visual Studio 的 .zip 檔。如果要安裝或升級至 2.0.x 版,必須使用 IBM Installation Manager。
將伺服器從「試用版」或「體驗版」升級至「永久版」
如果您執行的是
Rational Team Concert 體驗版,請先升級至 2.0.0.2 試用版。
從 2.0.0.2 試用版開始,
伺服器可變成「永久版」,其做法是購買和安裝適合您版本的「伺服器啟動套件」,此套件可在 http://www.ibm.com/software/awdtools/rtc/ 中找到。啟動套件由一個 JAR 檔組成,內含「永久版」伺服器金鑰。您可以使用伺服器管理 Web 介面的「授權金鑰管理」頁面來安裝它。
從 1.0、1.0.1 或、1.0.1.1 或 2.0 升級伺服器
您可以從 Rational Team Concert 舊版,直接升級至 2.0.0.2 版。如果是從 1.x 更新成 2.x,就必須移轉資料庫。如需執行資料庫移轉的相關資訊,
請參閱升級 Jazz Team Server 之後移轉 Jazz 儲存庫。
註:
在您開始升級 WebSphere® Application Server 之前,請導覽至
https://{servername}:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset,
並按一下要求伺服器重設,以重設伺服器。
如果您是從 zip 檔安裝舊版,則不會提供先前安裝的相關指示。您可以從 zip 將 2.0.0.2 版安裝在新位置,
或使用 IBM Installation Manager 來安裝一個 2.0.0.2 實例。
如果當初您使用 IBM Installation
Manager 來安裝舊版,則可以將 2.0.0.2 安裝成個別的實例,或者將舊有實例更新成 2.0.0.2。
如果您想針對 2.0.0.2 版安裝個別的伺服器實例,請在安裝精靈的安裝套件頁面上,選取建立新套件群組。
註:
如果要升級
Jazz Team Server 的 WebSphere Application Server 部署,請移除舊有的 jazz.war 檔,
並部署 2.0.0.2 jazz.war 檔。
如需完成升級,請參閱複製先前伺服器安裝中的必要配置檔和安裝 2.0.0.2 啟動金鑰。
將伺服器從 Rational Team Concert 某種版本升級成另一種
您可以在 Rational Team Concert版本之間升級。
一般的升級包括從 Express-C 升級至 Express™,或從 Express 升級至 Standard。您也可以遵循相同的程序以相反的方向降級。
由於所有的
Rational Team Concert 2.0.0.2 版皆支援 Derby 資料庫,如果您是從 Express-C 升級至 Express 或 Standard,則不需從 Derby 移轉至 DB2® 或 Oracle。建議您先移轉伺服器版本,並確定透過現有資料庫能平順地運作事物,然後再視需要執行資料庫移轉。請注意,
Derby 資料庫只支援 10 位使用者。如需執行資料庫移轉的相關資訊,
請參閱 升級 Jazz Team Server 之後移轉 Jazz 儲存庫。
如果您已安裝
Rational Team Concert 2.0.0.2 版且希望升級成另一版,請下載和安裝新版本(和現有的版本並存),然後複製必要的配置檔以執行新版本。以下的小節說明您需要的配置檔。
如果您是從 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.0.2 中,適當配置 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 更新至 2.0.0.2,
則會在安裝位置的 server 子目錄中,
以 backup-config-timestamp 等之類的名稱,建立一個內含 1.0.x 或 2.0 配置檔的備份目錄。
如果您正在升級至 Standard 或 Enterprise Edition,且已購買 Express 版「開發人員用戶端啟動套件」,請購買並安裝 Standard 或 Enterprise Edition 的「開發人員用戶端啟動套件」,如此便能使用這些用戶端授權。您的「開發人員」授權指派仍舊有效,但「開發人員」授權將會停用,直到您安裝正確的啟動套件為止。
安裝 2.0.0.2 啟動金鑰
2.0.0.2 版本使用 2.0.0.2 啟動金鑰。如果伺服器是從 1.0.x.x 升級至 2.0.x,
在升級之後會回復成試用軟體授權,而您必須從 IBM Rational License Key Center 取得 2.0 或 2.0.0.2 啟動金鑰。
如需
IBM Rational License Key Center 的相關資訊,請參閱 IBM Rational 授權支援網站與相關的 jazz.net 技術提示。
以下是各套件的適當金鑰名稱:
- IBM Rational Team Concert Express Edition 伺服器啟動套件 2.0 版、2.0.0.2 版
- IBM Rational Team Concert Standard Edition 伺服器啟動套件 2.0 版、2.0.0.2 版
- IBM Rational Team Concert Enterprise Edition 伺服器啟動套件 2.0 版、2.0.0.2 版
- IBM Rational Team Concert 貢獻者用戶端存取啟動套件 2.0 版、2.0.0.2 版
- IBMRational Team Concert 開發人員用戶端存取啟動套件 2.0 版、2.0.0.2 版
- IBM Rational Team Concert Express Edition 開發人員用戶端存取啟動套件 2.0 版、2.0.0.2 版
- IBM Rational Team Concert 浮動貢獻者用戶端存取啟動套件 2.0 版、2.0.0.2 版
- IBM Rational Team Concert 浮動開發人員用戶端存取啟動套件 2.0 版、2.0.0.2 版
設定專案時間表
在 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,這樣就不會遭到改寫。
Standard 與 Enterprise Edition 安裝概觀
預設配置包括:
註:
線上說明所提供的選用,有助您選擇配置以及記錄您的決策。
準備安裝 Standard 或 Enterprise Edition
在安裝伺服器之前,請驗證是否已符合特殊的注意事項。
針對 Linux 的特殊指示
如果 Jazz Team
Server 是安裝在 Linux 上,請檢閱下列的特殊指示。
從 IBM Installation Manager 安裝 Standard 或 Enterprise Edition
執行這項作業的原因和時機
Jazz Team
Server、Rational Team Concert 用戶端、Build System Toolkit、 ClearCase® Connector、ClearQuest® Connector 和其他的 Incubator 檔案皆可從
http://jazz.net 下載。如果要購買 Rational Team Concert,請移至 http://www.ibm.com/software/awdtools/rtc/,其中,您可以下載可安裝的映像檔,或訂購 DVD。
- 下載下列其中一個安裝套件。請選擇目標安裝平台。
使用 IBM Installation Manager 來安裝
Rational Team Concert Standard Edition 或 Enterprise Edition 時,您有兩種方法可選。
- Installation Manager 的用戶端、伺服器和選用元件 Web 安裝方式:
這個保存檔含有 Installation Manager 啟動程式和預先定義的安裝儲存庫位置。這是一個自行解壓縮檔,它會在解壓縮內容後,啟動 IBM Installation Manager 啟動程式。使用 Web 安裝套件的好處是,它可減少起始下載的大小,且安裝程序只會下載您選擇要安裝的資源。
註:
Web 安裝在安裝程序期間需要網際網路連線。
- 完整 DVD 內容 .zip 檔:這種保存檔含有 Installation Manager 啟動程式和所有可安裝資源的本端副本。使用本端安裝套件的好處是,安裝可在沒有網際網路連線下繼續進行。這不是一個自行解壓縮的 .zip 檔。
- 啟動啟動程式。
如果 Installation Manager 不在執行中,請啟動它。
註:
您必須具備管理者專用權,才能執行啟動程式。
- 如果您使用 Installation Manager Web 安裝方式,請執行執行檔。檔案會解壓縮至目錄,並出現啟動程式。
- 如果您使用完整 DVD 內容 .zip 檔,請將保存檔內容解壓縮至一個暫存目錄,並執行啟動程式。
- 如果要在 Windows 上執行檔案,請執行下列指令:
launchpad.exe
- 如果要在 Linux 上執行檔案,請執行下列指令:
sh launchpad.sh
-
當啟動程式啟動時,您會看到要安裝的項目清單。請按照所列出的順序,來安裝您想使用的每一個套件。
- 安裝 Jazz Team
Server。
當使用 IBM Installation Manager 時,請在安裝程序期間記下「位置」頁面上的安裝目錄。該目錄稱為 JazzInstallDir。
註:
如果您打算使用現有的應用程式伺服器,而不使用隨附的 Apache Tomcat 伺服器,請清除 Apache Tomcat 套件勾選框。如此做只會安裝搭配現有應用程式伺服器使用時所需的檔案。Installation Manager 會提示您選擇這些檔案的安裝位置。
- 選用:安裝 DB2 Workgroup
Server。
註:
雖然預設配置已包含
Derby 資料庫而不需安裝,但這個資料庫無法支援超過 10 個的使用者。如果您想支援 10 個以上的使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,請安裝搭售的 DB2 Workgroup Server 版本。
如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team
Server 的配置。
- 安裝 Rational Team Concert 用戶端。
- 選用:安裝 Build System Toolkit。
- 選用:安裝 ClearCase Connector。
- 選用:安裝 ClearQuest Connector。
設定資料庫
捷徑:
如果您使用內含的 Derby 資料庫,則不需額外的設定。請繼續進行
啟動伺服器。
設定資料庫的概觀步驟如下:
- 建立資料庫。
- 配置內容檔。
- 建立資料庫表格。
如果您使用任何支援的 DB2 版本,請繼續進行設定 DB2 資料庫。
如果您使用 Oracle,請繼續進行設定 Oracle 資料庫。
如果您使用 SQL Server,請繼續進行設定 SQL Server 資料庫。
設定 DB2 資料庫
設定支援的 DB2 或搭售的 DB2 Workgroup
Server 資料庫,以使用 Jazz Team
Server。
開始之前
本程序假設已符合下列必備條件。相關說明請參閱您的 DB2 文件,或向您的 DB2 資料庫管理者 (DBA) 查詢。
- 檢閱 DB2 文件,驗證您的系統符合需求條件且配置正確。
- DB2 已安裝在作為資料庫伺服器的機器上,並且正在執行。這部機器可以不是
Jazz Team
Server 執行所在的機器。
- 您已檢閱特殊的 DB2 指示。
- 執行這些指示的使用者對
DB2 資料庫具備管理者權限。
提示:
在 Linux 上,
如果要取得 DB2 資料庫的系統管理者權限,請以 DB2 使用者身分
db2inst1 執行
sudo,
並執行 bash。請注意,
db2inst1 是預設實例使用者。您可以使用下列指令來檢查並維護您的資料庫:
db2start:啟動 DB2(在 UNIX 上,實例擁有者必須執行這個指令)。
db2stop:停止 DB2。
db2sysc process:使用這個指令來檢查 DB2 程序是否正在執行。對於一般的資料庫使用量,請確定您已提供 2 GB RAM 給 DB2 程序使用。
reorg
indexes/table:index 選項會將索引資料重建至未片段化且實際上是連續的分頁中,來重組表格中所定義的所有索引。table 選項則會重新建構列來刪除片段的資料,並且壓縮資訊,
以便重組表格。
runstats:更新表格實體性質和相關聯索引的相關統計資料。這些性質包括記錄數、分頁數,以及平均的記錄長度。最佳化工具在判斷資料的存取路徑時,
就會使用這些統計資料。當表格含有許多更新項目,或是在重組表格之後,
就應該呼叫這個公用程式。
db2 backup:使用這個指令來備份您的資料庫。如果指令順利完成,則您會獲得新的備份映像檔,
並且放在您發出指令的所在路徑或目錄中。
執行這項作業的原因和時機
如果要設定 DB2 資料庫,請執行下列動作:
- 在「DB2 指令視窗」中建立資料庫。 範例指令會建立一個名為 JAZZ 的新資料庫。這些指令在「DB2 指令視窗」中執行。「指令視窗」可透過應用程式「啟動」功能表下的
「DB2 指令行工具」功能表來開啟。
註:
為了確保能適當處理 Unicode 內容,資料庫字集必須採 UTF-8 編碼。在 Windows 中,由於預設的 4K 分頁大小放不下 AUDITABLE_LINKS 表格,請將分頁大小至少設為 8K。
提示:
如果資料庫不在執行中,db2start 指令會啟動 DB2。
- 在 JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.properties 檔,並重新命名為 teamserver.derby.properties。
- 在 JazzInstallDir/server/conf/jazz 目錄中找出
teamserver.db2.properties 檔,並重新命名為 teamserver.properties。
- 在 teamserver.properties 檔中指定資料庫和連線的詳細資料。
預設連線規格是連接在 localhost 埠 50000 上執行的 DB2 資料庫。資料庫名稱為
JAZZ,而使用者名稱與密碼皆為 db2admin。如果您在設定資料庫時使用預設值,可能已正確配置
teamserver.properties 檔。如果不是,請變更這項資訊,以符合您的配置。
- 以文字編輯器開啟 teamserver.properties 檔。
- 找出下列字行:
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
- 在 com.ibm.team.repository.db.jdbc.location 中,編輯您的 DB2 伺服器和資料庫值。
提示:
在「DB2 指令視窗」中,執行 db2 get dbm cfg 指令,並找出內含 SVCENAME 的字行,其中會指出 DB2 埠名或埠號。如果這個指令顯示號碼,請用來作為埠號(以取代上述範例中的 50000)。如果指令傳回非數值的名稱,請判斷指派給這個名稱的埠號,然後使用該埠號。在 Linux 中,/etc/services 檔含有埠名和埠號之間的對映,而在 Windows 中,C:\windows\system32\drivers\etc\services 檔含有這項對映。如需相關資訊,請詢問您的資料庫管理者或查閱資料庫文件。
- 在 com.ibm.team.repository.db.jdbc.location 中,編輯您的 DB2 使用者名稱值。
註:
DB2 使用者必須具備建立表格、表格空間以及修改資料庫配置的許可權。DB2 使用者由作業系統建立。
- 在 com.ibm.team.repository.db.jdbc.password 內容中指定使用者密碼。
註:
請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。
- 必要的話,請將 com.ibm.team.repository.db.db2.content.tablespace.location 內容變更為
Jazz Team
Server 中一個可建立主要表格空間的路徑。
註:
如果沒有變更預設值 (content_tablespace),會將表格空間建立在資料庫儲存區位置下。在 Windows 中,如果要指定新路徑,必須使用雙反斜線來指定,例如 com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace。
特殊的 DB2 指示
註:
這個主題所列出的指令純為範例。如需詳細資料,請參閱您的產品文件。
註:
當在 DB2 中建立資料庫時,需要 8 KB 分頁大小。
檢閱 DB2 文件,驗證您的系統符合需求條件且配置正確。
如果要充分利用狀態選擇提取最佳化(可在大型資料庫上提升效能),DB2 使用者必須設定 DB2_OPTPROFILE。請執行下列指令,來設定
DB2_OPTPROFILE。
db2set DB2_OPTPROFILE=YES
db2stop
db2start
註:
在執行指令後,請停止並重新啟動資料庫。安裝程序中的某個後續步驟會要求您停止再啟動資料庫。如果您剛開始安裝,接下來,可重新啟動資料庫。
請確定已接連執行上述指令。如果要查看是否已設定,請執行下列指令:
db2set DB2_OPTPROFILE
設定 Oracle 資料庫
設定 Oracle 資料庫以搭配 Jazz Team
Server 運作。
開始之前
在此假設已符合下列的必備條件。相關說明請參閱您的 Oracle 文件,或向 Oracle 資料庫管理者 (DBA) 查詢。
當在 Oracle 中執行 Jazz Team
Server 時,請建立 Oracle 表格空間以提升效能。您必須建立一個鏈結至該表格空間的使用者。
記住:
這些步驟皆不是由資料庫建置者使用儲存庫工具來執行。
執行這項作業的原因和時機
如果要設定 Oracle 資料庫,請執行下列動作:
-
建立表格空間。 表格空間位置必須適合機器和磁碟機。這個步驟必須由具備 DBA 專用權的使用者來執行。
註:
表格空間可以具備下列任何內容:
- oracle_tbs 以外的名稱
- 另一個目錄中的位置
- 大小超過 1GB。如果是大型安裝,必須配置更多的空間。
下列範例顯示在 Windows 機器上執行的 create 陳述式:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
重要:
目錄路徑(以本例來說是 D:\oracle_tbs)必須存在。不需建立個別的特殊表格空間。您可以使用 Oracle 預設
USERS 表格空間,不過,如果能在它所管理的磁碟上預先配置一個空間,Oracle 的效能會更好。
- 建立 Oracle 使用者。
在建立表格空間後,必須為
Jazz 建立一個特殊的 Oracle 使用者,以使用 Oracle 資料庫。
在本例中,使用者的名稱為 jazzDBuser,密碼(以 Oracle 詞彙來說是 IDENTIFIED BY)為 jazzDBpswd,且其存在於您在1中所建立的表格空間中。
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs;
在建立使用者之後,
應授與使用者在起始設定 Jazz 資料庫時所需的必要許可權。以下的 SQL 指令可用來授與適當的許可權:
GRANT CREATE SESSION TO jazzDBuser;
GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
GRANT CREATE PROCEDURE TO jazzDBuser;
GRANT CREATE VIEW TO jazzDBuser;
- 在 JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.properties 檔,並重新命名為 teamserver.OtherDBProvider.properties。
- 在 JazzInstallDir/server/conf/jazz 目錄中找出
teamserver.oracle.properties 檔,並重新命名為 teamserver.properties。
提示:
重新命名原始
teamserver.properties 檔可讓您將檔案還原成先前的工作版本。依預設,「資料庫提供者」為 derby。
- 配置伺服器
- 如果您使用不同的使用者名稱、密碼或資料庫名稱、將 Oracle 伺服器安裝在 Jazz Team Server 以外的機器上,或者使用非預設埠,請編輯伺服器配置檔。開啟 JazzInstallDir/server/conf/jazz 目錄中的 teamserver.properties 檔,並變更下列資訊以符合您的設定。
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
將 jazzDBuser 變更為建立給 Jazz 以使用 Oracle 資料庫的使用者。如果您使用本端主機,請移除位於字行開頭的 #,以解除註解該字行,並且註解下一個位置行。本端主機連線字串不應包含前導的 //。請將 1521 變更成您 Oracle 伺服器機器的 TCIP 埠。將 ORCL 變更為您的 Oracle 資料庫名稱。
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
記住:
Oracle 位置 URL 可有多種格式。這裡的範例對於大部分情況都適用。如需詳細資料,請參閱 Oracle JDBC 文件。
如果您使用非本端主機連線,請移除位於字行開頭的 #,以解除註解該字行,並且註解下一個位置行。非本端主機連線字串必須包含前導的 //。
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
將 jazzDBpswd 變更為建立給 Jazz 以使用 Oracle 資料庫的使用者密碼。
重要:
請勿變更
com.ibm.team.repository.db.jdbc.location 內容中的
{password} 文字。com.ibm.team.repository.db.jdbc.password 內容中必須指定使用者密碼。
如果您使用 Oracle Express,請使用 1521 作為 TCIP 埠,以及使用 XE 作為 Oracle 資料庫名稱:
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
-
在和伺服器 Script 相同的目錄中 (JazzInstallDir/server),
建立一個名為 oracle 的目錄。
- 找出 Oracle JDBC 驅動程式 JAR 檔 ojdbc14.jar。位置可能因 Oracle 產品和作業系統而有不同。將這個檔案複製至
oracle 目錄。
註:
如果您使用 WebSphere Application
Server,請配置名稱為 "ORACLE_JDBC" 的內容;然後將它設定為內含 Oracle JDBC 驅動程式的絕對目錄路徑(非 URL),
例如,如果您的 ojdbc14.jar 位於
JazzInstallDir/server/oracle 之下。這項作業會在
WebSphere Application Server 設定指示中說明。記下檔案路徑,以便之後在這些指示中使用。
- 開啟 SQL plus 視窗,並輸入下列指令:
GRANT DBA TO jazzDBuser;
設定 SQL Server 資料庫
設定 SQL Server 資料庫,以搭配 Jazz Team Server 運作。
本程序假設您已符合下列的必備條件:
記住:
在 JazzInstallDir/server/teamserver.properties 檔中,所定義的 SQL Server 資料庫預設登入名稱是 jazzDBuser,預設密碼是 jazzDBpswd。在建立資料庫時,會在以下的步驟中使用這些值。您可以將這些值換成您資料庫的使用者名稱與密碼。
設定資料庫
本節說明如何使用 SQL Server 安裝提供的指令行工具
sqlcmd,來設定 SQL Server 資料庫。您也可以使用視覺化工具,以 SQL Server Studio Management 為例,就可以當成 SQL Server Studio Management Express 在
Express 版中使用。如需相關資訊,請參閱 SQL Server 文件或詢問 SQL Server 資料庫管理者 (DBA)。
如果要使用
指令工具 sqlcmd 來設定 SQL Server 資料庫,請執行下列動作:
- 建立 Jazz Team Server 資料庫。請從指令行工具鍵入:
CREATE DATABASE jazz
GO
- 建立使用者和密碼,並變更 Jazz Team Server 資料庫的所有權。請從指令行工具鍵入:
CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBpswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
GO
- 建立 Jazz Team Server 資料庫對照。請從指令行工具鍵入:
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
GO
配置伺服器
記住:
依預設,JazzInstallDir/server 目錄中的
teamserver.properties 檔不是設定成連接 SQL Server 資料庫。所有的預設值以及 SQL Server 特定的設定全包含在同一目錄的
teamserver.sqlserver.properties 檔中。
如果要配置伺服器,請執行下列動作:
- 重新命名下列檔案:
- 將 JazzInstallDir/server/conf/jazz/teamserver.properties 檔重新命名為
teamserver.OtherDBProvider.properties
- 將 teamserver.sqlserver.properties 檔重新命名為 teamserver.properties
提示:
重新命名原始
teamserver.properties 檔可讓您將檔案還原成先前的工作版本。依預設,「資料庫提供者」為 derby。
- 如果您使用不同的使用者名稱、密碼或資料庫名稱、將 SQL Server 安裝在 Jazz Team Server 以外的機器上,或者使用非預設埠,請編輯伺服器配置檔。開啟 JazzInstallDir/server/conf/jazz 目錄中的 teamserver.properties 檔,並變更下列資訊以符合您的設定。
com.ibm.team.repository.db.vendor = SQLSERVER
com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
重要:
請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。com.ibm.team.repository.db.jdbc.password 內容中必須指定使用者密碼。
重要:
僅適用於 Windows。請確定您的伺服器安全為混合模式。您可以檢查伺服器安全,來驗證此項。它應該設為「SQL Server 與 Windows 鑑別模式」。
如果要指定 JDBC 的 JAR 檔位置,請執行下列動作:
- 在和伺服器 Script 相同的目錄 (JazzInstallDir/server) 中,建立名為 sqlserver 的目錄。
- 找出名為 sqljdbc.jar 的 SQL Server JDBC 驅動程式 JAR 檔。如「必備條件」小節中所述,位置可能因驅動程式安裝所在而異。將檔案複製至新建的
sqlserver 目錄。
- 完成下列作業,以指定 JDBC 的 JDBC JAR 檔位置:
疑難排解
如果 repotools 指令沒有成功,請檢查 JazzInstallDir/server 目錄中名為 repotools_createTables.log 的日誌檔。
此外,請驗證下列:
- SQL Server 已配置成容許使用 TCP/IP 通訊協定來連線。
必要的話,請重新啟動 SQL 服務。
- teamserver.properties 檔中正確反映 SQL Server 機器的主機名稱和埠。
- teamserver.properties 檔中適當反映登入名稱、密碼和資料庫名稱。
- 防火牆不會妨礙您存取 SQL Server。請利用 telnet
指令,使用 teamserver.properties 檔中的主機名稱和埠,和機器進行 Telnet 連線。
- 所建立的使用者在 Jazz Team Server 資料庫中具備適當許可權。
註:
為了能在多種資料庫平台上執行,Jazz Team Server 的資料庫碼為通用和標準設計;不過,各企業資料庫供應商在語法、最佳化策略和鎖定語意方面仍有差異。在 SQL Server 上,已使用各種自動測試組合,並模擬正常的工作量和壓力測試,來測試伺服器。模擬正常工作量的結果,顯示效能是可接受的。在某些實例中,在自動化並行測試中觀察到資料庫死鎖;不過這些並未同樣重現上不同的伺服器硬體上。
依照設計,伺服器可服務大量的同步要求。在某些異常的情況中,儲存資料庫中可能發生死鎖,這是因為要求的相關聯交易中同時更新了類似或同等的物件。這類事件罕見但仍屬正常。
依照設計,系統會有相對的防禦措施,並維護資料完整性;資料不會遺失。建置引擎執行等之類的作業偶爾會記載死鎖。一般來說,偵測到狀況時,會重試作業。死鎖可能導致建置失敗。在某些相當罕見的情況中,可能是使用工作項目或原始碼等之類的使用者動作,而這可藉由中斷來解決死鎖。在該情況下,使用者動作將會失敗,並顯示內含死鎖詳細資料的錯誤給使用者。
之後使用者可重試該動作。
所遇到的所有死鎖都會記載在伺服器上,以提供發生死鎖時的相關現象資訊。日誌項目中的文字類似如下:com.ibm.team.repository.common.RetryableDatabaseException:
序列化失敗。
如果您的系統遇到死鎖,請參閱位於下列位置的錯誤日誌:https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog。
如果您常常遇到死鎖異常狀況,請聯絡您的產品支援人員,或檢查 jazz.net 論壇中的最新資訊、更新項目或移轉技術。
啟動伺服器
這個主題說明執行伺服器啟動 Script 時所用的各種選項。
執行這項作業的原因和時機
如果您打算使用隨附的 Apache Tomcat 應用程式伺服器,可準備啟動 Jazz Team
Server。
如果您計劃使用
WebSphere Application
Server,請按照設定 WebSphere Application Server 中的說明,來設定您的伺服器環境。
啟動 Apache Tomcat 伺服器
現在您可準備啟動 Apache Tomcat 伺服器。
Apache Tomcat 已安裝在 JazzInstallDir/server/tomcat 目錄。Web 應用程式
(jazz.war) 已安裝在
Apache Tomcat 目錄 webapps。在指令視窗中,將您的現行目錄設定為 JazzInstallDir/server。伺服器的啟動和關閉 Script 位於這個目錄中。
- 如果您想從其他任何目錄來執行啟動和停止 Script,必須變更 JazzInstallDir/server/conf/jazz/provision_profiles 中的 profiles.ini 檔,以使用絕對路徑。
- Apache Tomcat 在 JazzInstallDir/server/tomcat/conf/server.xml 檔中是配置成使用埠 9080 和 9443。必要時,請將它們變更成適合您的系統。此外若有必要,亦可在 Jazz 管理 Web 使用者介面的「進階內容」配置頁面中,更新 Jazz 伺服器儲存庫 HTTP 埠的配置設定。
- JazzInstallDir/server/logs 目錄含有伺服器日誌檔。如果您在啟動伺服器時遇到問題,請檢查日誌檔。
- JazzInstallDir/server/tomcat/conf/server.xml 檔含有 SSL 設定,其中指定了只適用於 IBM JRE 的演算法。如果要讓伺服器搭配 Sun JRE 執行,請在 server.xml 檔中變更 Connector port="9443" 的設定為 sslProtocol="TLS" 而非 "SSL"。此外,請移除 algorithm 參數。
在 Windows 上啟動伺服器
請執行啟動檔,以便在 Windows 上啟動您的伺服器。
執行這項作業的原因和時機
- 如果要啟動伺服器,請從 JazzInstallDir/server 目錄執行下列指令:
server.startup.bat
註:
這時會開啟個別的 Apache Tomcat 主控台視窗。請勿關閉此視窗,否則伺服器將停止運作。此外,會啟動數則參考訊息,包含有關 Apache Tomcat 原生程式庫的訊息。這些參考訊息不會影響
Jazz Team
Server 的功能。
- 如果要停止伺服器,請從 JazzInstallDir/server 目錄執行下列指令:
server.shutdown.bat
下一步
註:
上述範例是直接從
JazzInstallDir/server 目錄啟動和停止 Script。如果您是使用
IBM Installation Manager 來安裝 Jazz Team
Server,也可以從
Jazz Team
Server Windows 開始功能表來執行指令。
在啟動伺服器之後,請繼續進行執行設定精靈。
在 Linux 上啟動伺服器
執行這項作業的原因和時機
- 如果要啟動伺服器,請以 root 使用者身分從 JazzInstallDir/server 目錄執行下列指令:
./server.startup
如果您的使用者 ID 具備管理者存取權,請執行以下指令:
sudo ./server.startup
並不會顯現個別的 Apache Tomcat 主控台視窗。您可以檢視
JazzInstallDir/server/logs/jazz.log 中的日誌檔,以檢查伺服器啟動進度。
- 如果要停止伺服器,請以 root 使用者身分從 JazzInstallDir/server 目錄執行下列指令:
./server.shutdown
如果您的使用者 ID 具備管理者存取權,請執行以下指令:
sudo ./server.shutdown
下一步
註:
這個範例是直接從
JazzInstallDir/server 目錄啟動和停止 Script。如果您是使用
IBM Installation Manager 來安裝 Jazz Team
Server,也可以從
Jazz Team
Server 應用程式啟動功能表來執行指令。
在啟動伺服器之後,請繼續進行執行設定精靈。
設定 WebSphere Application Server
這個主題說明如何設定 Jazz Team
Server 以搭配
WebSphere Application
Server 運作。這項設定會假設您是將 Jazz Team
Server 安裝在和 Websphere Application Server 相同的機器上。
開始之前
在開始進行這些步驟前,應先完成下列:
- 已安裝 WebSphere Application
Server。
- 已建立資料庫,且已使用您的資料庫設定更新 teamserver.properties 檔。
- 啟用不區分大小寫登入方式(選用):如果應用程式伺服器的鑑別方法容許不區分大小寫登入方式,
就有可能讓 Jazz 應用程式接受它們。您也可以在「管理 Web 使用者介面」的「進階內容」頁面中,
透過「使用不區分大小寫的使用者 ID 比對」內容,來容許使用不區分大小寫登入方式。預設值不變;管理者必須明確置換這個內容,
才能啟用不區分大小寫登入方式。
- Java 2
Security 選項應該關閉。如果在 WebSphere Application Server 中開啟這個選項,會導致 Jazz Team
Server .war 啟動失敗。
- 確定已勾選「當存取不受保護的 URI 時,使用可用的鑑別資料」這項 WAS 安全設定。如果您使用
WAS Integrated Solutions Console,則可以採行下列做法:
- 導覽至「安全 -> 安全管理、應用程式和基礎架構 -> Web 安全 - 一般設定」。
- 選取「當存取不受保護的 URI 時,使用可用的鑑別資料」勾選框。
- Jazz Team
Server 含有執行完整 Apache Tomcat 型伺服器所需的檔案。如果要採用 WebSphere 安裝,只需要 Jazz Team
Server 檔案中的一組,且應將它們放在 WebSphere 伺服器機器上的一個目錄中。在進一步的指示中,會將它稱之為 Jazz Team
Server 安裝目錄,或者簡稱為 JazzInstallDir。從這個目錄,使用:
- JazzInstallDir/server/tomcat/webapps/jazz.war 檔。
- JazzInstallDir/server/update-site 目錄。
- JazzInstallDir/server/conf 目錄。
- JazzInstallDir/repositoryDB 中的預設儲存資料庫。
- JazzInstallDir/repotools 中的儲存庫工具。
- JazzInstallDirserver/license-update-site 目錄。
- JazzInstallDir/server/nl1-update-site 目錄。
- JazzInstallDir/server/nl2-update-site 目錄。
提示:
當使用
IBM Installation Manager 時,可將
Jazz Team
Server 檔案安裝至 Web 應用程式目錄。在安裝程序期間,不應安裝隨附的 Apache Tomcat 應用程式伺服器;這會使得 Installation Manager 要求提供一個 Web 應用程式目錄,而且只會安裝 WebSphere 所需的檔案。預設目錄是
C:\Program Files\IBM\JazzTeamServer(若為 Windows)或 /opt/IBM/JazzTeamServer
(若為 Linux)。在本程序中,安裝目錄稱為 JazzInstallDir。如果您使用 IBM Installation Manager,將檔案安裝至
WebSphere Application
Server Web 應用程式目錄,就不需按照上述說明手動移動檔案。
執行這項作業的原因和時機
註:
本文件不提及較複雜的
WebSphere 鑑別或 SSL 配置主題。有關
WebSphere 各種鑑別和加密選項的詳細資訊,可在「WebSphere 資訊中心」找到。如需相關資訊,請跳至
WebSphere 資訊中心,並搜尋
維護應用程式和其環境的安全 (Securing applications and their environment)。Jazz Web
使用者介面需要配置鑑別,才能執行鑑別並將應用程式個人化。
- 檢閱並更新 teamserver.properties 檔中的資料庫位置
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
註:
這是 DB2 配置範例。在更新 teamserver.properties 時,應視資料庫供應商 (Oracle/MS-SQL) 而定。
- 驗證或更新 WebSphere Application Server 層次。
Jazz Team
Server 要求必須已安裝套用了
IBM Java SDK 1.5 SR5(或更新版本)累加修正程式的 WebSphere Application Server 6.1 版,或是 WebSphere Application Server 7.0 版(且至少必須是 7.0.0.3)。IBM Java SDK
1.5 SR6 SDK 的更新可從 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 取得。如果使用 WebSphere 6.1 和 GA IBM Java SDK,Jazz
在執行一些作業後就會開始回報 "Proxy 錯誤"。
您必須取得 IBM Java SDK 1.5 SR9 或
IBM Java SDK 1.6 SR4 修正程式的對應 WebSphere Application Server 臨時修正程式,IBM Rational Team Concert 2.0 才能正確執行。否則,伺服器中的某些服務可能無法正確啟動。臨時修正程式可以在其對應的 WebSphere Application Server APAR 中取得。如果是 IBM Java SDK 1.5/WebSphere Application Server 6.1,APAR 為 PK85942,而您可以從 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/
下載這些檔案。在安裝 JRE 臨時修正程式之前,請至少先安裝 WebSphere Application Server 6.1 Fixpack 19。如果是
IBM Java SDK 1.6/WebSphere Application Server 7.0,APAR 是 PK 86771,而您可以從 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ 下載這些檔案。
- 更新 JVM 引數。
Jazz Team
Server 需要在其執行所在的 Java 虛擬機器上進行一些特定的設定。
首先,它需要知道某些配置檔的位置。做法是設定 JAZZ_HOME 系統內容。這個內容使用 URL 而非簡式路徑,因此應將值指定為 file://-style URL。
Jazz JVM
所需的第二個內容是使用 -Xmx 設定,為它提供比預設最大記憶體配置還多的記憶體。這應根據伺服器支援的團隊大小以及
Jazz Team
Server 執行所在的伺服器記憶體容量來設定。一般中等大小的團隊可使用值 -Xmx1536M,
這是提供 1536 MB 的資料堆記憶體給 Jazz Team
Server 程序。
如果您連接 Oracle 或 SQL Server 資料庫,還需新增一個名為 "ORACLE_JDBC" 或 "SQLSERVER_JDBC" 的內容。請將這個內容設定為 JDBC 驅動程式的絕對檔案路徑
(非 URL)。
您還需要設定另外兩個系統內容,以控制伺服器的某些行為;請見以下的說明。以下是在
WebSphere 管理主控台中設定這些 JVM 內容的細節說明,藉以將
JazzInstallDir 換成您的 Jazz Team
Server 安裝目錄:
- 按一下伺服器 -> 應用程式伺服器.
- 按一下 server1。
- 按一下 Java 和程序管理 -> 程序定義。
- 按一下 Java 虛擬機器。
- 在起始資料堆中,新增值 100。
- 在資料堆大小上限中,新增值 1000。
- 按一下套用。
- 按一下記載和追蹤。按一下變更日誌的詳細程度。Jazz Team
Server
採用 BIRT 報告引擎。如果要防止將 BIRT 參考項目寫入至 WebSphere 日誌檔,請將 org.eclipse.birt.* 套件的日誌記載層次設定為嚴重。按一下套用。
- 按一下自訂內容
- 新增下列內容: 按一下新建;輸入名稱和值;然後按一下「確定」。
- 名稱:java.awt.headless 值:true
- 名稱:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 值:
true
- 名稱:JAZZ_HOME 值:file:///JazzInstallDir/server/conf
- 在「儲存至主要配置」區段中,按一下儲存。
重要:
(只適用於 Solaris)您也必須新增下列的 Java 指令行引數:
-XX:MaxPermSize=256m
如需相關資訊,
請參閱
IBM WebSphere Application Server V6.1 on the Solaris
10 Operating System 紅皮書中的第 2 章 "Configuring a Solaris environment
for WebSphere Application Server"。
- 重新啟動 WebSphere,以安裝 Jazz 應用程式
在下列的指令行範例中,WASInstallDir
代表 WebSphere Application Server 在您伺服器上的安裝位置。
- 若為 Windows,WebSphere 安裝目錄的預設值為:
C:\Program Files\IBM\WebSphere\AppServer
您可以在
Windows 上,使用下列指令來重新啟動伺服器:
cd WASInstallDir\bin
stopServer.bat server1 [若為安全伺服器,請包含:-username {LDAP_User} -password {LDAP_Password}]
startServer.bat server1
- 若為 Linux,WebSphere 安裝目錄的預設值為:
/opt/IBM/WebSphere/AppServer
您可以在
Linux 上,使用下列指令來重新啟動伺服器:
cd WASInstallDir/bin
./stopServer.sh server1 [若為安全伺服器,請包含:-username {LDAP_User} -password {LDAP_Password}]
./startServer.sh server1
- 開啟您 WebSphere Application Server 的管理主控台。
- 按一下應用程式 -> 安裝新應用程式。
- 在新應用程式的路徑下,按一下本端檔案系統。
- 在完整路徑下輸入:
JazzInstallDir/server/jazz.war
- 將環境定義根目錄設定為 /jazz。
- 按下一步,並繼續進行其餘的安裝新應用程式步驟。
- 按一下完成。
- 按一下儲存,以直接儲存至主要配置。
- 按一下應用程式 -> 企業應用程式。
- 選取 jazz_war 旁的方框;按一下啟動。
此時應會出現綠色箭頭,指出已順利啟動應用程式。
下一步
在伺服器啟動之後,請繼續進行執行設定精靈。
如需這個主題的相關資訊,請造訪下列鏈結:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ
執行設定精靈
藉由執行設定精靈,可驗證伺服器的運作是否適當,並可引導您完成伺服器的配置步驟。
執行這項作業的原因和時機
如果要驗證 Jazz Team
Server 是否連接資料庫,請查看伺服器日誌或主控台輸出。連線和資料庫資訊會在其第一次存取時回應。
JazzInstallDir/server/logs 目錄是供伺服器日誌檔使用。
本程序假設使用 localhost 主機名稱和預設埠 9443,即可使用您的伺服器。必要的話,請將
localhost 換成您的伺服器主機名稱,並更換埠 9443。
啟動設定精靈,以配置您的伺服器。請使用 URL https://localhost:9443/jazz/setup。
預設使用者名稱和密碼有區分大小寫:
如果您有配置 LDAP 目錄 Web 儲存器,請使用定義在您 LDAP 目錄中的 JazzAdmin 使用者身分登入。
選擇設定路徑。設定精靈有兩條主要路徑。
當完成起始設定時,您可以使用 URL https://localhost:9443/jazz/admin,從 Jazz Team
Server 管理 Web 使用者介面來配置其他的選項。
下一步
如果伺服器設定精靈沒有載入,請檢查下列項目:
完成安裝
在安裝伺服器後,您必須考量某些配置選項,再繼續進行。
執行這項作業的原因和時機
在安裝之後,需額外執行少許動作。
- 某些檔案含有密碼。這些檔案應受到保護,而只供有權知道帳戶密碼的使用者讀取。
- 當使用 Rational Team Concert 用戶端或 Web 瀏覽器連接伺服器時,您可能會看到安全憑證警告。如果要停用警告,請參閱配置安全憑證設定。
- 如果您將應用程式伺服器配置成使用非預設埠,這些埠也應配置在 Jazz 配置中。當為了某些事項(例如:電子郵件通知中的資訊來源鏈結和項目鏈結)而撰寫 URL 時,會使用這些埠號。如果要更新預設值,請使用「管理 Web 使用者介面」中的進階內容配置頁面,來修改下列內容:
- com.ibm.team.repository.servlet.internal.ServletConfigurationService
- com.ibm.team.repository.service.internal.webuiInitializer.ConfigPropertyInitializer
- 現在您可準備使用 Rational Team Concert 用戶端或 Web 瀏覽器來連接伺服器。
使用 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。
您可以使用 IBM Installation Manager,將 Build System Toolkit 安裝在建置機器上。
執行這項作業的原因和時機
- 啟動啟動程式。
如果 Installation Manager 不在執行中,請啟動它。
註:
您必須具備管理者專用權,才能執行啟動程式。
- 如果您使用 Installation Manager Web 安裝方式,請執行執行檔。檔案會解壓縮至目錄,並出現啟動程式。
- 如果您使用完整 DVD 內容 .zip 檔,請將保存檔內容解壓縮至一個暫存目錄,並執行啟動程式。
- 如果要在 Windows 上執行檔案,請執行下列指令:
launchpad.exe
- 如果要在 Linux 上執行檔案,請執行下列指令:
sh launchpad.sh
- 當出現啟動程式時,請按一下 Build System Toolkit,以啟動安裝程序。
- 在安裝完成之後,即可配置建置。如需 Build System Toolkit 的進一步資訊,可在關於 Jazz Team Build 中找到。
使用 IBM Installation Manager 來安裝
Rational® Team Concert 的 ClearCase Connector
您可以使用 IBM Installation Manager,將 ClearCase Connector 安裝在建置機器上。
執行這項作業的原因和時機
- 啟動啟動程式。
如果 Installation Manager 不在執行中,請啟動它。
註:
您必須具備管理者專用權,才能執行啟動程式。
- 如果您使用 Installation Manager Web 安裝方式,請執行執行檔。檔案會解壓縮至目錄,並出現啟動程式。
- 如果您使用完整 DVD 內容 .zip 檔,請將保存檔內容解壓縮至一個暫存目錄,並執行啟動程式。
- 如果要在 Windows 上執行檔案,請執行下列指令:
launchpad.exe
- 如果要在 Linux 上執行檔案,請執行下列指令:
sh launchpad.sh
- 當出現啟動程式時,請按一下 ClearCase Connector,以啟動安裝程序。
- 在安裝完成後,請配置 ClearCase Connector。請參閱部署 ClearCase Connector。
使用 IBM Installation Manager 來安裝
Rational Team Concert 的 ClearQuest Connector
您可以使用 IBM Installation Manager,將 ClearQuest Connector 安裝在建置機器上。
執行這項作業的原因和時機
- 啟動啟動程式。
如果 Installation Manager 不在執行中,請啟動它。
註:
您必須具備管理者專用權,才能執行啟動程式。
- 如果您使用 Installation Manager Web 安裝方式,請執行執行檔。檔案會解壓縮至目錄,並出現啟動程式。
- 如果您使用完整 DVD 內容 .zip 檔,請將保存檔內容解壓縮至一個暫存目錄,並執行啟動程式。
- 如果要在 Windows 上執行檔案,請執行下列指令:
launchpad.exe
- 如果要在 Linux 上執行檔案,請執行下列指令:
sh launchpad.sh
- 當出現啟動程式時,請按一下 ClearQuest Connector,以啟動安裝程序。
- 在安裝完成後,請配置 ClearQuest Connector。請參閱部署 ClearQuest Connector。
在設定了 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