为 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 信息中心并搜索以下短语:保护应用程序和它们的环境

过程

  1. Rational Engineering Lifecycle Manager 要求对运行此产品的 Java 虚拟机进行多项特定设置。要设置这些属性,请在“WebSphere 集成解决方案控制台”上,单击服务器 > 服务器类型 > WebSphere Application Server > Server1
  2. 在“服务器基础结构”下,单击 Java 和流程管理 > 流程定义
  3. 在“其他属性”下面,单击 Java 虚拟机
  4. 将值 4096 添加到初始堆大小
  5. 将值 24576 添加到最大堆大小
    提示: 这里的数值只是建议;请根据您的环境来设置值。典型的中等规模团队可以使用值 4096 MB,从而为 64 位计算机上的 Rational Engineering Lifecycle Manager 进程提供 4GB 的堆内存。 如果最大堆大小值太小,那么 Lifecycle Query Engine 的 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} 替换为要使用的内存量,将 {N/8} 替换为总内存的 1/8。例如,如果 -Xmx 设置为 8g,那么应将 -Xmn 设置为 1g。
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  7. 单击应用,然后单击直接保存到主配置
  8. 您必须添加的一项定制属性是 JAZZ_HOME,它是用于指定在何处查找某些配置文件的系统属性。此属性使用 URL 而不使用简单路径,因此,将值指定为文件样式 URL:file:///file path。在Java 虚拟机 > 其他属性下,单击定制属性
    切记: 必须在 file: 之后使用 3 个正斜杠 (///)
    要点: 在分布式环境中,如果您对每个 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~1;而对于 Program Files (x86) 目录,您可以使用 PROGRA~2
  10. 单击确定
  11. 重复执行步骤 10 并添加下列定制属性:
    • 名称java.awt.headless true
    • 名称org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin true
    • 如果您正在连接至 Oracle 数据库,那么添加名称ORACLE_JDBC_DRIVER_FILEJDBC 驱动程序的绝对路径/ojdbc6.jar
      注: JDBC 驱动程序的路径必须是绝对路径。请勿使用 URL 路径 (file:///)。有关 Oracle Java 数据库连接 (JDBC) 连接的更多信息,请参阅为 Rational Engineering Lifecycle Manager 和 Lifecycle Query Engine 设置 Oracle 数据库
    • 名称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 信息中心并搜索以下短语:保护应用程序和它们的环境

反馈