级别： 初级 Jazz .net, 编辑,
IBM
2008 年 4 月 28 日
欢迎使用 Jazz。安装 Jazz 的工作由单独的服务器和客户端安装组成。本文介绍如何安装 Jazz 服务器。
您可以通过本文的姐妹篇 Jazz 客户端安装指南 了解如何安装 Jazz 客户端。
引言
安装 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
许可证
控制您的 Jazz 使用的许可证、协议和版权声明可以在本文的 参考资料 中找到。
安装步骤
服务器安装过程涉及到以下步骤。
- 安装 Jazz 服务器分发文件。
- [可选：创建和配置数据库。]
- [可选：配置 WebSphere Application Server (WAS)。]
- 启动服务器。
- 验证安装。
- 使用 Admin Web UI 配置服务器。
- 管理 Jazz 安全性。
- 管理 Jazz 用户。
- [可选：安装并验证 Jabber 服务器。]
- 安装 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 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
Linux
打开浏览器并输入以下 URL 以验证服务器的状态。
可以通过位于 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 客户端登录到服务器并修改密码。
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 客户端并验证客户端能够访问服务器。
有些功能（例如更改用户密码和创建第一个项目）不能通过 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）产品的技术资源和最佳实践。
获得产品和技术
讨论
- 参加 Rational 大学，与 IBM Rational 专家一起分享 Rational 产品最佳实践。
- 访问 developerWorks 上的 Jazz Space，了解 developerWorks 上所有关于 Jazz 的最新资源，包括博客、产品演示、RSDC 讲座、Podcast、Webcast，以及 基于 Jazz 的商用产品试用版下载等资源。
关于作者  | | | Jazz 是 IBM Rational 面向软件交付技术的下一代协作平台。Jazz 项目是一个开放的项目，它采用一种全新的开发模式——开放商业软件开发来开发其项目。Jazz 项目由 Jazz.net 负责维护。您可以通过 Jazz.net 了解更多关于该项目的信息。 |
对本文的评价
| 
