IBM®
跳转到主要内容
    中国 [选择]    使用条款
 
 
Select a scope: Search for:    
    首页    产品    服务与解决方案     支持与下载    个性化服务    
跳转到主要内容

developerWorks 中国  >  Rational  >

Rational Team Concert 客户端安装概述

developerWorks
文档选项

未显示需要 JavaScript 的文档选项

英文原文

英文原文


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 安装提示你想要扩展的工作台,并负责管理以后工作台的更新,回滚,以及更改

  1. 下载下面这些安装包中其中任意一个。

这里有三种安装 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 启动程序以及所以可安装资源的拷贝。使用本地安装包的好处是,可以在没有互联网连接的情况下进行安装。这个压缩文件是可以非自我解压的文件。
  1. 开始这个启动程序。

如果这个 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

  1. 点击 Rational Team Concert 客户端连接,从而开始客户端的安装。
  2. 启动客户端。通过点击安装所创建的 Rational Team Concert 快捷方式来启动客户端。
  3. 连接到服务器。连接到服务器最简单的方法是采用 Team Invitation。如果你还没有被邀请,你就要手工进行连接。
    1. 在 Welcome Screen 上点击 Accept an invitation to join a Jazz™ team area。这个向导会引导你完成这个过程。

注意:如果你还没有收到邀请,你就需要你的服务器管理提供的URI。(这个网站中有一个案例模式:https://example.com:9443/jazz)。 点击并连接到一个现有项目区域超级连接,这个超级连接显示在 Accept Team Invitation 窗口的右下角。

    1. 按照这个向导中的操作指南来创建你的连接。

故障诊断: 这里有一些被提出的管理技术方面的问题。

  • 以一个空白工作区开始。
  • 客户端和服务器端的工作版本必须相匹配。确保这个工作版本 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"所示。

使用一个压缩文件安装客户端

这个客户端像一个可下载压缩文件一样被分配。

  1. 下载这个客户端包文件。

你应该下载 Rational® Team Concert 客户端压缩文件。

注意:如果你想要将这个客户端安装到一个现有的 Eclipse 工作台中,就要使用 IBM Installation Manager。这个 IBM Installation Manager 安装会向你提示你想要扩展的工作台,以及负责管理以后工作台的更新,回滚,以及更改

  1. 安装这个客户端分配。将这个压缩文件解压到你选择的一个安装地址中(例如, /opt/IBM/ on Linux® or c:\IBM on Windows®,)。相对于你选择的安装地址,客户端路径是JazzInstallDir/client。
  2. 启动这个客户端。 双击 JazzInstallDir/client/eclipse 地址中的 TeamConcert.exe 应用程序。
  3. 连接到服务器。连接到服务器最简单的方法是使用 Team Invitation。如果你还没有收到邀请,就要手工进行连接。
    1. 在 Welcome Screen 中点击 Accept an invitation to join a Jazz™ team area。 这个向导会引导你完成这个过程。

注意:如果你还没有接收到邀请,就需要你的服务器所提供的 URI。(https://example.com:9443/jazz 中有一个案例模式)。点击并连接到一个现有项目区域超级连接,这个超级连接显示在 Accept Team Invitation 窗口的右下角。

    1. 按照这个向导中的操作指南来创建你的连接。

故障诊断: 这里有一些提出的关于管理技术的问题。

  • 从一个空白工作区开始。
  • 客户端和服务器端的工作版本必须相匹配。确保这个工作版本 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 客户端。

连接到你即时消息工具上:

  1. 安装 Sametime:
    1. 在 Sametime 安装地址中的 plugin_customization.ini 文件中,设置下面的特征:

com.ibm.collaboration.realtime.brokerbridge/startBroker=true

如果这个特征不存在,就将它添加到这个文件中。

    1. 启动你的 Sametime 应用软件。
    2. 点击 工具 > 插件程序 > 安装插件程序。
    3. 选择 ‘查找新的特征’来安装并点击 Next。
    4. 点击 New Local Site,选择 TEAM_CONCERT/sametime 文件夹,这里你文件系统上的 TEAM_CONCERT 就是你安装 Rational® Team Concert 的位置。
    5. 点击 OK.
    6. 在 Name 域 中,输入 Team Concert Update Site,点击 OK。
    7. 选择这个新的局部更新网站,点击 Finish。
    8. 在 Search Results 窗口中,选择你的 Sametime 版本所需的所有插件程序并点击 Next。
    9. 接受许可协议并点击 Finish
    10. 重新启动 Sametime。
  1. 用你的 Jazz 信息库连接来配置 Sametime:
    1. 点击 文件 > 参数选择。
    2. 在 Preferences Window 中,展开 Jazz 并点击 Repository Connections。
    3. 在 Repository Connections 页面,点击 Add。
    4. 在 Add Repository Connection 对话框中的 URI 区域,指定你的 Jazz 信息库 URI。
    5. 点击 OK。
    6. 点击 Apply。
  2. 将 Rational Team Concert 连接到你的正在运行的 Sametime 应用软件上:
    1. 点击 窗口 > 参数选择。
    2. 在 Preferences Window 上,点击 Instant Messaging。
    3. 在 Instant Messaging 页面,点击 Add。
    4. 在 Add IM Account 对话框中的 Provider 区域,从列表中选择合适的 Sametime 服务供应版本。

注意:如果你选择了错误的服务供应版本,你就不能建立一个连接。

    1. 在 Sametime ID 区域,输入你的 Sametime 用户标识符。

注意:根据你的 Sametime 服务器环境,尤其是当你使用 LDAP 来验证 Sametime 用户是否有效时,Sametime ID 与你当时登录到Sametime 中的 ID 不同是有可能的。如果你在使用 Add IM Account 对话框中指定的 Sametime ID 时遇到了注册问题,请联系管理员。

    1. 非强制性的: 在本地文件系统中指定可执行的路径,选择 Automatically start application 复选框。
    2. 点击 OK。
    3. 在 Instant Messaging 页面上,选择这个账户并点击 Connect。这个账户以粗体绿色显示来反应你的在线状态。

你可以开始与小组成员聊天。

连接到一个 Jabber 服务器

Rational® Team Concert 可以与几个支持 XMPP 协议的服务器相连接。Jazz™ 按照 XMPP 协议拥有嵌入式聊天支持。它支持几个参与者进行对等聊天,网络多方聊天,持续的小组讨论也可以在这个聊天室进行

你或者某个管理员已经安装和配置了 Jabber 服务器。

连接到一个正在运行的 Jabber XMPP 服务器:

  1. 点击 窗口 > 参数选择。
  2. 在 Preferences Window 中,点击 Instant Messaging。
  3. 在 Instant Messaging 页面,点击 Add。
  4. 在 Add IM Account 对话框中的 Provider 区域,从列表中选择 Jabber XMPP Server。
  5. 根据这个服务器的配置,你可以编辑一些或者所有以下区域:
    • 在 Server域,输入一个本地测试服务器的服务器 URI 或者本地主机。
    • 在 User ID域中,输入一个 Jabber 用户标识符或者使用一个由 Jabber 服务器管理员提供的现有 ID。
    • 在 Password 域中,输入一个新密码或者使用由 Jabber 服务器管理员提供的现有密码。
    • 在 Resource 域中,表明你的状态或者地理位置,输入一个非强制性的 XMPP 资源,比如 Home, Office, 或者 Travelling。

注意:如果你安装了一个新的 Jabber 服务器,你就可以自动创建一个新 Jabber 用户 ID 和初始密码。要想连接到一个现有的 Jabber 服务器上,你就需要联系你的管理员,获取一个 Jabber 用户 ID 和密码。

  1. 点击 OK。
  2. 要连接到一个 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.net 上的 Jazz 社区。并注册成为 Jazz.net 用户,您可以随时了解 Jazz 项目开发的最新进展,获取免费的 Jazz 平台软件及相关试用版软件下载。

  • 访问 Jazz Space。在 developerWorks 这个专门为 Jazz 平台准备的 Space 里,您将发现更多关于 Jazz 的技术资源和信息,包括博客、产品演示、RSDC 讲座、Podcast、Webcast,以及 基于 Jazz 的商用产品试用版下载等资源。

  • 参加 Rational 大学,与 IBM Rational 专家一起分享 Rational 产品最佳实践。

  • 查看 developerWorks 博客 并加入 developerWorks 社区


关于作者

Jazz 是一个 IBM Rational 的开放商业软件开发项目,由 Jazz.net 社区维护。




对本文的评价










回页首


IBM 公司保留在 developerWorks 网站上发表的内容的著作权。未经IBM公司或原始作者的书面明确许可,请勿转载。如果您希望转载,请通过 提交转载请求表单 联系我们的编辑团队。
    关于 IBM 隐私条约 联系 IBM 使用条款