欢迎使用 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 使用的许可证、协议和版权声明可以在本文的 参考资料 中找到。
客户端安装过程涉及到以下步骤。
- 安装 Jazz 客户端分发文件。
- 启动 Jazz 客户端。
- 连接到 Jazz 服务器。
- 连接到本地 Sametime 7.5.1 应用程序(可选)。
- 连接到 Jabber 服务器(可选)。
- 安装 Jazz 源代码(可选)。
Jazz 客户端是作为一个可下载的 Zip 文件并通过 IBM Installation Manager 进行分发的。您应该下载 Jazz 客户端 Zip 或 IBM Installation Manager 安装程序,具体取决于您更喜欢哪一种分发机制。
如果选择使用 IBM Installation Manager
- 将
TeamConcert-Installer
Zip 解压缩到某个临时目录(例如C:/temp
) - 运行安装程序(例如
C:/temp/install.exe
)
当安装完成时,您将拥有一个名为“Rational Team Concert”的新的启动程序快捷方式,可将其用于启动该客户端。
如果选择使用 Jazz 客户端 Zip
将 Jazz 客户端 Zip 文件解压缩到所选择的安装目录(例如,文件 TeamConcert-[build]-[platform]
)。相对于所选择的安装目录,Jazz 客户端的路径将为 [InstallDir]/jazz/client
。
如果是使用 IBM Installation Manager 来安装的 Jazz 客户端,则通过选择安装程序创建的“Rational Team Concert”快捷方式来启动该客户端。如果是使用客户端 Zip 来安装的 Jazz 客户端,则双击 [InstallDir]/jazz/client/eclipse
目录中的 TeamConcert.exe
应用程序。
在 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”链接。 - 填写项目的详细信息,使用诸如“My Project”等名称来命名该项目区域。
图 3:命名该项目区域 - 通过单击 Next 按钮继续,并选择您希望用于该项目的流程。同样,第一个客户端需要做一些额外的设置。服务器中没有定义现成的流程。客户端将会识别这一点,并提示您将模板部署到存储库。单击 Deploy Templates 按钮:
图 4:单击 Deploy Templates 按钮 - 为您的项目选择其中一个缺省流程。
图 5:为项目选择其中一个缺省流程 - 单击 Finish 以创建项目区域并连接到该项目区域。
如果连接成功,则存储库图标上的“连接”装饰应该是绿色的。展开“My Project”节点应该会显示各种 Jazz 项。
图 6:展开“My Project”节点
- 连接到本地 Sametime 7.5.1 或 Notes 8 应用程序(可选)。 http://www-142.ibm.com/software/sw-lotus/products/product3.nsf/wdocs/st75home 获取 IBM Lotus Sametime Connect 7.5.1(如果还没有这样做的话)。下载功能完整的试用版并将其安装在本地计算机上。如果喜欢扩展的 Sametime 7.5.1 版本和有用的附加功能,倘若能够访问 IBM TAP (Technology Access Program),则还可以从 http://sametime.tap.ibm.com/index.php 检索 Sametime 7.5.1。
注意:截止到今天,连接到 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.1 或 Notes 8 现在已经准备好与 Jazz 通信了。对于某些功能,例如在您输入时自动识别指向 Jazz 构件的链接,您还必须设置存储库连接。
- 转到 Sametime 7.5.1 或 Notes 8 的 Jazz Repositories 首选项页面,并添加一个新的存储库连接。
- 输入
http://localhost:9080/jazz
作为存储库路径。该存储库位置必须对应于在本指南前面创建的存储库。 - 单击 OK 以添加该存储库连接。
现在您已成功安装了 Sametime 7.5.1 或 Notes 8,并对其进行了配置以便与 Jazz 客户端通信。有关同步协作的一般信息,请参考 Jazz wiki。
使用以下步骤连接到某个正在运行的 Sametime 7.5.1 或 Notes 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.1 或 Notes 8 应用程序。
在建立连接之后,就可以开始与团队成员聊天了。
- 转到 Team Artifacts 视图,展开 My Team Areas。选择一个或多个当前在线的 Jazz 用户,并从上下文菜单中选择 Chat...。现在您已经参与了与所选 Jazz 用户的对等聊天或多方聊天。
Jazz 具有对使用 XMPP 协议的聊天的内置支持。Jazz 支持对等聊天、与多个参与者的特别多方聊天,以及聊天室中的持久团队聊天。Jazz 能够连接到各种支持 XMPP 协议的服务器,包括流行的 Wildfire 3.x.x 和 Openfire 3.4.x Jabber 服务器。
有关如何安装 XMPP 服务器的信息,请参阅 Jazz Server Setup Guide。您还可以查看一下 Jazz wiki,以了解有关同步协作的一般信息。
使用以下步骤连接到某个正在运行的 Jabber XMPP 服务器:
- 转到 Instant Messaging 首选项页面。
- 单击 Add... 以添加一个新的 IM 帐户。选择 Jabber Server 作为服务提供者。取决于服务器配置,您必须输入下面的全部或者只是其中的部分设置。Jazz 允许自动配置:
- Server:[输入服务器 URI,或者对于本地测试服务器为
localhost
] - Port:
5222
或5223
,具体取决于服务器配置和是否要使用安全连接 - User ID:[输入一个新的 Jabber 用户 ID,或者使用 Jabber 服务器管理员提供的某个现有用户 ID]
- Password:[输入新的用户密码,或者使用 Jabber 服务器管理员提供的现有密码]
- Resource:[输入可选的 XMPP 资源,例如“家庭”、“办公室”、“旅行”等等,以指示您的状态或地理位置]
- Use this as the default account:
Yes
- Server:[输入服务器 URI,或者对于本地测试服务器为
- 注意:如果手边有全新的 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