WebSphere Application Server 上部署 Design Management Server

您可以在 WebSphere® Application Server(而非伺服器隨附的 Apache Tomcat 伺服器)上部署 Design Management Server。這些指示基於 WebSphere Application Server 8.0 版或更新版本,稍微不同於 7.0 版。

開始之前

重要: 當使用 WS-Security 時,可能會發生安全外洩;這可能導致使用者取得更多的專用權。這會影響使用 JAX-WS 及 JAX-RPC 的應用程式。如需如何取得及安裝此安全修補程式的完整詳細資料,請讀取這個新聞 Flash。此外,考量透過「我的通知」訂閱 WebSphere Application Server 更新項目;從而您將接收到安全相關的更新項目及修補程式通知。
請確保已正確設定環境:

關於這項作業

如果是使用部門拓蹼或企業拓蹼,則將需要為該機器上執行的每個伺服器及應用程式配置 WebSphere Application Server。

程序

  1. WebSphere Application Server 管理主控台中,指定下列安全設定:
    1. 如果要確認已關閉 Java™ 2 安全,請按一下安全 > 廣域安全,並清除使用 Java 2 安全來限制應用程式存取本端資源勾選框。
    2. 現行領域定義欄位中,確定已配置適當的安全領域並將其設定為現行領域。然後,選取啟用管理安全啟用應用程式安全勾選框。
    3. 按一下安全 > 廣域安全,然後在鑑別下,按一下 Web 和 SIP 安全 > 一般設定,並選取當存取不受保護的 URI 時,使用可用的鑑別資料勾選框。
  2. 指定 WebSphere Application Server 的 Java 虛擬機器設定:
    1. 在管理主控台中,按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器,然後按一下您的伺服器。依預設,此伺服器的名稱為 server1
    2. 伺服器基礎架構下,按一下Java 和處理程序管理 > 程序定義
    3. 其他內容下,按一下 Java 虛擬機器 (JVM)
    4. 起始資料堆大小欄位中,指定 4096 用於資料堆大小和 JVM 引數的數字只是建議;請根據自己的環境來設定這個值。一般中型團隊可以使用 4096 MB 作為值,在至少具有 8 GB 實體記憶體上的 64 位元電腦上,給 Jazz Team Server 程序提供 4 GB 資料堆記憶體。務必對「起始資料堆」和「資料堆大小上限」使用相同的數量。在增加 Java 資料堆大小時,請確定機器上未用的實體記憶體量足以涵蓋增加量。如果沒有足夠的實體記憶體,請安裝額外的記憶體,或是將對整體效能的影響納入考量。此外,實體記憶體務必要比所結合機器上所有程序的需求量還多,以免發生分頁或交換。分頁會降低系統效能,並影響 Java 記憶體管理系統的效能。
    5. 資料堆大小上限欄位中,指定伺服器的記憶體上限(以 MB 為單位)。對於 64 位元電腦,請指定適用於您環境的記憶體數量,如 4096 即 4GB 記憶體。
    6. 一般 JVM 引數欄位中,新增下列項目:
      作業系統 使用者輸入
      Windows -Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G
      Linux -Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G
      AIX -Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xnocompressedrefs -XX:MaxDirectMemorySize=1G
      提示:如果需要更大的資料堆大小,則可以使用下列設定,並將 {N} 取代為要使用的記憶體數量,以及將 {N/8} 取代為總記憶體的 1/8。比方說,如果 -Xmx 設為 8G,則 -Xmn 應該設為 1G。-Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8} -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G
    7. 按一下套用
    8. 在「Java 虛擬機器」頁面的其他內容下,按一下自訂內容
    9. 按一下新建,然後指定 JAZZ_HOME 內容,此內容可識別 Design Management Server 的配置檔位置,包括 jtsdm 資料夾。
      此內容使用 URI(而不是簡式檔案路徑),且一律以 file:/// 開頭。Windows 系統上的預設位置如下:
      file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf
      在 Linux 系統上,預設位置如下:
      file:///opt/ibm/JazzTeamServer/server/conf
      註: 為避免發生問題,請勿在檔案路徑中使用空格。對於 Windows 32 位元安裝上的 Program Files 資料夾,您可以使用 PROGRA~1;對於 Windows 64 位元安裝上的 Program Files (x86) 資料夾,您可以使用 PROGRA~2
    10. 再次按一下新建,然後指定名為 log4j.configuration 的內容。使用 startup_log4j.properties 檔的位置作為值。 此內容使用的格式與 JAZZ_HOME 內容的格式相同。在大多數情況下,此檔案在 JAZZ_HOME 資料夾中。Windows 系統上的預設值如下:
      file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf/startup_log4j.properties
      Linux 系統上的預設值如下:
      file:///opt/ibm/JazzTeamServer/server/conf/startup_log4j.properties
      註: 在啟動處理程序的早期階段使用 startup_log4j.properties 中的設定,以將訊息傳遞至 SystemOut.log 檔案。在早期階段之後,每一個應用程式都會切換為使用 server/conf/<app_context>/log4j.properties 檔案中應用程式特定的設定。
    11. 再次按一下新建,然後指定名為 java.awt.headless 的內容,且值為 true
    12. 再次按一下新建,然後指定名為 org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 的內容,且值為 true
    13. 如果使用的是 SQL Server 資料庫,請再次按一下新建,並為 SQLSERVER_JDBC_DRIVER_FILE 內容指定 sqljdbc4.jar 檔的位置。
    14. 如果使用的是 Oracle 資料庫,請再次按一下新建,並為 ORACLE_JDBC_DRIVER_FILE 內容指定 ojdbc5.jar 檔的位置。
    自訂內容的外觀與下圖類似。請注意,除您新增的內容之外,依預設還會顯示其他部分內容。
    Java 虛擬機器內容的範例
  3. 儲存對主要配置所做的變更,然後重新啟動 WebSphere Application Server
    現在,伺服器已準備部署 Design Management Server 應用程式檔案。
    註: 在 UNIX 或 Linux 系統上,如果在非根環境中安裝 WebSphere Application Server,安裝 Design Management Server 的使用者必須對安裝目錄及其所有子目錄具有讀寫權限。
  4. 安裝 Jazz Team Server 應用程式:
    1. 在管理主控台中,按一下應用程式 > 新建應用程式 > 新建企業應用程式
    2. 新應用程式的路徑下,按一下瀏覽以指定 jts.war 檔的位置,然後按下一步 如果在安裝 Design Management Server 時未安裝 Apache Tomcat,則此檔案的預設位置為 installDir/server/webapps。如果已安裝 Tomcat,則預設位置為 installDir/server/tomcat/webapps
    3. 您要如何安裝應用程式?下,按一下捷徑,然後按下一步
    4. 在「步驟 1:選取安裝選項」頁面上,接受預設選項,然後按下一步
    5. 在「步驟 2:將模組對映至伺服器」頁面上,選取 <app>.war 旁邊的勾選框(其中 <app> 是所要安裝應用程式的名稱),確保目標伺服器或叢集是正確的,然後按下一步
    6. 在「步驟 3:對映 Web 模組的虛擬主機」頁面上,選取 <app>.war 旁邊的勾選框,然後按下一步
    7. 在「步驟 4:對映 Web 模組的環境定義根目錄」頁面上,將環境定義根目錄設為 /<app>,其中 <app> 是應用程式環境定義根目錄。比方說,如果安裝 dm.war,則環境定義根目錄可以是 dm,然後按下一步
    8. 按一下完成
  5. 視您要在伺服器上安裝的應用程式而定,針對下列 WAR 檔及相對應的環境定義根目錄,重複安裝步驟:
    選項 敘述
    dm.war(Design Management 應用程式) /dm
    admin.war(Jazz Team Server 應用程式) /admin
    vvc.war(Design Management 應用程式) /vvc
    rdmhelp.war(Design Management 應用程式) /rdmhelp
    clmhelp.war(Jazz Team Server 應用程式) /clmhelp
    rsadm.war(Design Management 應用程式) /rsadm
    vvchelp.war(「配置管理」應用程式) /vvchelp
    jts.war(Jazz Team Server 應用程式) /jts
  6. 在包含 Jazz Team Server (jts.war) 的伺服器上,將需要對映 WebSphere Application Server 上的安全角色。將 Jazz Team Server 應用程式的安全角色對映至安全領域中的使用者和群組。 設定安全超出此作業的範圍,但在廣域安全領域使用 LDAP 登錄的大部分情況下,您可以將 LDAP 登錄中的群組對映至應用程式的下列安全角色:
    • JazzAdmins
    • JazzDWAdmins
    • JazzProjectAdmins
    • JazzGuests
    • JazzUsers
    1. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式 > jts_war
    2. 詳細內容下,按一下使用者/群組對映的安全角色 此頁面顯示您必須對映至安全領域中使用者或群組的 Design Management Server 的使用者群組。
    3. 選取角色,然後按一下對映群組以將該角色對映至安全領域中的群組。
      註: 請勿啟用所有已鑑別項?選項。
  7. 驗證已順利安裝應用程式,然後儲存對 WebSphere Application Server 的主要配置所做的變更。
  8. 新增下列階段作業管理自訂內容,以避免在使用者登出而不終止階段作業時出現 SESN0008E 錯誤訊息。
    1. 在 WebSphere Integrated Solutions Console 中,按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器
    2. 按一下 server1,然後在「儲存器設定」區段中,按一下「階段作業管理」。
    3. 在「其他內容」區段中,按一下自訂內容
    4. 按一下「新建」並輸入下列資訊:名稱:InvalidateOnUnauthorizedSessionRequestException 值:true
    5. 按一下套用並直接儲存到主要配置。
  9. 儲存至主要配置之後,停止並重新啟動伺服器。
  10. WebSphere Application Server 管理主控台中,按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式以確認所有應用程式都在執行中。

結果

應用程式旁邊會顯示綠色箭頭,以指示已正確啟動應用程式。

下一步

現在,您可以依照設定及配置 Design Management Server中的說明,配置 Design Management Server

意見