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