使用 IBM Installation Manager 安装 Rational Team Concert 客户机
使用 IBM Installation Manager 安装客户机
客户机是由 IBM® Installation Manager 作为一个可下载文件来分发的。
关于此任务
注:
如果您想将客户机安装到现有 Eclipse 工作台中,那么请使用
IBM Installation Manager。IBM Installation Manager 安装提示您要扩展的工作台并且要认真管理工作台将来的更新、回滚和修改。
注:
如果启用了安全性增强的 Linux®(SELinux),那么您
必须 禁用它或者更改 Java 运行时环境(JRE)的安全上下文,以允许对文本重新定位,以便安装和运行 Rational Team Concert。有关更多信息,请参阅
使用启用了安全性增强的 Linux 来安装 Rational Team Concert 。
下载下列其中一个安装包。
可以使用三种方法来安装 Rational® Team Concert 客户机。
启动启动板程序。
如果 Installation Manager 未运行,请完成下列步骤以将它启动。
注:
您必须具有管理员特权才能运行启动板程序。
注:
用于启动启动版程序的 Linux 命令仅限于用于 Eclipse IDE 的 Rational Team Concert。
要启动启动板程序文件:
如果您要使用客户机 CD 内容 .zip 文件 ,那么请将此归档的内容解压缩到一个临时目录并运行启动板程序。要启动启动板程序文件:
要在 Windows 上运行此文件,请运行以下命令:
launchpad.exe
要在 Linux 上运行此文件,请运行以下命令:
sh launchpad.sh
如果您要使用 Installation Manager Web 安装 ,那么请运行可执行文件。文件将被解压缩到一个目录中,并且将出现启动板程序。要启动可执行文件:
如果您要使用完整 DVD 内容 .zip 文件 ,那么请将此归档的内容解压缩到一个临时目录并运行启动板程序。要启动启动板程序文件:
要在 Windows 上运行此文件,请运行以下命令:
launchpad.exe
要在 Linux 上运行此文件,请运行以下命令:
sh launchpad.sh
您可以安装以下客户机:
要安装 Rational Team Concert client
for Eclipse,单击Rational Team Concert Client
for Eclipse IDE 链接。
要安装 Rational Team Concert client
for Microsoft Visual Studio,单击Rational Team Concert Client for Microsoft® Visual Studio IDE 链接。 显示 Installation Manager 向导。
此向导指导您安装客户机。
通过单击安装过程所创建的 Rational Team Concert 快捷方式来启动客户机。
连接至服务器。 连接至服务器最简单的方法是使用"团队邀请"。如果您未获得邀请,那么可以手动建立连接。
单击文件 -> 接受团队邀请 。此向导将指导您完成过程。
注:
如果您未获得邀请,那么需要请求服务器管理员提供 URI 或 URL。(其示例格式为:https://example.com:9443/jazz)。单击接受团队邀请 窗口右下角出现的连接至现有项目区域 超链接。
遵循向导中提供的指示信息来建立连接。
示例
故障诊断 :下面是建议您采用的一些问题管理技术。
从一个空的工作空间入手。
客户机和服务器构建必须相匹配。请确保客户机和服务器分发产品的构建标识相匹配。
确保服务器已启动。使用以下状态 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。
更新至 Rational Team Concert 1.0.1 或 1.0.1.1
您可以通过执行 zip 文件安装或 Installation Manager 安装来升级
Rational Team Concert 客户机和服务器。
注:
如果使用 Installation Manager 在电脑上安装 Rational Team Concert 1.0.1.1,而此电脑上未安装 Rational Team Concert,Installation Manager 会提示您选择要安装的语言。但是,如果您是从更早版本更新至 1.0.1.1,Installation Manager 会假设您将使用当前语言而不提示您选择语言。
1.0.1.1 版本之前仅限英文版。要选择其他语言,在您更新至 1.0.1.1 之后,从 Installation Manager 的主屏幕上选择修改 ,然后选择产品。下一屏幕显示了支持的语言。选择需要的语言。
升级 1.0 Rational Team Concert Eclipse 客户机
如果您有 1.0 客户机,我们建议您获取 1.0.1 或 1.0.1.1 客户机来连接至您的新 1.0.1 或 1.0.1.1 服务器。您可以使用 zip 文件来安装这些客户机,也可以对先前通过
Installation Manager 安装的客户机进行更新。
将服务器从试用发行版或早期访问发行版升级到永久发行版
如果您正在运行 Rational Team Concert 的早期访问发行版,那么请先升级到 1.0
试用发行版,也可以直接升级到所购买的 1.0.1 服务器产品。1.0 服务器密钥不会使早期访问服务器成为永久服务器。
从 1.0 试用发行版开始,您可以通过购买并安装适用于所使用版本的服务器激活套件使服务器成为永久服务器(http://www-306.ibm.com/software/awdtools/rtc/ )。激活套件由一个包含永久服务器密钥的
JAR 文件组成。您可以使用服务器的管理 Web 界面的"管理许可证密钥"页面来安装此套件。
从 1.0 升级服务器
您可以从 1.0 发行版直接升级至 Rational Team Concert 的 1.0.1 或 1.0.1.1 发行版。您可以复用 1.0 数据库,因此不需要迁移数据库。
注:
在升级 Websphere Application
Server 之前,请通过浏览到
https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset 并单击请求重新设置服务器 来重新设置该服务器。
如果您正在运行先前的里程碑版或 Beta 版,那么请按照 1.0 https://jazz.net/downloads/rational-team-concert/releases/
的升级指示信息执行操作。首先,执行任何必需的数据库迁移工作。
如果 1.0 发行版是使用 zip 文件安装的,那么与先前安装没有交集。您可以从 zip 文件将 1.0.1 或 1.0.1.1 发行版安装在新位置,或者您可以使用 Installation Manager 来安装 1.0.1 或 1.0.1.1 的实例。
如果您使用Installation Manager 来安装 1.0 发行版,您可以将 1.0.1 或 1.0.1.1 作为独立实例安装或者更新 1.0 实例至 1.0.1 或 1.0.1.1。如果您安装 1.0.1 或 1.0.1.1 发行版的服务器的独立实例,在安装向导的安装软件包页面选择创建新的软件包组 。
注:
要升级 WebSphere Application Server,请除去 1.0 jazz.war 文件并部署 1.0.1 jazz.war 文件。
要完成升级,请参阅从先前安装的服务器复制所需的配置文件 和安装 1.0.1 激活密钥 。
将服务器从一个 Rational Team Concert 版本升级到另一个版本
可以在 Rational Team Concert 版本之间进行升级。典型升级包括从 Express-C 版升级到
Express™ 版或者从易捷版升级到标准版。通过执行同一过程,还可以按反方向进行降级。
由于所有Rational Team Concert 1.0.1
和 1.0.1.1 版本都支持 Derby 数据库,因此,如果您正在从 Express-C 版升级到 Express 版或 Standard 版,那么不需要从 Derby 迁移到 DB2® 或 Oracle。我们建议您先迁移服务器版本,确保系统使用现有数据库平稳运行,然后在需要时执行数据库迁移工作。有关执行数据库迁移的信息,请参阅迁移 Jazz™ Team Server 。
如果您已安装Rational Team Concert 1.0.1 或 1.0.1.1 版并且想要升级到另一版本,那么请下载新版本并将其与现有版本并列安装,然后复制所需的配置文件以运行新版本。下一节描述您所需的配置文件。
如果先前版本是使用 zip 文件安装的,那么与先前安装没有交集。您可以使用
zip 文件将新版本安装到新位置,也可以使用 Installation Manager 来安装新版本。我们建议您使用
Installation Manager 来安装生产服务器,以便将来能够应用更新。
如果您先前使用 Installation Manager 来安装服务器,并且想要使用 Installation Manager
来安装新版本,那么在使用 Installation Manager 执行新安装期间,请不要覆盖先前版本。在安装向导的安装软件包页面上,请选择创建新的软件包组 。
这将在另一位置安装新版本,并且将使用新的软件包组名来创建程序快捷方式。
如果您未执行此任务,那么安装过程将由于文件冲突而失败。在这种情况下,您将看到标题为安装失败 的错误对话框,并且详细信息将显示以下文本:
安装失败。
"安装"阶段发生错误:
未能将 zip 标准 1.0.1.I20081018-1820 解压缩。文件
D:\JazzTeamServer\server\license-update-site\site.xml 已存在。
这不是致命错误;您可以重新启动安装并正确地创建新的软件包组。
从先前安装的服务器复制所需的配置文件
请将下列文件从源服务器复制到目标服务器。首先,将所升级服务器中的原始文件重命名,以便创建备份。如果您先前曾使用
Installation Manager 从 1.0 更新到 1.0.1,那么将在安装位置的服务器子目录中创建名称类似于
backup-config-timestamp
的备份目录,此目录包含 1.0 配置文件。
workitemindex(目录)
如果您正在使用 Derby,那么请复制 repositoryDB 目录树。
如果您正在使用 Tomcat 并且已更改配置,那么请以覆盖方式复制 tomcat/conf 目录。
如果您正在使用 Tomcat 用户数据库,那么请以覆盖方式复制 tomcat-users.xml。
如果您正在使用 Tomcat 并且已定制应用程序部署描述符,那么请复制
\JazzTeamServer\server\tomcat\webapps\jazz\WEB-INF
目录中 jazz.war 的经过修改的 web.xml 文件。
如果您正在升级到标准版,并且已购买
Developer Client Activation Kit for Express,那么请购买并安装
Developer Client Activation Kit for Standard Edition,以便可以使用那些客户机许可证。分配给您的开发者许可证仍有效,但开发者许可证在正确的激活套件安装完毕后将被取消激活。
安装 1.0.1 激活密钥
如果您已将永久服务器激活密钥和客户机激活许可证密钥安装到 1.0 服务器,那么请获取并安装这些密钥的 1.0.1 版本。服务器在升级到
1.0.1 后将恢复为使用试用许可证。请从 Passport Advantage®
获取 1.0.1 激活密钥。以下是适用于每个服务器版本的密钥的名称:
易捷版密钥:
IBM Rational Team Concert Express Edition - Server License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert Express Edition - Developer Client License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert - Contributor Client License Activation Kit V1.0.1 Multiplatform
标准版密钥:
IBM Rational Team Concert Standard Edition - Server License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert Standard Edition - Developer Client License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert - Contributor Client License Activation Kit V1.0.1 Multiplatform
使用启用了安全性增强的 Linux 来安装 Rational Team Concert
如果启用了安全性增强的 Linux(SELinux),那么您必须禁用它或者更改用于安装和运行 Rational Team Concert 的 Java™ 运行时环境(JRE)的安全上下文,以允许对文本重新定位。
关于此任务
如果您已经设置了一台机器,且此机器仅用于评估 Rational Team Concert,而 SELinux 功能部件对您来说并不重要,那么可以继续完成后续步骤的最简单方法是禁用 SELinux。
注:
缺省情况下,Red Hat Enterprise Linux 5 上安装并且启用了 SELinux。
SELinux 未安装在 Suse Linux Enterprise Server 10 或 Suse Linux Enterprise Desktop 10 上。
要禁用 SELinux,请执行下列其中一项操作:
从窗口系统中禁用:
选择系统 -> 管理 -> 安全性级别和防火墙 。
切换至 SELinux 选项卡。
将 SELinux 设置更改为 Disabled(禁用)。
单击确定 以保存新的设置。
从命令行禁用:
运行"setup"命令(这是 /usr/bin/setup)
选择防火墙配置 并按 Enter 键
使用 Tab 键和箭头键将 SELinux 更改为 Disabled(禁用)
选择确定 并按 Enter 键
要更改 JRE 的安全上下文:
如果您要直接从 DVD 介质中进行安装,那么请跳到步骤 2 。否则,应更改安装 JRE 的安全上下文。
在安装文件目录中,找到 jre. linux/jre_5.0.2.sr5_20070511/jre 目录。如果您已将安装文件解压缩到 /tmp/rtc 中,那么目录 jre 位于 /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre。
对此 jre 目录运行 chcon -R -t textrel_shlib_t 命令。此命令将递归式地处理文件并允许对文本进行重新定位。例如,如果您已将安装文件解压缩到 /tmp/rtc 中,那么请运行以下命令:
chcon -R -t textrel_shlib_t /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre
安装 Rational Team Concert 服务器、客户机和连接器,但是不要启动它们。
在启动 Rational Team Concert 之前,必须更改产品 JRE 的安全上下文。对于您安装的每个产品,使用特定于产品的适当 JRE 目录来运行同一命令(即,chcon -R -t textrel_shlib_t)。下面列示了缺省目录。
注:
如果您作为 root 用户安装了此产品,那么路径将为缺省值。如果您作为非 root 用户安装了此产品,那么请在安装用户的主目录中的 opt/IBM 结构中查找这些目录。
IBM Installation Manager:
/opt/IBM/InstallationManager/eclipse/jre_5.0.2.sr5_20070511/jre
Jazz Team Server:
/opt/IBM/JazzTeamServer/server/linux/ibm-java2-i386-50/jre
Rational Team Concert - 客户机:(在所有四个目录中运行 chcon)
/opt/IBM/TeamConcert/jdk/bin
/opt/IBM/TeamConcert/jdk/lib
/opt/IBM/TeamConcert/jdk/jre/bin
/opt/IBM/TeamConcert/jdk/jre/lib
Rational Team Concert - Build System Toolkit:
Rational Team Concert - ClearCase® 连接器:(在所有四个目录中运行 chcon)
/opt/IBM/ClearCaseConnector/jdk/bin
/opt/IBM/ClearCaseConnector/jdk/lib
/opt/IBM/ClearCaseConnector/jdk/jre/bin
/opt/IBM/ClearCaseConnector/jdk/jre/lib
Rational Team Concert - ClearQuest® 连接器:
/opt/IBM/ClearQuestConnector/gateway/linux/ibm-java2-i386-50/jre