這個主題說明如何設定 Jazz™ Team
Server 以搭配
WebSphere® Application
Server 運作。這項設定會假設您是將 Jazz Team
Server 安裝在和 Websphere Application Server 相同的機器上。這些指令是以
WebSphere Application Server 6.1.0.23 版為基礎。7.0.0.7 版以及更新版本方面會有些微的變異。這些變異會在適當情況以文字註明。
開始之前
在開始進行這些步驟前,應先完成下列:
- 已安裝 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 安全 - 一般設定」。(在 WAS 7.0.0.7 中,導覽至「安全」->「廣域安全」->「Web 與 SIP 安全」->「一般設定」。)
- 選取「當存取不受保護的 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 來搭配使用
Rational® Team Concert 時,可將
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.7)。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 虛擬機器上進行一些特定的設定。
「通用 JVM」引數中第一個必須設定的內容是預設最大記憶體配置,使用的是 -Xmx 設定。這應根據伺服器支援的團隊大小以及
Jazz Team
Server 執行所在的伺服器記憶體容量來設定。一般中等大小的團隊可使用值 -Xmx1536M,這是提供 1536 MB 的資料堆記憶體給 Jazz Team
Server 程序。
「通用 JVM」引數中第二個必須設定的內容(特別針對 Rational Quality Manager)是執行緒堆疊大小。Rational Quality Manager 的堆疊大小通常是
-Xss786K。
如果您連接 Oracle 或 SQL Server 資料庫,還需新增一個名為 "ORACLE_JDBC" 或 "SQLSERVER_JDBC" 的內容。請將這個內容設定為 JDBC 驅動程式的絕對檔案路徑
(非 URL)。
下列範例顯示連接 Oracle 與 SQL Server 資料庫時所用的「通用 JVM」引數,以及預設的最大記憶體配置和執行緒堆疊大小。請將 JazzInstallDir 替換成您的
Jazz Team
Server 安裝目錄。
-DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
-DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k
為了控制某些伺服器行為,還必須設定其他一些系統內容。它們會在下文中提及。以下是在
「WebSphere 管理主控台」中設定這些 JVM 內容的細節說明。請將 JazzInstallDir 替換成您的
Jazz Team
Server 安裝目錄:
- 按一下.
- 按一下 server1。
- 按一下 。
- 按一下 Java 虛擬機器。
- 在起始資料堆中,新增值 100。
- 在資料堆大小上限中,新增值 1000。
- 按一下套用。
- 按一下記載和追蹤。按一下變更日誌的詳細程度。Jazz Team
Server
採用 BIRT 報告引擎。如果要防止將 BIRT 參考項目寫入至 WebSphere 日誌檔,請將 org.eclipse.birt.* 套件的日誌記載層次設定為嚴重。按一下套用。
- 按一下應用程式伺服器 > {server_name} > 程序定義 > Java 虛擬機器
> 自訂內容。 您必須新增的其中一個自訂內容是
JAZZ_HOME,這個系統內容指定某些配置檔的所在位置。這個內容使用 URL 而非簡式路徑,因此應將值指定為 file://-style URL。
- 新增下列內容: 按一下新建;輸入名稱和值;然後按一下「確定」。
- 名稱:java.awt.headless 值:true
- 名稱:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 值:
true
- 名稱:JAZZ_HOME 值:file:///JazzInstallDir/server/conf
- 按一下儲存,以直接儲存至主要配置。
- 重新啟動 WebSphere,以安裝 Jazz 應用程式。
在下列的指令行範例中,
WASInstallDir
代表 WebSphere Application Server 在您伺服器上的安裝位置。
- 開啟您 WebSphere Application Server 的管理主控台。
- 按一下。(若為 WebSphere Application Server
7.0.0.7 以及更新版本,請按一下。)
- 在新應用程式的路徑下,按一下本端檔案系統。
- 在完整路徑下輸入:
JazzInstallDir/server/tomcat/webapps/jazz.war
- 將環境定義根目錄設定為 /jazz,然後按下一步。
註: 在 WebSphere Application Server 7.0.0.7 以及更新版本中,這個步驟會在安裝快要結束時出現。
- 按下一步,並繼續進行其餘的安裝新應用程式步驟。
- 按一下完成。
- 驗證已安裝 jazz_war 應用程式,然後按一下儲存,以直接儲存到主要配置。
- 按一下。
- 選取 jazz_war 旁的方框;按一下啟動。
此時應會出現綠色箭頭,指出已順利啟動應用程式。
註: 剩下的步驟純粹針對 Rational Quality Manager。
- 回到安裝新應用程式頁面。
- 在本端檔案系統上,瀏覽至 help.war 檔的位置,並且選取檔案。輸入 /help 作為環境定義根目錄,然後按下一步。
註: 您可以在 JazzInstallDir\server\tomcat\webapps\help.war 找到 help.war 檔。
- 連續點選下一步,直到您看到「摘要」畫面,然後按一下完成,來安裝新的應用程式。
- 驗證已安裝 help_war 應用程式,然後按一下儲存,將所做的變更儲存到主要配置檔。
- 按一下。
- 選取 help_ war,並且按一下啟動。
下一步
如果您是
Rational Team Concert 使用者,請繼續進行
執行設定精靈主題。若為
Rational Quality Manager,請繼續進行「在 WebSphere Application Server 上配置 LDAP」主題,然後進行「執行 Jazz Team
Server 設定精靈」主題。
如需這個主題的相關資訊,請造訪下列鏈結:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ