设置 WebSphere Application Server

本主题描述了如何设置 Jazz™ Team Server 以使它与 WebSphere® Application Server 一起工作。此设置步骤假定您要在安装 Websphere Application Server 的机器上安装 Jazz Team Server
开始之前
在开始执行这些步骤之前,应当已经完成了下列任务:
提示: 当使用 IBM® Installation Manager 时,可以将 Jazz Team Server 文件安装到 Web 应用程序目录中。在安装过程中,您不应安装所包含的 Apache Tomcat 应用程序服务器;这会使得 Installation Manager 要求使用 Web 应用程序目录并且仅安装 WebSphere 需要的文件。在 Windows® 上,缺省目录为 C:\Program Files\IBM\JazzTeamServer;在 Linux® 上,缺省目录为 /opt/IBM/JazzTeamServer。在此过程中,安装目录称为 JazzInstallDir。如果您使用 IBM Installation Manager 将文件安装到 WebSphere Application Server Web 应用程序目录中,那么您不需要如上所述手动移动文件。
关于此任务
注: 本文档并不会阐述 WebSphere 认证或 SSL 的配置,这是一个复杂的主题。WebSphere 信息中心中提供了有关 WebSphere 的各种认证和加密选项的详细信息。有关更多信息,请访问 WebSphere 信息中心并搜索保护应用程序和它们的环境。Jazz Web UI 要求配置认证以便执行授权并将应用程序个性化。
  1. 复查并更新 teamserver.properties 文件中的数据库位置。
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    注: 这是样本 DB2 配置。您应该根据数据库供应商(Oracle/MS-SQL)对 teamserver.properties 进行更新。
  2. 验证或更新 WebSphere Application Server 级别。

    Jazz Team Server 需要已应用 IBM Java SDK 1.5 SR5 或更高版本累积修订的 WebSphere Application Server V6.1 或者至少已安装 7.0.0.3 的 WebSphere Application Server V7.0。可从 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 获得 IBM Java SDK 1.5 SR6 SDK 更新。借助 WebSphere 6.1 和 GA IBM Java SDK,在执行一定数量的操作之后,Jazz 将开始报告“代理错误”。

    您必须获取正确运行 IBM Rational Team Concert™ 2.0 所必需的 IBM Java SDK 1.5 SR9 或 IBM Java SDK 1.6 SR4 的修订的相应 WebSphere Application Server i-fix。否则,服务器中的某些服务可能无法正确启动。这些 i-fix 在其相应的 WebSphere Application Server APAR 之下。对于 IBM Java SDK 1.5/WebSphere Application Server 6.1 而言,APAR 是 PK85942,您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ 下载文件。在安装 JRE i-fix 之前,请至少安装 WebSphere Application Server 6.1 修订包 19。对于 IBM Java SDK 1.6/WebSphere Application Server 7.0 而言,APAR 是 PK 86771,您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ 下载文件。

  3. 更新 JVM 参数。

    运行 Jazz Team Server 的 Java 虚拟机上需要一些特定设置。

    首先,它需要知道在何处查找某些配置文件。这是通过设置系统属性 JAZZ_HOME 实现的。此属性使用 URL 而不是简单路径,因此应该将值指定为 file://-style URL。

    Jazz JVM 需要的第二个属性是使用 -Xmx 设置为它提供多个缺省最大内存分配。应该根据服务器支持的团队大小以及正在运行 Jazz Team Server 的服务器的内存容量来设置此值。典型的中等规模团队可以使用值 -Xmx1536M,从而为 Jazz Team Server 进程提供 1536 MB 的堆内存。

    如果正在连接至 Oracle 或 SQL Server 数据库,那么需要添加名为“ORACLE_JDBC”或“SQLSERVER_JDBC”的属性。请将此属性设置为适当 JDBC 驱动程序的绝对文件路径(而不是 URL)。

    还需要设置其他系统属性以控制服务器的某些行为,下面包含了这些属性。下面是有关在 WebSphere 管理控制台中设置这些 JVM 属性的细节,请将 JazzInstallDir 替换为您的 Jazz Team Server 安装目录:

    1. 单击服务器 > 应用程序服务器
    2. 单击 server1
    3. 单击 Java 和流程管理 > 流程定义
    4. 单击 Java 虚拟机
    5. 添加 100 作为初始堆的值。
    6. 添加 1000 作为最大堆大小的值。
    7. 单击应用
    8. 单击记录和跟踪。单击变更日志详细信息级别Jazz Team Server 使用 BIRT 报告引擎。要阻止 BIRT 参考条目被写入 WebSphere 日志文件,请对 org.eclipse.birt.* 包将记录级别设置为严重。单击应用
    9. 单击定制属性
    10. 添加下列属性: 单击新建,输入名称,然后单击“确定”。
      • 名称:java.awt.headless,:true
      • 名称:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin,:true
      • 名称:JAZZ_HOME,:file:///JazzInstallDir/server/conf
    11. 单击保存以直接保存到主配置中。
    要点: (仅限于 Solaris)还必须添加以下 Java 命令行自变量:
    -XX:MaxPermSize=256m
    有关更多信息,请参阅 IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System 红皮书的第 2 章“Configuring a Solaris environment for WebSphere Application Server”。
  4. 重新启动 Websphere 以安装 Jazz 应用程序。
    在下列命令行示例中,WASInstallDir 表示 WebSphere Application Server 在服务器中的安装位置。
    • 在 Windows 上,WebSphere 安装目录的缺省值为:
      C:\Program Files\IBM\WebSphere\AppServer
      在 Windows 上,可以使用下列命令来重新启动服务器:
      cd WASInstallDir\bin 
      stopServer.bat server1 [对于安全服务器,还应包括:-username {LDAP_User} -password {LDAP_Password}]
      startServer.bat server1
    • 在 Linux 上,WebSphere 安装目录的缺省值为:
      /opt/IBM/WebSphere/AppServer
      在 Linux 上,可以使用下列命令来重新启动服务器:
      cd WASInstallDir/bin 
      ./stopServer.sh server1 [对于安全服务器,还应包括:-username {LDAP_User} -password {LDAP_Password}]
      ./startServer.sh server1
    1. 打开 WebSphere Application Server 的管理控制台。
    2. 单击应用程序 > 安装新的应用程序
    3. 新应用程序所在的路径下单击“本地文件系统”。
    4. 完整路径下输入:
      JazzInstallDir/server/jazz.war
    5. 上下文根设置为 /jazz。
    6. 单击下一步并继续完成其余的安装新的应用程序步骤。
    7. 单击完成
    8. 单击保存以直接保存到主配置中。
    9. 单击应用程序 > 企业应用程序
    10. 选中 jazz_war 旁边的框,然后单击启动

      应出现一个绿色箭头,指示已成功启动应用程序。

下一步做什么
在启动服务器之后,请继续运行安装向导

有关此主题的更多信息,请访问下列链接:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ


反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误