为 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 V1.x 必须与 Lifecycle Query Engine 共享应用程序服务器。
  • Rational Engineering Lifecycle Manager V4.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 Application Server > Server1。在服务器基础结构下,单击 Java 和流程管理 > 流程定义。在其他属性下,单击 Java 虚拟机。输入下列设置。单击应用,然后单击直接保存到主配置

    表 1. Java 虚拟机配置
    字段 注释
    初始堆 4096  
    最大堆大小 24576
    • 这里的数值只是建议;请根据您的环境来设置值。典型的中等规模团队可以使用值 4096 MB,从而为 64 位计算机上的 Rational Engineering Lifecycle Manager 进程提供 4GB 的堆内存。如果最大堆大小值太小,那么 Lifecycle Query EngineRational Engineering Lifecycle Manager 数据源可能停止处理现有储备以及用于创建、修改或删除产品的任何新更改。
    • 实际的物理内存量超过机器上所有进程总共需要的物理内存量,这一点很重要,这样可以防止进行页面调度或交换。进行页面调度会降低系统性能,也会影响 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} 替换为要使用的内存量,将 {N/8} 替换为总内存的 1/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

    JazzInstallDir 取代为 Jazz Team Server 安装目录。

    切记:
    • 必须在 file: 之后使用 3 个正斜杠 (///)
    • 为避免出现问题,请勿在文件路径中使用空格。对于 Program Files 目录,您可以使用 PROGRA~1;而对于 Program 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) 连接的更多信息,请参阅为 Rational Engineering Lifecycle Manager 和 Lifecycle Query Engine 设置 Oracle 数据库

    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 Application Server > Server1。在其他属性下面,单击线程池 > WebContainer。将缺省最大大小从 50 个线程增加到 200 个线程,然后单击直接保存到主配置

  4. 配置 InvalidateOnUnauthorizedSessionRequestException 定制属性。
    单击服务器 > 服务器类型 > 应用程序服务器 > Server1 > 会话管理 > 定制属性 > 新建。输入定制属性的名称/值对。 单击确定应用,然后单击控制台任务栏上的保存以保存配置更改。
    表 3. 定制属性信息
    定制属性名称 定制属性值 注释
    InvalidateOnUnauthorizedSessionRequestException true 此会话管理定制属性的缺省值为 false
  5. 设置 Jazz Reporting Service 共享库。
    1. 在管理控制台中,转至环境 > 共享库。将下拉框范围更改为服务器,然后单击新建
    2. 将共享库名称输入为 JRS 共享库,添加描述,并将类路径设置为 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

反馈