設定 WebSphere Application Server

這個主題說明如何設定 Jazz™ Team Server 以搭配 WebSphere® Application Server 運作。這項設定會假設您是將 Jazz Team Server 安裝在和 Websphere Application Server 相同的機器上。這些指令是以 WebSphere Application Server 6.1.0.23 版為基礎。7.0.0.7 版以及更新版本方面會有些微的變異。這些變異會在適當情況以文字註明。

開始之前

在開始進行這些步驟前,應先完成下列:
提示: 當使用 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 使用者介面需要配置鑑別,才能執行鑑別並將應用程式個人化。

程序

  1. 檢閱並更新 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) 而定。
  2. 驗證或更新 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/ 下載這些檔案。

  3. 更新 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 安裝目錄:

    1. 按一下伺服器 > 應用程式伺服器.
    2. 按一下 server1
    3. 按一下 Java 和程序管理 > 程序定義
    4. 按一下 Java 虛擬機器
    5. 起始資料堆中,新增值 100。
    6. 資料堆大小上限中,新增值 1000。
    7. 按一下套用
    8. 按一下記載和追蹤。按一下變更日誌的詳細程度Jazz Team Server 採用 BIRT 報告引擎。如果要防止將 BIRT 參考項目寫入至 WebSphere 日誌檔,請將 org.eclipse.birt.* 套件的日誌記載層次設定為嚴重。按一下套用
    9. 按一下應用程式伺服器 > {server_name} > 程序定義 > Java 虛擬機器 > 自訂內容 您必須新增的其中一個自訂內容是 JAZZ_HOME,這個系統內容指定某些配置檔的所在位置。這個內容使用 URL 而非簡式路徑,因此應將值指定為 file://-style URL。
    10. 新增下列內容: 按一下新建;輸入名稱;然後按一下「確定」。
      • 名稱:java.awt.headless :true
      • 名稱:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin : true
      • 名稱:JAZZ_HOME :file:///JazzInstallDir/server/conf
    11. 按一下儲存,以直接儲存至主要配置。
    重要: (只適用於 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"。
  4. 重新啟動 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
    1. 開啟您 WebSphere Application Server 的管理主控台。
    2. 按一下應用程式 > 安裝新應用程式。(若為 WebSphere Application Server 7.0.0.7 以及更新版本,請按一下應用程式 > 新建應用程式 > 新建企業應用程式。)
    3. 新應用程式的路徑下,按一下本端檔案系統。
    4. 完整路徑下輸入:
      JazzInstallDir/server/tomcat/webapps/jazz.war
    5. 環境定義根目錄設定為 /jazz,然後按下一步
      註: 在 WebSphere Application Server 7.0.0.7 以及更新版本中,這個步驟會在安裝快要結束時出現。
    6. 下一步,並繼續進行其餘的安裝新應用程式步驟。
    7. 按一下完成
    8. 驗證已安裝 jazz_war 應用程式,然後按一下儲存,以直接儲存到主要配置。
    9. 按一下應用程式 > 企業應用程式
    10. 選取 jazz_war 旁的方框;按一下啟動

      此時應會出現綠色箭頭,指出已順利啟動應用程式。

      註: 剩下的步驟純粹針對 Rational Quality Manager
    11. 回到安裝新應用程式頁面。
    12. 在本端檔案系統上,瀏覽至 help.war 檔的位置,並且選取檔案。輸入 /help 作為環境定義根目錄,然後按下一步
      註: 您可以在 JazzInstallDir\server\tomcat\webapps\help.war 找到 help.war 檔。
    13. 連續點選下一步,直到您看到「摘要」畫面,然後按一下完成,來安裝新的應用程式。
    14. 驗證已安裝 help_war 應用程式,然後按一下儲存,將所做的變更儲存到主要配置檔。
    15. 按一下應用程式 > 企業應用程式
    16. 選取 help_ war,並且按一下啟動

下一步

在啟動伺服器之後,請繼續進行執行設定精靈

如需這個主題的相關資訊,請造訪下列鏈結:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ


意見