設定 Rational Engineering Lifecycle Manager 的 WebSphere Application Server

部署及啟動 Jazz™ Team Server,首先要選取管理 Jazz Team Server 及其應用程式的應用程式伺服器。 您必須先設定 WebSphere® Application Server,才能部署 Rational® Engineering Lifecycle Manager 應用程式 WAR 檔。

開始之前

請確定您已完成下列作業:

Jazz Web 介面需要配置鑑別,才能執行鑑別並將應用程式個人化。

註:
  • Rational Engineering Lifecycle Manager 1.x 版必須與「生命週期查詢引擎」共用一部應用程式伺服器。
  • Rational Engineering Lifecycle Manager 4.x 版可以與「生命週期查詢引擎」共用一部應用程式伺服器, 也可以部署到不同的應用程式伺服器上。不過,這兩個應用程式必須登錄到相同的 Jazz Team Server 中。

關於這項作業

本文件不提供配置 WebSphere 鑑別或 SSL 的詳細資料,那是一個較複雜的主題。「WebSphere Application Server 資訊中心」涵蓋了有關各種鑑別與加密選項的詳細資訊。如需相關資訊,請移至 WebSphere 資訊中心,在搜尋中使用這個詞組:維護應用程式和其環境的安全 (Securing applications and their environment)

程序

  1. Rational Engineering Lifecycle Manager 在所執行的「Java 虛擬機器」中,需要一些特定的設定。 如果要設定這些內容,在「WebSphere Integrated Solutions 主控台」中,按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 > Server1
  2. 在「伺服器基礎架構」之下,按一下 Java 和程序管理 > 程序定義
  3. 在「其他內容」之下,按一下 Java 虛擬機器
  4. 4096 值新增至起始資料堆
  5. 將值 24576 新增至 資料堆大小上限
    提示: 這裡的圖只是建議;請根據自己的環境來設定這個值。 一般中型的團隊可使用 4096 MB 的值,這是假設 64 位元電腦上的 Rational Engineering Lifecycle Manager 程序為 4 GB 的資料堆記憶體。 如果資料堆大小上限值太小,則 Rational Engineering Lifecycle Manager 資料來源至「生命週期查詢引擎」可能停止處理現有待辦事項以及任何建立、修改或刪除產品的新變更。

    此外,實體記憶體務必要比所結合機器上所有程序的需求量還多,以免發生分頁或交換。分頁會降低系統效能,並影響 Java 記憶體管理系統的效能。

    在增加 Java 資料堆大小時,請確定機器上未用的實體記憶體量足以涵蓋增加量。 如果沒有足夠的實體記憶體,請安裝額外的記憶體,或是將對整體效能的影響納入考量。

  6. 通用 JVM 引數欄位中,輸入下列字行:
    Windows:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    提示: 如果您需要更多的資料堆大小,您可以使用下列設定,以所要使用的記憶體量來取代 {N},以總記憶體的 1/8 取代 {N/8}。例如,如果 -Xmx 設為 8g,則應將 -Xmn 設為 1g。
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  7. 按一下套用,然後按一下直接儲存到主要配置
  8. 您必須新增的其中一個自訂內容是 JAZZ_HOME,這個系統內容指定某些配置檔的所在位置。 這個內容使用 URL 而非簡式路徑,因此,請將值指定為 file 樣式的 URL:file:///file path。 在 Java 虛擬機器 > 其他內容之下,按一下自訂內容
    記住: 您必須在 file: 之後使用三條正斜線 (///):
    重要: 在分散式環境中,當您將個別應用程式伺服器用於每個 Web 應用程式時,WebSphere Application Server 的每個實例都需要新增這些自訂內容。
  9. 按一下新建,在名稱欄位中輸入 JAZZ_HOME,在欄位中輸入 file:///JazzInstallDir/server/conf。 將 JazzInstallDir 改成 Jazz Team Server 安裝目錄的位置。 例如,在 Windows 上輸入 file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf, 在 Linux 系統上輸入 file:///opt/IBM/JazzTeamServer/server/conf
    註: 為了避免發生問題,請勿在檔案路徑中使用空格。Program Files 目錄可以使用 PROGRA~1Program Files (x86) 目錄可以使用 PROGRA~2
  10. 按一下確定
  11. 重複步驟 10,新增下列自訂內容:
    • 名稱java.awt.headless true
    • 名稱org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin true
    • 如果您是連接到 Oracle 資料庫,新增名稱ORACLE_JDBC_DRIVER_FILE Absolute path to the JDBC driver/ojdbc6.jar
      註: JDBC 驅動程式的路徑必須是絕對路徑。請勿使用 URL 路徑 (file:///)。 如需「Oracle Java 資料庫連線功能 (JDBC)」連線的相關資訊,請參閱設定 Oracle 資料庫以用於 Rational Engineering Lifecycle Manager 和生命週期查詢引擎
    • 名稱log4j.configuration file:///JazzInstallDir/server/conf/startup_log4j.properties
      註: startup_log4j.properties 檔包含的設定是在啟動程序的初期階段,用來將訊息傳到 WebSphere Application Server SystemOut.log 檔。 在初期階段之後,每一個 Jazz 應用程式將改用 JazzInstallDir/server/conf/app context/log4j.properties 檔中的應用程式特定設定。
  12. 按一下直接儲存到主要配置
  13. 增加預設執行緒儲存區供多個使用者使用。按一下伺服器 > 伺服器類型 > WebSphere Application Server > Server1
  14. 在「其他內容」之下,按一下執行緒儲存區
  15. 按一下 WebContainer,並將預設執行緒大小上限從 50 增加至 200 個。
  16. 按一下直接儲存到主要配置
  17. 按一下伺服器 > 伺服器類型 > 應用程式伺服器 > Server1 > 階段作業管理 > 自訂內容。在「自訂」內容頁面上,按一下新建
  18. 在「配置」頁面上,在名稱欄位中輸入 InvalidateOnUnauthorizedSessionRequestException,並在欄位中輸入 true。這個階段作業管理自訂內容的預設值是 false。按一下確定套用
  19. 按一下主控台作業列上的儲存,以儲存您的配置變更。
  20. 重新啟動應用程式伺服器,使變更生效。

下一步

配置伺服器之後,您必須將應用程式檔案部署到其中。

  1. 從 WebSphere Application Server 管理主控台, 選取應用程式 > 安裝新的應用程式(或選取「應用程式 > 新建應用程式 > 新建企業應用程式」)
  2. 新應用程式的路徑之下,選取本端檔案系統
  3. 完整路徑之下,輸入 [relm_install_dir]/server/webapps/relm.war
  4. 將環境定義根目錄設為 /relm
  5. 下一步,然後依照該編輯器的提示,繼續其餘安裝新的應用程式步驟。按一下完成
  6. 利用上述相同步驟來安裝「變更管理」應用程式 vvc.war, 用 [relm_install_dir]/server/webapps/vvc.war 來替換此路徑, 用 /vvc 來替換此環境定義根目錄。
  7. 利用上述相同步驟來安裝 SPARQL Gateway 元件應用程式 SPARQL_Gateway.war,在路徑中代入 [relm_install_dir]/server/webapps/SPARQL_Gateway.war,在環境定義根目錄中代入 /SPARQL_Gateway
  8. 如果您想要從您的伺服器提供說明文件,而不是在線上檢視它,您也可以部署 relmhelp.war 應用程式。
  9. 選取直接儲存到主要配置
  10. SPARQL Gateway 需要變更預設類別載入順序。
    1. 選取應用程式 > 應用程式類型 > WebSphere 企業應用程式,從應用程式清單中選擇 SPARQL_Gateway_war
    2. 按一下類別載入和更新偵測
    3. 類別載入器順序區段中,選取載入類別時,先使用本端類別載入器(母項最後)
    4. 按一下確定儲存到主要配置
    5. 選取管理模組。選取 SPARQL_Gateway 模組。
    6. 尋找類別載入器順序欄位,然後選取載入類別時,先使用本端類別載入器(母項最後)
    7. 按一下確定儲存到主要配置
  11. 企業應用程式頁面中,選取您剛部署到 WebSphere Application Server 中的應用程式, 然後選取啟動
註: 本文件不提供配置 WebSphere 鑑別或 SSL 的詳細資料,那是一個較複雜的主題。 「WebSphere Application Server 資訊中心」涵蓋有關各種鑑別與加密選項的詳細資訊。如需相關資訊,請移至 WebSphere 資訊中心,在搜尋中使用這個詞組:維護應用程式和其環境的安全 (Securing applications and their environment)

意見