這個主題說明如何設定 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 虛擬機器。
- 在起始資料堆中,新增值 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
- 按一下儲存,以直接儲存至主要配置。
- 重新啟動 WebSphere,以安裝 Jazz 應用程式
在下列的指令行範例中,
WASInstallDir
代表 WebSphere Application Server 在您伺服器上的安裝位置。
- 開啟您 WebSphere Application Server 的管理主控台。
- 按一下。
- 在新應用程式的路徑下,按一下本端檔案系統。
- 在完整路徑下輸入:
JazzInstallDir/server/jazz.war
- 將環境定義根目錄設定為 /jazz。
- 按下一步,並繼續進行其餘的安裝新應用程式步驟。
- 按一下完成。
- 按一下儲存,以直接儲存至主要配置。
- 按一下。
- 選取 jazz_war 旁的方框;按一下啟動。
此時應會出現綠色箭頭,指出已順利啟動應用程式。