设置 WebSphere Application Server

本主题描述了如何设置 Jazz™ Team Server 以使它与 WebSphere® Application Server 一起工作。此设置步骤假定您要在安装 Websphere Application Server 的机器上安装 Jazz Team Server。

开始之前

在开始执行这些步骤之前，应当已经完成了下列任务：

已安装 WebSphere Application Server。
创建了数据库，并且使用您的数据库设置更新了 teamserver.properties 文件。
请参阅 WebSphere 文档以了解安全性设置并关闭不区分大小写属性。
注：尽管 Websphere 和许多 LDAP 目录允许您在登录时不区分大小写，但是 Jazz Team Server 存储用户记录时所使用的用户标识将区分大小写，它必须与导入的用户标识精确匹配。当您登录至 Jazz Team Server 时，将从用户列表中检索用户记录，并且大小写必须精确匹配。
应关闭 Java™ 2 Security 选项。如果在 WebSphere Application Server 中打开了此选项，它将导致 Jazz Team Server .war 无法启动。
Jazz Team Server 包括运行完整的基于 Apache Tomcat 的服务器所需要的文件。对于 WebSphere 安装，您只需要一部分 Jazz Team Server 文件，并且您应将它们放入 WebSphere 服务器上的一个目录中。进一步的指示信息将此目录称为 Jazz Team Server 安装目录，或者简称为 JazzInstallDir。在此目录中，使用：
- JazzInstallDir/server/teamserver.properties 文件。
- JazzInstallDir/server/log4j.properties 文件。如果您使用 Websphere Application Server，在此文件中，可以更改 jazz.log 文件的路径，此日志文件仅记录 Jazz Team Server 中产生的消息。缺省路径为 tomcat/logs/jazz.log。
- JazzInstallDir/server/tomcat/webapps/jazz.war 文件。
- JazzInstallDir/server/provision_profiles 目录。
- JazzInstallDir/server/update-site 目录。
- JazzInstallDir/repositoryDB 中的缺省存储库数据库。
- JazzInstallDir/repotools 中的存储库工具。

提示：当使用 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 要求配置认证以便执行授权并将应用程序个性化。

修改 profile.ini 和 license-profile.ini 文件：
编辑 JazzInstallDir/server/provision_profiles/ 中的每个概要文件，并设置 URL 属性的绝对路径。
例如，
- 要将下面这一行：
```
url=file:./update-site
```
- 更改为与以下内容相似：
```
url=file:/opt/IBM/JazzTeamServer/server/update-site
```
注： JazzInstallDir/server/provision_profiles/ 目录中必须只包含 .ini 文件并且不能包含任何备份文件。某些编辑器将自动保存一个备份文件，必须除去此备份文件。

复查并更新 teamserver.properties 文件中的数据库位置。

com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin

验证或更新 WebSphere Application Server 级别。
Jazz Team Server 需要 WebSphere Application Server V6.1 并应用 IBM Java SDK 1.5 SR5 或更高版本的累积修订。可从 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 将开始报告“代理错误”。
更新 JVM 参数。
运行 Jazz Team Server 的 Java 虚拟机上需要一些特定设置。

首先，它需要知道在何处查找服务器以及服务器所使用的日志记录框架 log4j 的配置文件。这可以通过设置系统属性 com.ibm.team.server.configURL 和 log4j.configuration 来完成。这些属性使用一个 URL 而不是简单路径，因此应将值指定为 file://-style URL。

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

如果您要连接至 Oracle 数据库，那么需要添加一个名为“ORACLE_JDBC”的属性。请将此属性设置为 Oracle 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. 添加下列属性：单击新建，输入名称和值，然后单击“确定”。
  - 名称：com.ibm.team.repository.provision.profile 值：file:///JazzInstallDir/server/provision_profiles（作为文件 URL）
    注：属性 com.ibm.team.repository.provision.profile 需要指向包含 provision_profiles 的目录。
  - 名称：com.ibm.team.server.configURL 值：file:///JazzInstallDir/server/teamserver.properties（作为文件 URL）
  - 名称：log4j.configuration 值：file:///JazzInstallDir/server/log4j.properties（作为文件 URL）
  - 名称：java.awt.headless 值：true
  - 名称：org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 值：true
11. 单击保存以直接保存到主配置中。
重新启动 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 旁边的框，然后单击启动。
  应出现一个绿色箭头，指示已成功启动应用程序。

下一步做什么

在启动服务器之后，请继续运行安装向导。