本主题描述了如何设置 Jazz™ Team Server 以使它与 WebSphere® Application Server 一起工作。此设置步骤假定您要在安装 Websphere Application Server 的机器上安装 Jazz Team Server。
开始之前
在开始执行这些步骤之前,应当已经完成了下列任务:
- 已安装 WebSphere Application Server。
- 创建了数据库,并且使用您的数据库设置更新了 teamserver.properties 文件。
- 启用不区分大小写登录(可选):如果应用程序服务器的认证方法允许进行不区分大小写登录,那么您可以使
Jazz 应用程序也接受此类登录。可以通过“管理”Web UI 中“高级属性”页面上的“进行用户标识匹配时不区分大小写”属性来启用不区分大小写登录。缺省值未变更;管理员必须显式地覆盖此属性才能启用不区分大小写登录。
- 应关闭 Java™ 2 Security 选项。 如果在 WebSphere Application Server 中打开了此选项,它将导致 Jazz Team Server .war 无法启动。
- 确保已选中 WAS 安全设置“访问未受保护的 URI 时使用可用的认证数据”。如果您正在使用
WAS 集成解决方案控制台,那么可以通过以下过程来完成此任务:
- 转到“安全性”->“安全管理、应用程序和基础结构”->“Web 安全性 - 常规设置”。
- 选中“访问未受保护的 URI 时使用可用的认证数据”复选框。
- Jazz Team Server 包括运行完整的基于 Apache Tomcat 的服务器所需要的文件。对于 WebSphere 安装,您只需要一部分 Jazz Team Server 文件,并且您应将它们放入 WebSphere 服务器上的一个目录中。进一步的指示信息将此目录称为 Jazz Team Server 安装目录,或者简称为 JazzInstallDir。在此目录中,使用:
- JazzInstallDir/server/tomcat/webapps/jazz.war 文件。
- JazzInstallDir/server/update-site 目录。
- JazzInstallDir/server/conf 目录。
- JazzInstallDir/repositoryDB 中的缺省存储库数据库。
- JazzInstallDir/repotools 中的存储库工具。
- JazzInstallDirserver/license-update-site 目录。
- JazzInstallDir/server/nl1-update-site 目录。
- JazzInstallDir/server/nl2-update-site 目录。
提示: 当使用 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 的服务器的内存容量来设置此值。典型的中等规模团队可以使用值 -Xmx1536M,从而为 Jazz Team Server 进程提供 1536 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 旁边的框,然后单击启动。
应出现一个绿色箭头,指示已成功启动应用程序。