設定 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. 修改 profile.ini 和 license-profile.ini 檔：

    編輯 JazzInstallDir/server/provision_profiles/ 中的每一個設定檔，並設定 URL 內容的絕對路徑。

    例如，
    • 變更此行：
      url=file:./update-site
    • 使其類似如下：
      url=file:/opt/IBM/JazzTeamServer/server/update-site
    註: JazzInstallDir/server/provision_profiles/ 目錄只能包含隨附的 .ini 檔，而不得包含任何備份檔。某些編輯器會自動儲存備份檔，因而必須移除。
  2. 檢閱並更新 teamserver.properties 檔中的資料庫位置 
    com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
  3. 驗證或更新 WebSphere Application Server 層次。

    Jazz Team Server 需要已套用 IBM Java SDK 1.5 SR5（或以上）累加修正程式的 WebSphere Application Server 6.1 版。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 錯誤"。

  4. 更新 JVM 引數。

    Jazz Team Server 需要在其執行所在的 Java 虛擬機器上進行一些特定的設定。

    首先，它需要知道伺服器和 log4j（伺服器所用的記載架構）的配置檔位置。其做法是設定 com.ibm.team.server.configURL 和 log4j.configuration 系統內容。這些內容使用 URL 而非簡式路徑，因此應將值指定為 file://-style URL。

    Jazz JVM 所需的第二個內容是使用 -Xmx 設定，為它提供比預設最大記憶體配置還多的記憶體。這應根據伺服器支援的團隊大小以及 Jazz Team Server 執行所在的伺服器記憶體容量來設定。一般中等大小的團隊可使用值 -Xmx1000M，這是提供 1000 MB 的資料堆記憶體給 Jazz Team Server 程序。

    如果您連接 Oracle 資料庫，還需新增一個名為 "ORACLE_JDBC" 的內容。請將這個內容設定為 Oracle 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. 新增下列內容： 按一下新建；輸入名稱和值；然後按一下「確定」。
      • 名稱：com.ibm.team.repository.provision.profile 值：file:///JazzInstallDir/server/provision_profiles （形同檔案 URL）
        註: com.ibm.team.repository.provision.profile 內容必須指向內含 provision_profiles 的目錄。
      • 名稱：com.ibm.team.server.configURL 值：file:///JazzInstallDir/server/teamserver.properties （形同檔案 URL）
      • 名稱：log4j.configuration 值：file:///JazzInstallDir/server/log4j.properties（形同檔案 URL）
      • 名稱：java.awt.headless 值：true
      • 名稱：org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 值： true
    11. 按一下儲存，以直接儲存至主要配置。
  5. 重新啟動 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 旁的方框；按一下啟動。

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

下一步
在啟動伺服器之後，請繼續進行執行設定精靈。
上層主題: 啟動伺服器
意見