本主题描述如何将 Jazz™ Team Server 设置为与 WebSphere® Application Server 一起工作。此设置假定您在 Websphere Application Server 所在的机器上安装 Jazz Team Server。
开始之前
开始这些步骤之前,您应先完成下列操作:
- 已安装 WebSphere Application Server。
- 创建了数据库并且通过数据库设置更新了 teamserver.properties 文件。
- 启用不区分大小写的登录名(可选):如果应用程序服务器的认证方法允许不区分大小写登录名,那么也可以使 Jazz 应用程序接受此类情况。可以通过管理 Web UI 的“高级属性”页面上的“使用不区分大小写的用户标识匹配”属性启用允许不区分大小写的登录名。缺省值未更改;管理员必须明确覆盖该属性以启用不区分大小写登录名。
- 应关闭“Java™ 2 安全性”选项。如果在 WebSphere Application Server 中打开了此选项,将会导致 Jazz Team Server .war 启动失败。
- 确保选中 WAS 安全设置“在访问未受保护的 URI 时使用可用认证数据”。如果正在使用 WAS Integrated Solutions Console,可通过以下方式执行此操作:
- 浏览到“安全”->“安全管理、应用程序和基础结构”->“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 需要的文件。
缺省目录为 C:\Program Files\IBM\JazzTeamServer(在 Windows® 上)或 /opt/IBM/JazzTeamServer(在 Linux® 上)。
在此过程中,该安装目录称为 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.7 的 WebSphere Application Server V7.0。IBM Java SDK 1.5 SR6 SDK 更新可从 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 获取。如果使用 WebSphere 6.1 和 GA IBM Java SDK,在若干操作次数后 Jazz 将开始报告“代理错误”
您必须获取与 IBM Java SDK 1.5 SR9 或 IBM Java SDK 1.6 SR4 的修订程序对应的 WebSphere Application Server i-fix,要使 IBM Rational Team Concert™ 2.0 正确运行,这些修订程序是必需的。否则,服务器中的部分服务可能不会正确启动。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 虚拟机上需要某些特定设置。
通用 JVM 参数中需要设置的第一个属性是缺省最大内存分配,该属性使用 -Xmx 设置指定。应基于服务器支持的团队大小以及正在运行 Jazz Team Server 的服务器的内存容量进行设置。典型中等大小团队可使用值 -Xmx1536M,该值为 Jazz Team Server 进程提供 1536 MB 大小的堆内存。
通用 JVM 参数中需要设置的第二个属性是线程堆栈大小,该属性专用于 Rational® Quality Manager。Rational Quality Manager 的典型堆栈大小是 -Xss786K。
如果您正在连接到 Oracle 数据库或 SQL Server 数据库,那么需要添加名为“ORACLE_JDBC”或“SQLSERVER_JDBC”的属性。
将属性设置为相应 JDBC 驱动程序的绝对文件路径(非 URL)。
以下示例显示用于连接到 Oracle 数据库和 SQL Server 数据库的通用 JVM 参数,以及缺省最大内存分配和线程堆栈大小。将 JazzInstallDir 替换为您的 Jazz Team Server 安装目录。
-DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
-DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k
还需要设置其他若干系统属性以控制特定服务器行为。以下包括了这些属性。以下是在 WebSphere 管理控制台中设置这些 JVM 属性的具体信息。将 JazzInstallDir 替换为您的 Jazz Team Server 安装目录:
- 单击。
- 单击 server1。
- 单击 。
- 单击 Java 虚拟机。
- 将值 100 添加到初始堆。
- 将值 1000 添加到最大堆大小。
- 单击应用。
- 单击日志记录和跟踪。单击更改日志详细级别。Jazz Team Server 使用 BIRT 报告引擎。要阻止 BIRT 参考条目写入 WebSphere 日志文件,对于 org.eclipse.birt.* 程序包,请将记录级别设置为严重。单击应用。
- 单击定制属性。 需要添加的定制属性之一是 JAZZ_HOME,这是一个系统属性,指定用于查找特定配置文件的位置。该属性使用 URL 而不是简单路径,因此应将值指定为 file:// 样式的 URL。
- 添加以下属性: 单击新建;输入名称和值;然后单击“确定”。
- 名称: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 旁边的框;并单击启动。
应显示绿色箭头指示已成功启动应用程序。