Jazz: Team Concert 客户端安装指南

引言

欢迎使用 Jazz。安装 Jazz 的工作由单独的服务器和客户端安装组成。如果还没有安装 Jazz 服务器,您应该首先安装该服务器,然后再安装 Jazz 客户端。

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

Jazz 客户端在以下平台上受支持

  • Microsoft Windows XP
  • Redhat Enterprise Linux WS 4
  • Mac OS X 10.4.x (Tiger)

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

  • 推荐 Firefox 2.0,支持 Firefox 1.5
  • 推荐 Microsoft Internet Explorer 7,支持 Internet Explorer 6

系统要求

确保将在其上安装 Jazz 客户端的计算机满足以下基本要求。

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

许可证

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

安装步骤

客户端安装过程涉及到以下步骤。

  1. 安装 Jazz 客户端分发文件。
  2. 启动 Jazz 客户端。
  3. 连接到 Jazz 服务器。
  4. 连接到本地 Sametime 7.5.1 应用程序(可选)。
  5. 连接到 Jabber 服务器(可选)。
  6. 安装 Jazz 源代码(可选)。

安装 Jazz 客户端分发文件

Jazz 客户端是作为一个可下载的 Zip 文件并通过 IBM Installation Manager 进行分发的。您应该下载 Jazz 客户端 Zip 或 IBM Installation Manager 安装程序,具体取决于您更喜欢哪一种分发机制。

如果选择使用 IBM Installation Manager

  1. TeamConcert-Installer Zip 解压缩到某个临时目录(例如 C:/temp
  2. 运行安装程序(例如 C:/temp/install.exe

当安装完成时,您将拥有一个名为“Rational Team Concert”的新的启动程序快捷方式,可将其用于启动该客户端。

如果选择使用 Jazz 客户端 Zip

将 Jazz 客户端 Zip 文件解压缩到所选择的安装目录(例如,文件 TeamConcert-[build]-[platform])。相对于所选择的安装目录,Jazz 客户端的路径将为 [InstallDir]/jazz/client

启动 Jazz 客户端

如果是使用 IBM Installation Manager 来安装的 Jazz 客户端,则通过选择安装程序创建的“Rational Team Concert”快捷方式来启动该客户端。如果是使用客户端 Zip 来安装的 Jazz 客户端,则双击 [InstallDir]/jazz/client/eclipse 目录中的 TeamConcert.exe 应用程序。

连接到 Jazz 服务器

在 Jazz 客户端已启动之后:

  • 关闭 Welcome 透视图或单击“Go to the Workbench”链接,以转到 WorkItems 透视图。
  • WorkItems 视图提供了一些入门帮助。单击标签为“Connect to Project Area”的链接以建立连接。还可以从 Team Artifacts 视图中完成此任务,该视图与 Package Explorer 一起堆叠在左侧的列中。在视图工具栏上单击 Connect to Project Areas 图标。
  • 选择 Create a new repository connection 并单击 Next。在连接对话框中填写以下字段:
    • URI: http://[server host name]:[port]/jazz。

      如果服务器在同一台计算机上运行,则服务器主机名称将为 localhost,并且可以从下拉列表中选择 localhost 服务器 URI。

    • User Name:输入预定义的用户:ADMIN,密码:ADMIN

      图 1:输入预定义的用户
      输入预定义的用户

    • 单击 Next

  • 在第一次将客户端连接到存储库时,您需要创建一个在其中工作的项目区域 (Project Area)。随后的客户端可以跳过此步骤,并从现有的项目区域中做出选择。
  • 单击“Go to the Create Project Area wizard”链接。

    图 2:单击“Go to the Create Project Area wizard”链接。
    “Go to the Create Project Area wizard”

  • 填写项目的详细信息,使用诸如“My Project”等名称来命名该项目区域。

    图 3:命名该项目区域
    命名该项目区域

  • 通过单击 Next 按钮继续,并选择您希望用于该项目的流程。同样,第一个客户端需要做一些额外的设置。服务器中没有定义现成的流程。客户端将会识别这一点,并提示您将模板部署到存储库。单击 Deploy Templates 按钮:

    图 4:单击 Deploy Templates 按钮
    单击 Deploy Templates 按钮

  • 为您的项目选择其中一个缺省流程。

    图 5:为项目选择其中一个缺省流程
    为项目选择其中一个缺省流程

  • 单击 Finish 以创建项目区域并连接到该项目区域。

    如果连接成功,则存储库图标上的“连接”装饰应该是绿色的。展开“My Project”节点应该会显示各种 Jazz 项。



    图 6:展开“My Project”节点
    展开“My Project”节点

注意:截止到今天,连接到 Notes 8 需要安装一些来自 Sametime 7.5.1 的附加插件,这些插件不是常规 Notes 8 安装的一部分。您需要有一个有效的 Sametime 7.5.1 安装才能设置 Notes 8 以便与 Jazz 协作。

Jazz 具有对使用 Sametime 7.5.1 或 Notes 8 应用程序的同步协作的内置支持。Jazz 支持对等聊天和与多个参与者的多方聊天。

如果希望使用 IBM Lotus Notes 8 的即时消息支持,可以从 http://www-1.ibm.com/support/docview.wss?rs=475&uid=swg24015327 获取该支持。下载该文件并将其安装在本地计算机上。

注意:已经安装了某个与 Jazz 插件一起运行的现有 Sametime 7.5.1 版本的 Jazz 用户必须卸载该版本,然后才能安装与 Jazz 0.6 Beta 2 产品一起使用的 Sametime 7.5.1。或者,在安装新版本之前,您还可以卸载所有名称以“Synchronous Collaboration”开头的功能。这样可以避免丢失任何首选项设置。

注意:请确保将 Sametime 或 Notes 安装目录中的 plugin_customization.ini 中的属性 com.ibm.collaboration.realtime.brokerbridge/startBroker 设置为 true。这将启用与 Jazz 客户端的通信。在 Notes 8 中,该文件位于 NOTES_HOME/framework/rcp/plugin_customization.ini。在 Notes 7.5.1 中,该文件位于 SAMETIME_HOME/plugin_customization.ini。如果该属性不存在,只需在现有的属性之外添加该属性。

取决于您是要向 Sametime 7.5.1 还是要向 Notes 8 添加 Jazz 支持,可以相应地按照以下步骤操作:

使用 Sametime:启动 Sametime 7.5.1 并安装必要的 Jazz 插件。

  • 选择 Tool>Plug-Ins>Install Plug-ins...
  • 选择 Search for new features to install 并单击 Next
  • 使用 TEAM_CONCERT_HOME/jazz/client/sametime 创建一个本地更新站点,其中 TEAM_CONCERT_HOME 表示本地文件系统上解压缩 Team Concert 下载包的位置。
  • 使用 Team Concert Update Site 作为新的更新站点的名称。
  • 确保选择所创建的更新站点并单击 Finish
  • 在随后的对话框中,选择更新站点中的所有功能并单击 Next
  • 通过接受许可证完成安装,并重新启动 Sametime 7.5.1

使用 Notes:启动 Notes 8 并安装必要的 Jazz 插件。

  • 确保 Notes 安装目录中的 plugin_customization.ini 中的属性 com.ibm.notes.branding/enable.update.ui 设置为 true。通常,该文件位于 NOTES_HOME/framework/rcp/plugin_customization.ini。如果该属性不存在,只需在现有的属性之外添加该属性。
  • 将以下插件从 Sametime 7.5.1 安装中复制到 NOTES_HOME/framework/rcp/plugins 目录:
    • com.ibm.collaboration.realtime.brokerbridge
    • com.ibm.collaboration.realtime.brokerbridge.constants
    • com.ibm.micro
  • 重新启动 Notes 8
  • 选择 File>Application>Install
  • 选择 Search for new features to install 并单击 Next
  • 使用 TEAM_CONCERT_HOME/jazz/client/sametime 创建一个本地更新站点,其中 TEAM_CONCERT_HOME 表示本地文件系统上解压缩 Team Concert 下载包的位置。
  • 使用 Team Concert Update Site 作为新的更新站点的名称。
  • 确保选择所创建的更新站点并单击 Finish
  • 在随后的对话框中,选择更新站点中的所有功能并单击 Next
  • 通过接受许可证完成安装,并重新启动 Notes 8

Sametime 7.5.1Notes 8 现在已经准备好与 Jazz 通信了。对于某些功能,例如在您输入时自动识别指向 Jazz 构件的链接,您还必须设置存储库连接。

  • 转到 Sametime 7.5.1Notes 8Jazz Repositories 首选项页面,并添加一个新的存储库连接。
  • 输入 http://localhost:9080/jazz 作为存储库路径。该存储库位置必须对应于在本指南前面创建的存储库。
  • 单击 OK 以添加该存储库连接。

现在您已成功安装了 Sametime 7.5.1Notes 8,并对其进行了配置以便与 Jazz 客户端通信。有关同步协作的一般信息,请参考 Jazz wiki。

使用以下步骤连接到某个正在运行的 Sametime 7.5.1Notes 8 应用程序:

  • 转到 Instant Messaging 首选项页面。
  • 单击 Add... 以添加一个新的 IM 帐户。选择 Sametime 7.5.1 作为服务提供者。取决于您的 Sametime 帐户,您必须输入以下设置:
    • Sametime ID:[您的 Sametime ID]
    • 选中 Start Sametime automatically 并指定 Sametime 7.5.1 可执行文件在本地文件系统上的路径。请注意,这是可选的,与 Sametime 7.5.1 通信不一定需要此设置。如果希望自动启动 Notes 8,只需指定 Notes 8 可执行文件的路径。
    • Use as default account: Yes
  • 单击 Connect 以连接到在本地运行的应用程序。
  • 该 IM 帐户现在以绿色的粗体显示,从而反映您的在线状态。您已经成功连接到了 Sametime 7.5.1Notes 8 应用程序。

在建立连接之后,就可以开始与团队成员聊天了。

  • 转到 Team Artifacts 视图,展开 My Team Areas。选择一个或多个当前在线的 Jazz 用户,并从上下文菜单中选择 Chat...。现在您已经参与了与所选 Jazz 用户的对等聊天或多方聊天。

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

有关如何安装 XMPP 服务器的信息,请参阅 Jazz Server Setup Guide。您还可以查看一下 Jazz wiki,以了解有关同步协作的一般信息。

使用以下步骤连接到某个正在运行的 Jabber XMPP 服务器:

  • 转到 Instant Messaging 首选项页面。
  • 单击 Add... 以添加一个新的 IM 帐户。选择 Jabber Server 作为服务提供者。取决于服务器配置,您必须输入下面的全部或者只是其中的部分设置。Jazz 允许自动配置:
    • Server:[输入服务器 URI,或者对于本地测试服务器为 localhost]
    • Port:52225223,具体取决于服务器配置和是否要使用安全连接
    • User ID:[输入一个新的 Jabber 用户 ID,或者使用 Jabber 服务器管理员提供的某个现有用户 ID]
    • Password:[输入新的用户密码,或者使用 Jabber 服务器管理员提供的现有密码]
    • Resource:[输入可选的 XMPP 资源,例如“家庭”、“办公室”、“旅行”等等,以指示您的状态或地理位置]
    • Use this as the default account: Yes
  • 注意:如果手边有全新的 Jabber 服务器安装,您可以随心所欲地选择 Jabber 用户 ID 和初始密码。Jazz 将基于那些凭据自动创建 Jabber 帐户。如果希望连接到现有的 Jabber 服务器,可以根据需要联系管理员以获取 Jabber 用户 ID 和密码。
  • 单击 Connect 以连接到 Jabber 服务器。
  • 该 IM 帐户现在以绿色的粗体显示,从而反映您的在线状态。您已经成功连接到 Jabber 服务器。

在连接到 Jabber 服务器之后,您就可以开始与团队成员聊天了:

  • 转到 Team Artifacts 视图,展开 My Team Areas。选择一个或多个当前在线的 Jazz 用户,并从上下文菜单中选择 Chat...。现在您已经参与了与所选 Jazz 用户的对等聊天或多方聊天。
  • 或者,您还可以在 Team Artifacts 视图中右键单击某个已连接的项目区域,并使用 Join Team Discussion... 进入与所选项目区域或团队区域相关联的聊天室。

Jazz 源代码是为对于扩展 Jazz 感兴趣的开发人员准备的。在目前的 Jazz 开发状态下,源代码未包含用于开发 Jazz 扩展的工具或技术信息。将来的里程碑中将会改变这一状况。

要安装源代码,可以按照以下步骤操作。

  • 将客户端源代码分发版本(名为 TeamConcert-Source-[build id].zip)文件解压缩到安装 Jazz 客户端的相同位置。
  • 现在您可以使用标准的 Eclipse 导入插件机制,将 Jazz 插件导入为带有源代码文件夹的项目。

    在导入步骤之前,建议首先转到 Plug-in Development 透视图。使用菜单操作 File>Import...>Plug-in Development>Plug-ins and Fragments 导入相关 Jazz 插件。在导入向导对话框中,选择 Projects with source folders。在下一个页面上,选择您感兴趣的插件并完成向导。

下面是一些建议的问题管理技术。

  • 从空的工作区开始。
  • 客户端和服务器版本必须匹配。确保客户端和服务器分发文件的版本 ID 匹配。
  • 确保服务器已启动。使用状态 URL 进行确认: http://[server host name]:[port]/jazz

阅读更多

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