Jazz Team服务器安装指南
欢迎使用 Jazz。安装 Jazz 的工作由单独的服务器和客户端安装组成。本文介绍如何安装 Jazz 服务器。
引言
安装 Jazz
|
|
服务器安装包包括了所需的所有内容；其中为 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.batLinux
要启动服务器，可以作为 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 界面完成，并且要求您已经完成客户端设置。