設定 WebSphere Application Server

這個主題說明如何設定 Jazz™ Team Server 以搭配 WebSphere® Application Server 運作。這項設定會假設您是將 Jazz Team Server 安裝在和 Websphere Application Server 相同的機器上。
開始之前
在開始進行這些步驟前,應先完成下列:
提示: 當使用 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 使用者介面需要配置鑑別,才能執行鑑別並將應用程式個人化。
  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.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/ 下載這些檔案。

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

    1. 按一下伺服器 > 應用程式伺服器.
    2. 按一下 server1
    3. 按一下 Java 和程序管理 > 程序定義
    4. 按一下 Java 虛擬機器
    5. 起始資料堆中,新增值 100。
    6. 資料堆大小上限中,新增值 1000。
    7. 按一下套用
    8. 按一下記載和追蹤。按一下變更日誌的詳細程度Jazz Team Server 採用 BIRT 報告引擎。如果要防止將 BIRT 參考項目寫入至 WebSphere 日誌檔,請將 org.eclipse.birt.* 套件的日誌記載層次設定為嚴重。按一下套用
    9. 按一下自訂內容
    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. 按一下應用程式 > 安裝新應用程式
    3. 新應用程式的路徑下,按一下本端檔案系統。
    4. 完整路徑下輸入:
      JazzInstallDir/server/jazz.war
    5. 環境定義根目錄設定為 /jazz。
    6. 下一步,並繼續進行其餘的安裝新應用程式步驟。
    7. 按一下完成
    8. 按一下儲存,以直接儲存至主要配置。
    9. 按一下應用程式 > 企業應用程式
    10. 選取 jazz_war 旁的方框;按一下啟動

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

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

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

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

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


意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤