Jazz: Jazz Team 服务器安装指南-技术开发专区

Jazz: Jazz Team 服务器安装指南

作者：ITPUB论坛编辑： ITPUB实习编辑 2008-06-27 14:25

【IT168技术文档】安装 Jazz 的工作由单独的服务器和客户端安装组成。您应该从安装服务器部分开始，然后才进行客户端安装。缺省的服务器配置包括一个 Apache Tomcat 服务器，此服务器运行连接到一个 Apache Derby 关系数据库的 Jazz 服务器 Web 应用程序。

服务器安装包包括了所需的所有内容；其中为 Windows 和 Linux 包括了受支持的 Java Development Kit (JDK) 版本。包含 Jazz Web 应用程序和 Derby 数据库的 Tomcat 工作映像已经为您定义好了。缺省的安装包括一个空数据库。

完成客户端和服务器安装以后，您将能够探索 Jazz 团队协作功能、Work Item 组件和 Source Code Management (SCM) 组件。

Jazz 服务器支持的操作系统平台包括：

Microsoft Windows XP
Redhat Enterprise Linux WS 4

基于 Web 的 Jazz 客户端支持使用的 Web 浏览器如下：

Firefox 1.5 和 2.0
Microsoft Internet Explorer 7

系统要求

确保将在其上安装 Jazz 服务器的计算机满足以下基本要求。

处理器：1.5 GHz Pentium/PowerPC 或更高
内存：1 GB 或更多（如果客户端和服务器在同一台计算机上运行的话）。2 GB 或更多，以从一台计算机开发或运行多个客户端。
磁盘空间：1 GB 磁盘空间。如果要试验自己的一些小项目，则需要更多的磁盘空间。

Linux

Reports 组件要求在服务器上安装 32 位 X11 库。在 Redhat Enterprise Linux 上，所需的软件包为 xorg-x11-deprecated-libs、xorg-x11-libs 和 xorg-x11-Mesa-libGL。

Tomcat 用户的缺省文件句柄限制应该增加到 5000。在 Redhat Enterprise Linux 上，这可以通过将以下行添加到 /etc/security/limits.conf 来实现
tomcat_user hard nofile 5000 tomcat_user soft nofile 5000

许可证

安装步骤

服务器安装过程涉及到以下步骤。

安装 Jazz 服务器分发文件。
[可选：创建和配置数据库。]
[可选：配置 WebSphere Application Server (WAS)。]
启动服务器。
验证安装。
使用 Admin Web UI 配置服务器。
管理 Jazz 安全性。
管理 Jazz 用户。
[可选：安装并验证 Jabber 服务器。]
安装 Jazz 客户端。

安装 Jazz 服务器分发文件

将 Jazz 服务器分发文件解压缩到所选择的目录（例如，文件 JazzTeamServer-[build]）。相对于所选择的安装目录，Jazz 服务器的路径将为 [InstallDir]/jazz/server。

可选：创建和配置数据库

如果希望使用 DB2 或 Oracle 数据库来运行 Jazz 服务器，则此步骤是必需的。如果希望让 Jazz 服务器运行得尽可能快，可以跳过此步骤，并使用嵌入的 Derby 数据库来运行该服务器。

对于具有较高性能和大型存储库的情况，可以将 Jazz 服务器配置为使用以下数据库中的一种：

DB2：Jazz 已使用 DB2 V9.1 进行了测试。用于设置 Jazz 与 DB2 的说明请参见参考资料。
DB2 for i5/OS：Jazz 已使用 V5R4 和 V6R1 进行了测试。用于设置 Jazz 与 DB2 for i5/OS 的说明请参见参考资料。
DB2 for z/OS：Jazz 已使用 DB2 V9.1 for z/OS 进行了测试。用于设置 Jazz 与 DB2 for z/OS 的说明请参见参考资料。
Oracle：Jazz 已使用 Oracle Database 10g 进行了测试。用于设置 Jazz 与 Oracle 的说明请参见参考资料。

启动和停止服务器

如果计划使用嵌入的 tomcat 服务器，Jazz 服务器分发文件包括了所需的一切。如果希望使用 WebSphere Application Server，请查看相关说明（

参考资料）。

启动和停止 Tomcat

现在已经可以启动 Tomcat 服务器了。Tomcat 5.5.x 已预安装到 [InstallDir]/jazz/server/tomcat。Jazz Web 应用程序 (jazz.war) 已安装在 Tomcat 的 /webapps 目录中。打开一个命令窗口，并将当前路径设置到 [InstallDir]/jazz/server。服务器启动和关闭脚本位于此目录中。

请注意，Tomcat 在文件 [InstallDir]/jazz/server/tomcat/conf/server.xml 中配置为使用端口 9080 和 9443。如果需要，可以根据您的系统更改端口。

Windows

要启动服务器，可以运行命令：
server.startup.bat

随即将打开一个单独的 Tomcat 控制台窗口。切勿关闭此窗口，否则服务器将停止工作。

要停止服务器，可以运行命令：
server.shutdown.bat

Linux

要启动服务器，可以作为 root 用户运行以下命令：
./server.startup。
如果您的用户 ID 拥有 sudo 访问权限，该权限允许另一个用户 ID 临时获得 root 访问权限，则可以运行以下命令：
sudo ./server.startup

将不会有单独的 Tomcat 控制台窗口可见。可以通过查看位于 jazz/server/tomcat/logs/catalina.out 的日志文件来检查服务器启动进度。

要停止服务器，可以作为 root 用户运行以下命令：
./server.shutdown
如果用户 ID 拥有 sudo 访问权限，可以运行以下命令：
sudo ./server.shutdown

验证 Jazz 服务器安装

打开浏览器并输入以下 URL 以验证服务器的状态。

使用以下 URL 验证 Tomcat 已启动：

http://localhost:9080 .

通过登录到 Jazz Admin Web UI 来验证 Jazz 服务器。缺省的用户 ID 为 ADMIN，密码为 ADMIN：

https://localhost:9443/jazz/admin

您应该看到 Server Health Summary 页面。数据库应该已连接，并且“Service Error Summary”中不应该列出任何错误。如果该页面未加载或服务器有错误，则服务器没有正常启动。请参见联机帮助中的故障排除信息。

使用 Admin Web UI 配置服务器

可以通过位于 https://localhost:9443/jazz/setup 的 Admin Web Setup Wizard 完成初始的服务器配置。

注意：如果使用设置向导启用了电子邮件通知，则必须使用 Admin Web UI 在高级设置页面中设置 ChangeEventMailNotifier 属性的值。这将要求重新启动服务器。

附加的服务器配置可以使用地址 https://localhost:9443/jazz/admin 来通过 Admin Web UI 完成。在该页面上，您将有机会修改许多服务器配置属性，包括：电子邮件设置、数据库连接 Feed 设置和高级设置。选择希望修改的区域，相关属性将显示出来。要做出修改，只需修改文本框中的值，然后在完成时单击“Save Changes”。

所做的许多属性修改无需重新启动服务器即可生效。但是，某些属性在改动后需要重新启动服务器。如果某个属性更改需要服务器重新启动，则在单击“Save”按钮后将会以灰色突出显示该属性。属性旁边和屏幕顶部的确认消息中也有一条消息，指示需要在服务器重新启动以后，更改才会生效。

管理 Jazz 安全性

在初始状态下，Jazz Web 应用程序和 Tomcat 服务器预配置为允许使用端口 9080 进行不安全的客户机/服务器通信。但是要注意，Jazz Admin Web UI 的使用却始终使用通过端口 9443 上的 https 的经过身份验证的安全通信。可以选择使用以下步骤来更改该配置，以使 Jazz 服务器是完全安全的：

通过注释掉位于文件 [installDir]/jazz/server/tomcat/conf/server.xml 中的以下代码，从而禁用端口 9080 上的 Tomcat 连接器：

<!-- Define a non-SSL HTTP/1.1 Connector on port 9080 -->
                <Connector
                port="9080"
                maxHttpHeaderSize="8192"
                maxThreads="150"
                minSpareThreads="25"
                maxSpareThreads="75"
                enableLookups="false"
                redirectPort="9443"
                acceptCount="100"
                connectionTimeout="20000"
                disableUploadTimeout="true"/>

通过启动 tomcat 一次，然后将其关闭，从而展开 tomcat 中的 jazz.war 文件。

在文本编辑器中打开文件 [installDir]/jazz/server/tomcat/webapps/jazz/WEB-INF/web.xml。修改 security-constraint 部分以进行更改：

从以下内容：

<web-resource-collection>
                    <web-resource-name>secure</web-resource-name>
                    <url-pattern>/secure/*</url-pattern>
                    </web-resource-collection>
                    .
                    .
                    .

更改为：

<web-resource-collection>
                    <web-resource-name>secure</web-resource-name>
                    <url-pattern>/*</url-pattern>
                    </web-resource-collection>
                    .
                    .
                    .

在保护服务器以后，Jazz 客户端将必须通过类似于 https://jazzserver:9443/jazz/ 的 URL 连接到端口 9443。

管理 Jazz 用户

出于引导目的，为 Jazz 和 Tomcat 定义了一个 ADMIN 用户。应该更改密码 ADMIN 或者完全禁用这个用户 ID。应该在验证新的用户 ID 可正常工作之后才这样做。

要添加新的 Jazz 用户，可以完成以下步骤：

连接到 Jazz Web Admin UI。

https://localhost:9443/jazz/admin

从 Web Admin UI 中单击 Projects、Teams 和 Users 链接。
单击 Users。
单击 Create New User
输入 Name、User ID 和 Email address，并选择适当的 Repository Permissions。
单击 Save。
从 Web UI 注销或断开客户端连接
使用新的用户 ID 登录。注意：缺省密码将与用户 ID 相同。

在验证新用户 ID 的访问权限之后，应该禁用 ADMIN 用户 ID。要禁用 ADMIN 访问权限，可以完成以下步骤。

在服务器属性页上将“WS Allow Admin Access”属性设置为 False。https://localhost:9443/jazz/admin#action=com.ibm.team.repository.admin.configureAdvanced

如果希望保留 Admin 用户 ID，则应该更改密码。要更改 Admin 密码，必须使用 Eclipse 客户端登录到服务器并修改密码。

安装 Jabber 服务器（可选）

Jazz 具有对使用 Jabber XMPP 协议的聊天的内置支持。Jazz 支持对等聊天、与多个参与者的特别多方聊天，以及聊天室中的持久团队聊天。Jazz 能够连接到各种各样的 Jabber 服务器，包括 Wildfire 3.x.x 和 Openfire 3.4.x Jabber 服务器。

下面的示例使用对 Windows、Linux 和 Mac 可用的 Openfire 3.4.1 服务器。

从位于

http://www.igniterealtime.org/downloads/index.jsp 的 Ignite Realtime.org 下载站点下载并安装 Openfire 3.4.1。有关在本地文件系统上安装该服务器的进一步信息，请参阅与所下载的存档相关联的文档。

Openfire 3.4.1 无需配置即可由 Jazz 使用。在将所有设置设为缺省值的情况下，Jazz 能够成功地连接到 Openfire 3.4.1 服务器。

启动该服务器，启动管理控制台，并创建一个用于管理该服务器的管理员帐户。缺省的管理员 ID 和密码为 admin/admin。

注意：如果将 Jabber 服务器和 Jazz 服务器安装在同一台计算机上，则需要确保禁用 Jabber 服务器的 HTTP 绑定。请在管理控制台的 Server Settings 部分的 HTTP binding 分类下对此进行验证。更改当前使用的端口（8080 和 8483），或在不需要使用 HTTP 绑定的情况下禁用该功能（推荐）。否则，HTTP 绑定可能与 Jazz 服务器使用的端口发生冲突。

从管理控制台注销。

验证服务器在正常运行。在 Web 浏览器中输入 'http://localhost:9090' 并按 Enter 键。Web 浏览器现在应该显示登录屏幕，以登录到该服务器的管理控制台。

Openfire 3.4.1 服务器现在已经可由 Jazz 使用了。有关如何从 Jazz 客户端连接到 Jabber 服务器的信息，请参阅 Jazz Client Setup Guide。

安装 Jazz 客户端并验证到服务器的访问

如果服务器设置和验证步骤取得成功，下面应该安装 Jazz 客户端并验证客户端能够访问服务器。

有些功能（例如更改用户密码和创建第一个项目）不能通过 Web 界面完成，并且要求您已经完成客户端设置。
- 维护服务器
  
  安装新的 Jazz WAR 文件
  如果由于服务器维护而需要安装新的 Jazz WAR（Web 存档）文件，可以按照以下步骤操作。
  
  停止 Tomcat 服务器。
  
  替换 [InstallDir]/jazz/server/tomcat/webapps 中的 jazz.war 文件。
  
  删除目录 [InstallDir]/jazz/server/tomcat/webapps/jazz
  
  删除目录 [InstallDir]/jazz/server/tomcat/work/Catalina/localhost/jazz
  
  启动 Tomcat 服务器。
  
  从早期 Jazz 版本迁移：
  
  如果要从较旧的 Jazz 版本迁移，请记住检查 jazz.net 上公布的最新迁移说明。
  
  其中包含从早期受支持的版本迁移所需要的信息。
  
  存储库工具
  
  Repository Tools Application 是一个独立应用程序，并提供一种管理 Jazz 存储库数据库的方法。
  
  -createTables 选项用于创建空数据库表。有关选项的详细信息，请参见
  
  表 1。
  
  -dropTables 选项用于删除数据库表。有关选项的详细信息，请参见表 2。
  
  -export 选项用于将数据库的内容导出到 TAR 文件。有关选项的详细信息，请参见表 3。
  
  -import 选项用于将 TAR 文件的内容导入某个新数据库。有关选项的详细信息，请参见表 4。
  
  -verify 选项用于验证数据库的完整性。有关选项的详细信息，请参见表 5。此选项通常在 -import 选项之后执行。
  
  -help 选项用于显示命令行用法帮助。

Repository Tools Application 旨在用于执行数据库迁移。该应用程序不打算用于执行数据库备份。有关如何执行备份的信息，请参考数据库供应商的文档。

命令行选项

表 1

，-createTables 选项

参数	是否必需	说明	缺省值
teamserver.properties	否	`teamserver.properties` 文件的系统路径。有关 `teamserver.properties` 文件的更多信息，请参见下面。	./teamserver.properties
logFile	否	要向其写入日志消息的文件。该日志文件是用于诊断问题的宝贵资源。	./repotools.log
noPrompt	否	导致在无需用户确认的情况下创建数据库表。在编写自动化的脚本时，此选项非常有用。	无

示例：

repotools -createTables logFile=/tmp/repotools.log

表 2

，-dropTables 选项

参数	是否必需	说明	缺省值
teamserver.properties	否	`teamserver.properties` 文件的系统路径。有关 `teamserver.properties` 文件的更多信息，请参见下面。	./teamserver.properties
logFile	否	要向其写入日志消息的文件。该日志文件是用于诊断问题的宝贵资源。	./repotools.log
noPrompt	否	导致在无需用户确认的情况下删除数据库表。在编写自动化的脚本时，此选项非常有用。	无

示例：

repotools -dropTables logFile=/tmp/repotools.log

表 3

，-export 选项

参数	是否必需	说明	缺省值
toFile	是	要向其导出数据的 TAR 文件。	无
username	否	用于登录存储库的用户名。	ADMIN
password	否	用于登录存储库的密码。	ADMIN
teamserver.properties	否	`teamserver.properties` 文件的系统路径。有关 `teamserver.properties` 文件的更多信息，请参见下面。	./teamserver.properties
logFile	否	要向其写入日志消息的文件。该日志文件是用于诊断问题的宝贵资源。	./repotools.log
overwrite	否	是否允许覆盖由 `toFile` 选项指定的文件。有效值：`yes`、`no`、`true` 和 `false`。	no

示例：

repotools -export toFile=/export.tar logFile=/tmp/repotools.log

表 4， -import 选项

参数	是否必需	说明	缺省值
fromFile	是	要从中导入数据的 TAR 文件。	无
username	否	用于登录存储库的用户名。	ADMIN
password	否	用于登录存储库的密码。	ADMIN
teamserver.properties	否	`teamserver.properties` 文件的系统路径。有关 `teamserver.properties` 文件的更多信息，请参见下面。	./teamserver.properties
logFile	否	要向其写入日志消息的文件。该日志文件是用于诊断问题的宝贵资源。	./repotools.log
noPrompt	否	导致在无需用户确认的情况下创建数据库表。在编写自动化的脚本时，此选项非常有用。	无
noVerify	否	跳过导入后验证阶段。建议执行验证，并且在需要时，可以使用 `-verify` 选项来单独执行验证。	无

示例：

repotools -import fromFile=/export.tar logFile=/tmp/repotools.log

表 5， -verify 选项

参数	是否必需	说明	缺省值
username	否	用于登录存储库的用户名。	ADMIN
password	否	用于登录存储库的密码。	ADMIN
teamserver.properties	否	`teamserver.properties` 文件的系统路径。有关 `teamserver.properties` 文件的更多信息，请参见下面。	./teamserver.properties
logFile	否	要向其写入日志消息的文件。该日志文件是用于诊断问题的宝贵资源。	./repotools.log
level	否	验证级别。一个介于 1 和 10 之间的数字。	1

示例：

repotools -verify level=5 logFile=/tmp/repotools.log

Repotools 和 teamserver.properties

请注意，teamserver.properties 文件缺省配置为使用与 repotools 脚本相同的目录中的 Derby 数据库 repositoryDB： [InstallDir]/jazz/server。如果从不同的目录运行脚本，则需要编辑属性 db.jdbc.location 并提供数据库位置的绝对路径。

参考资料

学习

本文中文版由 Jazz.net 授权发布。您可以通过免费注册成为 Jazz.net 的用户，查看本文的英文原文。
本文中所涉及的 Jazz 使用的许可证、协议和版权声明，包含在本文的英文原文中。请注册成为免费注册的 Jazz.net 用户，查看此 Jazz 使用的许可证、协议和版权声明。
如果计划使用嵌入的 tomcat 服务器，Jazz 服务器分发文件包括了所需的一切。如果希望使用 WebSphere Application Server，相关说明包含在本文的英文原文中：“在 WebSphere Application Server 上安装 Jazz”。
对于具有较高性能和大型存储库的情况，可以将 Jazz 服务器配置为使用以下数据库中的一种，相关说明包含在本文的英文原文中：
- DB2：Jazz 已使用 DB2 V9.1 进行了测试。这里是用于设置 Jazz 与 DB2 的说明。
- DB2 for i5/OS：Jazz 已使用 V5R4 和 V6R1 进行了测试。这里是用于设置 Jazz 与 DB2 for i5/OS 的说明。
- DB2 for z/OS：Jazz 已使用 DB2 V9.1 for z/OS 进行了测试。这里是用于设置 Jazz 与 DB2 for z/OS 的说明。
- Oracle：Jazz 已使用 Oracle Database 10g 进行了测试。这里是用于设置 Jazz 与 Oracle 的说明。
您可以通过本文的姐妹篇 Jazz 客户端安装指南了解如何安装 Jazz 客户端。
通过 developerWorks 中国网站的 Jazz 资源中心这里汇集了丰富的 Jazz 平台中文技术资源。您可以通过这里了解更多关于 Jazz 平台和相关技术的信息。
Jazz 新手入门为您全面介绍 Jazz 平台的技术概览，并提供相关的入门学习资源。从这里起步，了解 Jazz 平台，尝试全新的跨地域分布式协作开发方式。
查看最新的 Jazz 演示和多媒体，快速学习这一最新的软件交付协作技术，深入了解 Jazz 平台。
访问 IBM developerWorks 中国网站 Rational 专区，获得关于 IBM Rational 软件交付平台（Rational Software Delivery Platform）产品的技术资源和非常好的实践。

关注我们