設定 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 版必須與 Lifecycle Query Engine 共用一部應用程式伺服器。
  • Rational Engineering Lifecycle Manager 4.x 版可以與 Lifecycle Query Engine 共用一部應用程式伺服器, 也可以部署到不同的應用程式伺服器上。不過,這兩個應用程式必須登錄到相同的 Jazz Team Server 中。

關於這項作業

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

程序

  1. 配置 Rational Engineering Lifecycle Manager 在其中執行的 Java 虛擬機器。

    按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 > Server1。在伺服器基礎架構之下,按一下 Java 和程序管理 > 程序定義。在其他內容下,按一下 Java 虛擬機器 (JVM)。輸入下列設定。按一下套用,然後按一下直接儲存到主要配置

    表 1. Java 虛擬機器配置
    欄位 註解
    起始資料堆 4096  
    資料堆大小上限 24576
    • 這裡的圖只是建議;請根據自己的環境來設定這個值。一般中型的團隊可使用 4096 MB 的值,這是假設 64 位元電腦上的 Rational Engineering Lifecycle Manager 程序為 4 GB 的資料堆記憶體。 如果資料堆大小上限值太小,則 Rational Engineering Lifecycle Manager 資料來源至 Lifecycle Query Engine 可能停止處理現有待辦事項以及任何建立、修改或刪除產品的新變更。
    • 實體記憶體務必要比所結合機器上所有程序的需求量還多,以免發生分頁或交換。分頁會降低系統效能,並影響 Java 記憶體管理系統的效能。
    • 在增加 Java 資料堆大小時,請確定機器上未用的實體記憶體量足以涵蓋增加量。 如果沒有足夠的實體記憶體,請安裝額外的記憶體,或是將對整體效能的影響納入考量。
    一般 JVM 引數 Linux
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Windows
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux
    如果您需要更多的資料堆大小,您可以使用下列設定,以所要使用的記憶體量來取代 {N},以總記憶體的 1/8 取代 {N/8}。例如,如果 -Xmx 設為 8g,則應將 -Xmn 設為 1g。
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  2. 配置自訂內容。

    其他內容之下,按一下自訂內容 > 新建。輸入下列每個自訂內容中的一般內容資訊,然後按一下確定以儲存每一個自訂內容的資訊。然後按一下直接儲存到主要配置

    表 2. 自訂內容資訊
    自訂內容名稱 自訂內容值 註解
    JAZZ_HOME file:///JazzInstallDir/server/conf

    Jazz Team Server 安裝目錄取代 JazzInstallDir

    記住:
    • 您必須在 file: 之後使用三條正斜線 (///):
    • 為了避免發生問題,請勿在檔案路徑中使用空格。Program Files 目錄可以使用 PROGRA~1Program Files (x86) 目錄可以使用 PROGRA~2
    範例:

    Linux file:///opt/IBM/JazzTeamServer/server/conf

    Windows file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf

    此系統內容指定在何處尋找特定的配置檔案。這個內容使用 URL 而非簡式路徑。以檔案樣式 URL 的形式輸入值:file:///file_path
    重要: 在分散式環境中,當您將個別應用程式伺服器用於每個 Web 應用程式時,WebSphere Application Server 的每個實例都需要新增這些自訂內容。
    java.awt.headless true  
    org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin true  
    Oracle

    ORACLE_JDBC_DRIVER_FILE

    JDBC_driver/ojdbc6.jar 的絕對路徑 JDBC 驅動程式的路徑必須是絕對路徑。請勿使用 URL 路徑 (file:///)。 如需「Oracle Java 資料庫連線功能 (JDBC)」連線的相關資訊,請參閱設定 Oracle 資料庫以用於 Rational Engineering Lifecycle Manager 和 Lifecycle Query Engine

    SQL_JDBC_DRIVER_FILE

    JDBC_driver/sqljdbc4.jar 的絕對路徑 JDBC 驅動程式的路徑必須是絕對路徑。請勿使用 URL 路徑 (file:///)。如需連接到 SQL Server 資料庫的相關資訊,請參閱 Rational solution for Collaborative Lifecycle Management 的說明文件
    log4j.configuration file:///JazzInstallDir/server/conf/startup_log4j.properties  
  3. 增加預設執行緒儲存區供多個使用者使用。

    按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 > Server1。在其他內容下,按一下執行緒儲存區 > Web 儲存器。將預設執行緒大小上限從 50 增加至 200 個,然後按一下直接儲存到主要配置

  4. 配置 InvalidateOnUnauthorizedSessionRequestException 自訂內容。
    按一下伺服器 > 伺服器類型 > 應用程式伺服器 > Server1 > 階段作業管理 > 自訂內容 > 新建。輸入自訂內容的名稱和值配對。按一下確定套用,然後按一下主控台作業列上的儲存,以儲存您的配置變更。
    表 3. 自訂內容資訊
    自訂內容名稱 自訂內容值 註解
    InvalidateOnUnauthorizedSessionRequestException true 這個階段作業管理自訂內容的預設值是 false
  5. 設定 Jazz Reporting Service 共用程式庫。
    1. 在管理主控台上,跳至環境 > 共用程式庫。將下拉範圍變更為 server,然後按一下新建
    2. 輸入 JRS Shared Library 作為共用程式庫名稱,新增說明,然後將類別路徑設為 5.0.1_install_dir/server/conf/rs/SharedLibrary。在類別載入之下,選取將隔離的類別載入器用於共用程式庫的勾選框,然後按一下套用
    3. 按一下儲存到主要配置
  6. 重新啟動應用程式,以使變更生效。
    • Linux 執行 stopServer.shstartServer.sh 指令。
    • Windows 執行 stopServer.batstartServer.bat 指令。

下一步

  1. 部署應用程式檔案。
    1. 在 WebSphere Application Server 管理主控台上,跳至應用程式 > 新建應用程式 > 新建企業應用程式
    2. 準備應用程式安裝精靈中的新應用程式的路徑之下,選取本端檔案系統並指定應用程式檔案的完整路徑。在安裝新應用程式精靈中,設定應用程式環境定義根目錄,然後遵循所有安裝步驟。在安裝新應用程式摘要頁面上,驗證所選取的安裝選項,然後按一下完成
      表 4. 應用程式檔案和值
      應用程式 完整路徑值 環境定義根目錄
      Rational Engineering Lifecycle Manager RELM_install_dir/server/webapps/relm.war /relm
      Rational Engineering Lifecycle Manager 說明文件 RELM_install_dir/server/webapps/relmhelp.war /relmhelp
      「配置管理」應用程式 RELM_install_dir/server/webapps/vvc.war /vvc
      Jazz Reporting Service RELM_install_dir/server/webapps/rs.war /rs
    3. 按一下直接儲存到主要配置

  2. 新增 Jazz Reporting Service 程式庫參照。
    1. 跳至應用程式 > 應用程式類型 > WebSphere 企業應用程式,然後在應用程式清單中按一下 rs_war
    2. 參照區段中,按一下共用程式庫參照
    3. 選取 rs_war 旁邊的勾選框,然後按一下參照共用程式庫
    4. 選取 JRS 共用程式庫,然後按一下向右箭頭。
    5. 按一下確定。然後再次按一下確定以將設定儲存到主要配置。

  3. 請確定已正確配置 Jazz Reporting Service 類別載入順序。
    1. 跳至應用程式 > 應用程式類型 > WebSphere 企業應用程式,然後在應用程式清單中按一下 rs_war
    2. 詳細內容區段中,按一下類別載入和更新偵測
    3. 類別載入器順序區段中,選取載入類別時,先使用本端類別載入器(母項最後)
    4. 按一下確定,然後按一下儲存到主要配置

  4. 企業應用程式頁面中,選取您剛部署到 WebSphere Application Server 中的應用程式, 然後選取啟動
註: 本文件不提供配置 WebSphere 鑑別或 SSL 的詳細資料,那是一個較複雜的主題。 WebSphere Application Server 產品說明文件涵蓋了有關各種鑑別與加密選項的詳細資訊。 如需相關資訊,請移至 WebSphere 產品說明文件,並在搜尋中使用這個詞組:維護應用程式和其環境的安全 (Securing applications and their environment)

意見