本主题描述了如何设置 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 要求配置认证以便执行授权并将应用程序个性化。
- 复查并更新 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 进行更新。
- 验证或更新 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/
下载文件。
- 更新 JVM 参数。
运行 Jazz Team Server 的 Java 虚拟机上需要一些特定设置。
首先,它需要知道在何处查找某些配置文件。这是通过设置系统属性 JAZZ_HOME 实现的。此属性使用 URL
而不是简单路径,因此应该将值指定为 file://-style URL。
Jazz JVM 需要的第二个属性是使用 -Xmx 设置为它提供多个缺省最大内存分配。应该根据服务器支持的团队大小以及正在运行 Jazz Team Server 的服务器的内存容量来设置此值。一个典型的中型团队可以使用值 -Xmx1000M,并为 Jazz Team Server 流程提供 1000 MB 的堆内存。
如果正在连接至 Oracle 或 SQL Server 数据库,那么需要添加名为“ORACLE_JDBC”或“SQLSERVER_JDBC”的属性。请将此属性设置为适当 JDBC 驱动程序的绝对文件路径(而不是 URL)。
还需要设置其他系统属性以控制服务器的某些行为,下面包含了这些属性。下面是有关在 WebSphere 管理控制台中设置这些 JVM 属性的细节,请将 JazzInstallDir 替换为您的 Jazz Team Server 安装目录:
- 单击。
- 单击 server1。
- 单击 。
- 单击 Java 虚拟机。
- 添加 100 作为初始堆的值。
- 添加 1000 作为最大堆大小的值。
- 单击应用。
- 单击记录和跟踪。单击更改日志详细信息级别。Jazz Team Server 使用 BIRT 报告引擎。要阻止 BIRT 参考条目被写入 WebSphere 日志文件,请对 org.eclipse.birt.* 包将记录级别设置为严重。单击应用。
- 单击定制属性。
- 添加下列属性: 单击新建,输入名称和值,然后单击“确定”。
- 名称:java.awt.headless,值:true
- 名称:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin,值:true
- 名称:JAZZ_HOME,值:file:///JazzInstallDir/server/conf
- 单击保存以直接保存到主配置中。
- 重新启动 Websphere 以安装 Jazz 应用程序。
在下列命令行示例中,
WASInstallDir 表示 WebSphere Application Server 在服务器中的安装位置。
- 打开 WebSphere Application Server 的管理控制台。
- 单击。
- 在新应用程序所在的路径下单击“本地文件系统”。
- 在完整路径下输入:
JazzInstallDir/server/jazz.war
- 将上下文根设置为 /jazz。
- 单击下一步并继续完成其余的安装新的应用程序步骤。
- 单击完成。
- 单击保存以直接保存到主配置中。
- 单击。
- 选中 jazz_war 旁边的框,然后单击启动。
应出现一个绿色箭头,指示已成功启动应用程序。