连接到本地 Sametime 7.5.1 或 Notes 8 应用程序(可选)。
注意:截止到今天,连接到 Notes 8 需要安装一些来自 Sametime 7.5.1 的附加插件,这些插件不是常规 Notes 8 安装的一部分。您需要有一个有效的 Sametime 7.5.1 安装才能设置 Notes 8 以便与 Jazz 协作。 Jazz 具有对使用 Sametime 7.5.1 或 Notes 8 应用程序的同步协作的内置支持。Jazz 支持对等聊天和与多个参与者的多方聊天。
从 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。
如果希望使用 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 用户的对等聊天或多方聊天。
连接到 Jabber 服务器(可选)。
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
注意:如果手边有全新的 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 开发状态下,源代码未包含用于开发 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