Jazz 技术文档团队 Jazz.net, 编辑, IBM Rational
2009 年 2 月 09 日 这里提供了帮助您了解成功安装 Rational Team Concert 客户端所需要的信息。
客户端安装概述
有两种安装 Rational® Team Concert 客户端的方法。
Jazz™ Team Server, Rational Team Concert 客户端, Build System Toolkit, ClearCase® Connector, ClearQuest® Connector 以及其它孵化文件都可以从 http://jazz.net 网站下载。要购买 Rational Team Concert,你可以去 http://www.ibm.com/software/awdtools/rtc/ 网站,下载一个可安装的镜像,或者订购一张 DVD。
选择一种安装方式:
-
下载一个完整的压缩文件并,将它解压到一个可操作的位置。
-
下载一个可执行文件,它将运行 IBM® Installation Manager 启动程序,从而引导你完成整个安装过程。
注意:Installation Manager 有一个本地安装和一个 Web 安装。本地安装需要下载所有你需要的资源,并在没有互联网连接的情况下进行安装。而 Web 安装需要下载的资源较少,在安装过程需要有互联网的连接。最后的结果是一样的,只是安装过程不同而已。
注意:如果 Security-Enhanced Linux® (SELinux) 是激活的,你 必须 使它无效或者更改 Java Runtime Environment (JREs) 的安全上下文,从而为了安装和运行 Rational Team Concert 而允许文本的重置。要获得更多的信息,请看 Installing Rational Team Concert with Security-Enhanced Linux。
注意:如果你打算将 Rational Team Concert 安装到一个现有的基于 eclipse 的产品中(有时是指框架共享),你就需要采用 Installation Manager 安装方法。Installation Manager 通过允许你选择将此客户端安装到一个现有的 eclipse 实例中来简化框架共享过程。
使用 IBM Installation Manager 安装客户端
客户端像一个通过 IBM® Installation Manager 的可下载文件一样被分配。
注意:如果你想要将这个客户端安装到一个现有的 Eclipse 工作台,可以使用 IBM Installation Manager 来安装。IBM Installation Manager 安装提示你想要扩展的工作台,并负责管理以后工作台的更新,回滚,以及更改
-
下载下面这些安装包中其中任意一个。
这里有三种安装 Rational® Team Concert 客户端的方法。
-
Client CD Contents .zip file - Installation Manager local install for client:这个档案文件包括 Installation Manager 启动程序以及 Rational Team Concert 客户端的本地拷贝。使用本地安装包的好处是,可以在没有互联网连接的情况下进行安装。这是一个非自我解压的压缩文件。
-
Installation Manager Web install for client, server, and optional components:这个档案文件包括 Installation Manager 启动程序以及预先确定的安装存储位置。这是一个自我解压文件,它将在解压内容之后启动这个 IBM Installation Manager 启动程序。使用 Web 安装包的好处是,可以最初下载的内容和安装过程,只需下载你选择安装的资源。
注意:Web 安装的安装过程需要连接互联网。
-
Full DVD Contents .zip file: 这个档案文件包括 Installation Manager 启动程序以及所以可安装资源的拷贝。使用本地安装包的好处是,可以在没有互联网连接的情况下进行安装。这个压缩文件是可以非自我解压的文件。
-
开始这个启动程序。
如果这个 Installation Manager 还没有运行,可以完全按照以下的步骤来启动它。
注意:你必须有管理员权限来运行这个启动程序。
开始这个启动程序文件:
-
如果你使用的是 Client CD Contents .zip file,将这个档案文件解压到一个临时地址并运行这个启动程序。开始这个启动程序文件:
-
在 Windows 系统上运行这个文件,运行这个命令:
launchpad.exe
-
在 Linux 系统上运行这个文件,运行这个命令:
sh launchpad.sh
-
如果你使用的是 Installation Manager Web install,就要运行这个可执行文件。当这个文件解压到一个地址时就会出现一个启动程序。启动这个可执行文件:
-
在 Windows系统上运行这个文件,运行这个命令:
RTC-edition-Full-version-Win-Web.exe
-
在 Linux 系统上运行这个文件,运行这个命令:
sh RTC-edition-Full-version-Linux-Web.sh
-
如果你使用的是 Full DVD Contents .zip file, 将这个档案文件的内容解压到一个临时地址,并运行这个启动程序。开始这个启动程序文件:
-
在 Windows 系统上运行这个文件,运行这个命令:
launchpad.exe
-
在 Linux 系统上运行这个文件,运行这个命令:
sh launchpad.sh
-
点击 Rational Team Concert 客户端连接,从而开始客户端的安装。
-
启动客户端。通过点击安装所创建的 Rational Team Concert 快捷方式来启动客户端。
-
连接到服务器。连接到服务器最简单的方法是采用 Team Invitation。如果你还没有被邀请,你就要手工进行连接。
-
在 Welcome Screen 上点击 Accept an invitation to join a Jazz™ team area。这个向导会引导你完成这个过程。
注意:如果你还没有收到邀请,你就需要你的服务器管理提供的URI。(这个网站中有一个案例模式:https://example.com:9443/jazz)。 点击并连接到一个现有项目区域超级连接,这个超级连接显示在 Accept Team Invitation 窗口的右下角。
-
按照这个向导中的操作指南来创建你的连接。
故障诊断: 这里有一些被提出的管理技术方面的问题。
-
以一个空白工作区开始。
-
客户端和服务器端的工作版本必须相匹配。确保这个工作版本 ID 与客户端和服务器端的分配都相匹配。
-
确保这个服务器已经开启。确认使用的是这个状态 URL: https://example.com:9443/jazz 。
-
在 Linux 系统上,如果你想要从 JazzInstallDir/client/eclipse 以外的地址启动这个客户端,那么你必须更改 JazzInstallDir/client/eclipse/links/ 中的每个文件,包括到指定地址的完整路径。例如, JazzInstallDir/client/eclipse/links/build.link 包括文本 "path=jazz/build"。如果你的客户端安装在地址/home/username/teamconcert中,就要编辑这个文件使其看起来如"path=/home/username/teamconcert/jazz/client/eclipse/build"所示。
使用一个压缩文件安装客户端
这个客户端像一个可下载压缩文件一样被分配。
-
下载这个客户端包文件。
你应该下载 Rational® Team Concert 客户端压缩文件。
注意:如果你想要将这个客户端安装到一个现有的 Eclipse 工作台中,就要使用 IBM Installation Manager。这个 IBM Installation Manager 安装会向你提示你想要扩展的工作台,以及负责管理以后工作台的更新,回滚,以及更改
-
安装这个客户端分配。将这个压缩文件解压到你选择的一个安装地址中(例如, /opt/IBM/ on Linux® or c:\IBM on Windows®,)。相对于你选择的安装地址,客户端路径是JazzInstallDir/client。
-
启动这个客户端。 双击 JazzInstallDir/client/eclipse 地址中的 TeamConcert.exe 应用程序。
-
连接到服务器。连接到服务器最简单的方法是使用 Team Invitation。如果你还没有收到邀请,就要手工进行连接。
-
在 Welcome Screen 中点击 Accept an invitation to join a Jazz™ team area。 这个向导会引导你完成这个过程。
注意:如果你还没有接收到邀请,就需要你的服务器所提供的 URI。(https://example.com:9443/jazz 中有一个案例模式)。点击并连接到一个现有项目区域超级连接,这个超级连接显示在 Accept Team Invitation 窗口的右下角。
-
按照这个向导中的操作指南来创建你的连接。
故障诊断: 这里有一些提出的关于管理技术的问题。
-
从一个空白工作区开始。
-
客户端和服务器端的工作版本必须相匹配。确保这个工作版本 ID 与客户端和服务器端的分配都相匹配
-
确保这个服务器已经开启。确认使用的是这个状态 URL: https://example.com:9443/jazz.
-
在 Linux 系统上,如果你想要从 JazzInstallDir/client/eclipse 以外的地址启动这个客户端,那么你必须更改 JazzInstallDir/client/eclipse/links/ 中的每个文件,包括到指定地址的完整路径。默认情况下,会使用这个相对路径。例如, JazzInstallDir/client/eclipse/links/build.link 包括文本 "path=jazz/build"。如果你的客户端安装在地址 /home/username/teamconcert 中,就要编辑这个文件使其看起来如 "path=/home/username/teamconcert/jazz/client/eclipse/build"所示的一样。
连接到一个本地 Sametime 应用软件上
Jazz™ 协作工具为使用 IBM® Lotus® Sametime® Connect 7.5.1, 8.0.x 应用软件同时合作提供了支持。你可以使几个参与者进行对等交谈以及多用户交谈。你的本地电脑上必须安装有 IBM Lotus Sametime Connect 7.5.1 或者 8.0.x 应用程序。
注意:如果你已经在你的 Sametime 客户端中安装了先前的 Jazz 集成插件,那么你必须重新安装这个 Sametime 客户端。
连接到你即时消息工具上:
-
安装 Sametime:
-
在 Sametime 安装地址中的 plugin_customization.ini 文件中,设置下面的特征:
com.ibm.collaboration.realtime.brokerbridge/startBroker=true
如果这个特征不存在,就将它添加到这个文件中。
-
启动你的 Sametime 应用软件。
-
点击 工具 > 插件程序 > 安装插件程序。
-
选择 ‘查找新的特征’来安装并点击 Next。
-
点击 New Local Site,选择 TEAM_CONCERT/sametime 文件夹,这里你文件系统上的 TEAM_CONCERT 就是你安装 Rational® Team Concert 的位置。
-
点击 OK.
-
在 Name 域 中,输入 Team Concert Update Site,点击 OK。
-
选择这个新的局部更新网站,点击 Finish。
-
在 Search Results 窗口中,选择你的 Sametime 版本所需的所有插件程序并点击 Next。
-
接受许可协议并点击 Finish。
-
重新启动 Sametime。
-
用你的 Jazz 信息库连接来配置 Sametime:
-
点击 文件 > 参数选择。
-
在 Preferences Window 中,展开 Jazz 并点击 Repository Connections。
-
在 Repository Connections 页面,点击 Add。
-
在 Add Repository Connection 对话框中的 URI 区域,指定你的 Jazz 信息库 URI。
-
点击 OK。
-
点击 Apply。
-
将 Rational Team Concert 连接到你的正在运行的 Sametime 应用软件上:
-
点击 窗口 > 参数选择。
-
在 Preferences Window 上,点击 Instant Messaging。
-
在 Instant Messaging 页面,点击 Add。
-
在 Add IM Account 对话框中的 Provider 区域,从列表中选择合适的 Sametime 服务供应版本。
注意:如果你选择了错误的服务供应版本,你就不能建立一个连接。
-
在 Sametime ID 区域,输入你的 Sametime 用户标识符。
注意:根据你的 Sametime 服务器环境,尤其是当你使用 LDAP 来验证 Sametime 用户是否有效时,Sametime ID 与你当时登录到Sametime 中的 ID 不同是有可能的。如果你在使用 Add IM Account 对话框中指定的 Sametime ID 时遇到了注册问题,请联系管理员。
-
非强制性的: 在本地文件系统中指定可执行的路径,选择 Automatically start application 复选框。
-
点击 OK。
-
在 Instant Messaging 页面上,选择这个账户并点击 Connect。这个账户以粗体绿色显示来反应你的在线状态。
你可以开始与小组成员聊天。
连接到一个 Jabber 服务器
Rational® Team Concert 可以与几个支持 XMPP 协议的服务器相连接。Jazz™ 按照 XMPP 协议拥有嵌入式聊天支持。它支持几个参与者进行对等聊天,网络多方聊天,持续的小组讨论也可以在这个聊天室进行
你或者某个管理员已经安装和配置了 Jabber 服务器。
连接到一个正在运行的 Jabber XMPP 服务器:
-
点击 窗口 > 参数选择。
-
在 Preferences Window 中,点击 Instant Messaging。
-
在 Instant Messaging 页面,点击 Add。
-
在 Add IM Account 对话框中的 Provider 区域,从列表中选择 Jabber XMPP Server。
-
根据这个服务器的配置,你可以编辑一些或者所有以下区域:
-
在 Server域,输入一个本地测试服务器的服务器 URI 或者本地主机。
-
在 User ID域中,输入一个 Jabber 用户标识符或者使用一个由 Jabber 服务器管理员提供的现有 ID。
-
在 Password 域中,输入一个新密码或者使用由 Jabber 服务器管理员提供的现有密码。
-
在 Resource 域中,表明你的状态或者地理位置,输入一个非强制性的 XMPP 资源,比如 Home, Office, 或者 Travelling。
注意:如果你安装了一个新的 Jabber 服务器,你就可以自动创建一个新 Jabber 用户 ID 和初始密码。要想连接到一个现有的 Jabber 服务器上,你就需要联系你的管理员,获取一个 Jabber 用户 ID 和密码。
-
点击 OK。
-
要连接到一个 Jabber 服务器,可以在 Instant Messaging 页面点击 Connect。这个 IM 账户就会以粗体绿色显示,反映你的在线状态。
你可以开始与小组成员进行聊天。
检修服务器的相关故障
你可以使用管理 Web 界面来检修服务的问题。
你必须登录到 Admin Web UI,而且必须是 JazzAdmins 小组的成员之一。
要检修服务器的问题,可以在 Admin Web UI 中点击 Server 键符。在这个页面,你可以找到服务器状态信息,可以帮助你解决问题。
提示:来到 Jazz.net Tech Notes 或者 Server troubleshooting FAQ ,从而查找另外的故障处理提示。
下面这个表格列出了常见的一些问题和解决方案。
|
问题
|
需要检查的部分
| |
数据库无法使用
|
检查服务器状态:点击 Status 概要。
-
在 Status Summary 页面中的 Server Status 面板上,验证数据库的状态是连接的。如果这个状态无法使用,就要检查 Database Status 面板获取详细情况。失败的可能情况包括数据库配置无效,以及数据库的有效配置不能被初始化。
注意:Derby 数据库仅仅支持一个连接;如果另一个服务器实例正在运行,那么它可能仅仅使用一个数据库连接。如果这个问题发生了,那么 Service Error Summary 面板会列出多个错误。
-
在 Server VM 面板中,验证这个服务器运行的是正确的 JDK。
-
在 Service Error Summary 面板中,检查错误的信息。
| |
无法更改配置属性
|
检查服务器配置属性:在 Configuration 下,点击下面的条目之一:
-
E-mail Settings
-
Database Connections
-
Feed Settings
-
License Key Management
-
Advanced Properties
在这些页面中,你可以查看和更新配置属性。当你将变更保存到配置属性中时,它们会传播到 teamserver.properties 文件中。如果这个数据库没有连接,你可以仅仅通过编辑 teamserver.properties 文件来更改配置属性。
| |
故障服务
|
检查服务的状态:点击 Component Status。
在 Component Status 页面上,检查堆栈跟踪,从而获取更多关于故障服务的信息。
| |
降低服务器的活动性
|
检查运行的服务:点击 Active Services。
在 Active Services 页面,检查运行的服务和它们的堆栈跟踪。检查在延长时间内运行的服务。
检查这个服务器的活动性:点击 Statistics。
在 Server Statistics 页面,检查这个服务器的活动性,比如 Web 服务的统计资料,异步任务,以及缓冲行为。
|
补充资源和提示
要获取更多的信息,你可以访问日志源:
如果这个日志源无法使用,请从一个 Windows 窗口中或者在 installdir/tomcat/logs/catalina.out 查看这个 Tomcat 日志源,这里的installdir 就是你安装这个服务器的位置。
如果这个 teamserver.properties 文件在启动过程中没有找到,这个服务器就不能正常工作,并且这个 Tomcat 日志和日志源中也会包含错误。这个 server.startup 脚本提供了到特性文件的路径。
确保默认的 Tomcat 连接端口 9080 和 9443 没有被使用。这个连接端口是在 installdir/tomcat/conf/server.xml 文件中确定的,这里的 installdir 就是你安装服务器的位置。
如果这些问题还不能解决,就要考虑重新安装数据库或者 Web 档案文件 (WAR) 。你可以从最初的分配文件中 (repositoryDB.zip) 或者一个备份文件中重新安装数据库。
参考资料 学习
获得产品和技术
讨论
关于作者  | |  | Jazz 是一个 IBM Rational 的开放商业软件开发项目,由 Jazz.net 社区维护。 |
对本文的评价
|