Jazz: Jazz Team 服务器安装指南

引言

安装 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-libsxorg-x11-libsxorg-x11-Mesa-libGL
  • Tomcat 用户的缺省文件句柄限制应该增加到 5000。在 Redhat Enterprise Linux 上,这可以通过将以下行添加到 /etc/security/limits.conf 来实现
    tomcat_user hard nofile 5000 tomcat_user soft nofile 5000

控制您的 Jazz 使用的许可证、协议和版权声明可以在本文的 参考资料 中找到。

安装步骤

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

  1. 安装 Jazz 服务器分发文件。
  2. [可选:创建和配置数据库。]
  3. [可选:配置 WebSphere Application Server (WAS)。]
  4. 启动服务器。
  5. 验证安装。
  6. 使用 Admin Web UI 配置服务器。
  7. 管理 Jazz 安全性。
  8. 管理 Jazz 用户。
  9. [可选:安装并验证 Jabber 服务器。]
  10. 安装 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。如果需要,可以根据您的系统更改端口。

WindowsLinux验证 Jazz 服务器安装 使用 Admin Web UI 配置服务器 管理 Jazz 安全性

  • 要启动服务器,可以运行命令:
    server.startup.bat

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

  • 要停止服务器,可以运行命令:
    server.shutdown.bat

  • 要启动服务器,可以作为 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

打开浏览器并输入以下 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”中不应该列出任何错误。如果该页面未加载或服务器有错误,则服务器没有正常启动。请参见联机帮助中的故障排除信息。

可以通过位于 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 Web 应用程序和 Tomcat 服务器预配置为允许使用端口 9080 进行不安全的客户机/服务器通信。但是要注意,Jazz Admin Web UI 的使用却始终使用通过端口 9443 上的 https 的经过身份验证的安全通信。可以选择使用以下步骤来更改该配置,以使 Jazz 服务器是完全安全的:

  1. 通过注释掉位于文件 [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"/>
    

  2. 通过启动 tomcat 一次,然后将其关闭,从而展开 tomcat 中的 jazz.war 文件。
  3. 在文本编辑器中打开文件 [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 用户,可以完成以下步骤:

  1. 连接到 Jazz Web Admin UI。
    https://localhost:9443/jazz/admin
    

  2. 从 Web Admin UI 中单击 Projects、Teams 和 Users 链接。
  3. 单击 Users。
  4. 单击 Create New User
  5. 输入 Name、User ID 和 Email address,并选择适当的 Repository Permissions。
  6. 单击 Save。
  7. 从 Web UI 注销或断开客户端连接
  8. 使用新的用户 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.xOpenfire 3.4.x Jabber 服务器。

下面的示例使用对 Windows、Linux 和 Mac 可用的 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 分类下对此进行验证。更改当前使用的端口(80808483),或在不需要使用 HTTP 绑定的情况下禁用该功能(推荐)。否则,HTTP 绑定可能与 Jazz 服务器使用的端口发生冲突。

从管理控制台注销。

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

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

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

有些功能(例如更改用户密码和创建第一个项目)不能通过 Web 界面完成,并且要求您已经完成客户端设置。

如果由于服务器维护而需要安装新的 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 选项用于创建空数据库表。有关选项的详细信息,请参见
  • -dropTables 选项用于删除数据库表。有关选项的详细信息,请参见 表 2
  • -export 选项用于将数据库的内容导出到 TAR 文件。有关选项的详细信息,请参见 表 3
  • -import 选项用于将 TAR 文件的内容导入某个新数据库。有关选项的详细信息,请参见 表 4
  • -verify 选项用于验证数据库的完整性。有关选项的详细信息,请参见 表 5。此选项通常在 -import 选项之后执行。
  • -help 选项用于显示命令行用法帮助。

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

  • 命令行选项

表 1-createTables 选项 -dropTables 选项 -export 选项 表 4, -import 选项 表 5, -verify 选项

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

示例:

repotools -createTables logFile=/tmp/repotools.log

表 2

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

示例:

repotools -dropTables logFile=/tmp/repotools.log

表 3

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

示例:

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

参数 是否必需 说明 缺省值
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

参数 是否必需 说明 缺省值
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 并提供数据库位置的绝对路径。

阅读更多
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭