使用 IBM Installation Manager 来安装 Rational Team Concert 客户机


此版本构建于 10 六月 2009。

您可以通过在线方式在以下网址找到此安装过程的最新版本和一些有帮助的计划信息:http://publib.boulder.ibm.com/infocenter/rtc/V2r0m0/index.jsp

目录

使用 IBM Installation Manager 来安装客户机
升级至 Rational Team Concert 2.0
将 Rational Team Concert 与安全性增强型 Linux 并列安装

使用 IBM Installation Manager 来安装客户机

客户机是由 IBM® Installation Manager 作为一个可下载文件来分发的。

关于此任务

注:
如果要将客户机安装到现有的 Eclipse 工作台中,请使用 IBM Installation Manager。IBM Installation Manager 安装提示您要扩展的工作台并且要认真管理工作台将来的更新、回滚和修改。
注:
如果启用了安全性增强的 Linux®(SELinux),那么您必须禁用它或者变更 Java 运行时环境(JRE)的安全上下文,以允许对文本重新定位,以便安装和运行 Rational Team Concert。有关更多信息,请参阅将 Rational Team Concert 与安全性增强型 Linux 并列安装

  1. 下载下列其中一个安装包。

    可以使用三种方法来安装 Rational® Team Concert 客户机。

  2. 启动启动板程序。

    如果 Installation Manager 未运行,请完成下列步骤以将它启动。

    注:
    您必须具有管理员特权才能运行启动板程序。
    注:
    用于启动启动版程序的 Linux 命令仅限于用于 Eclipse IDE 的 Rational Team Concert。
    要启动启动板程序文件:
  3. 您可以安装以下客户机: 显示 Installation Manager 向导。 此向导指导您安装客户机。
  4. 通过单击安装过程所创建的 Rational Team Concert 快捷方式来启动客户机。
  5. 连接至服务器。 连接至服务器最简单的方法是使用"团队邀请"。如果您未获得邀请,那么可以手动建立连接。
    1. 单击文件 -> 接受团队邀请。此向导将指导您完成过程。
      注:
      如果您未获得邀请,那么需要请求服务器管理员提供 URI 或 URL。(其示例格式为:https://example.com:9443/jazz)。单击接受团队邀请窗口右下角出现的连接至现有项目区域超链接。
    2. 遵循向导中提供的指示信息来建立连接。

示例

故障诊断:下面是建议您采用的一些问题管理技术。

下一步做什么

在成功安装了客户机之后,应当参阅下列主题以帮助您开始了解 Rational Team Concert。

升级至 Rational Team Concert 2.0

通常,您可以通过执行 zip 文件安装或 IBM Installation Manager 安装来升级 Rational Team Concert 客户机和服务器。

注:
如果使用 IBM Installation Manager 在计算机上安装 Rational Team Concert 2.0,而此计算机上当前未安装 Rational Team Concert,那么 Installation Manager 将提示您选择要安装的语言。但是,如果您是从更低版本更新至 2.0,那么 IBM Installation Manager 会假定您将使用当前语言,因此不会提示您选择语言。要选择其他语言,在更新至 2.0 之后,请从 IBM Installation Manager 的主屏幕中选择修改,然后选择产品。下一屏幕显示了支持的语言。请选择需要的语言。

在更新至 2.0 之后,如果在未选择修改以添加或除去语言的情况下启动 Jazz™ Team Server,那么必须复位服务器,如下所示:

  1. 在 Web 浏览器中,访问 https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset。
  2. 单击请求复位服务器
  3. 关闭服务器。

然后,您可以从 IBM Installation Manager 中选择修改以添加或除去语言。

升级用于 Eclipse IDE 的 Rational Team Concert 客户机

如果您有用于 Eclipse IDE 的 1.0、1.0.1 或 1.0.1.1 客户机,那么您需要获取 2.0 客户机才能连接至新的 V2.0 服务器。您可以使用 zip 文件来安装此客户机,也可以对先前通过 IBM Installation Manager 安装的客户机进行更新。

安装用于 Microsoft Visual Studio IDE 的 Rational Team Concert 客户机

如果您已有用于 Microsoft Visual Studio IDE 的 V1.0.1.1 客户机,那么需要获取 2.0 客户机才能连接至新的 V2.0 服务器。

切记:
未提供可安装用于 Microsoft Visual Studio 的客户机的 .zip 文件。要安装 V2.0 或升级至 V2.0,必须使用 IBM Installation Manager。

将服务器从试用发行版或早期访问发行版升级到永久发行版

如果正在运行 Rational Team Concert 的早期访问发行版,请先升级至 2.0 试用版。

从 2.0 试用版开始,您可以通过购买并安装适用于所使用版本的服务器激活套件使服务器成为永久服务器(http://www.ibm.com/software/awdtools/rtc/)。激活套件由一个包含永久服务器密钥的 JAR 文件组成。您可以使用服务器的管理 Web 界面的"管理许可证密钥"页面来安装此套件。

从 1.0, 1.0.1 或 1.0.1.1 升级服务器

可以从前发行版直接升级至 Rational Team Concert 的 2.0 发行版。对于 1.x 至 2.x 的更新,需要进行数据库迁移。

注:
在开始升级 WebSphere® Application Server 之前,请通过访问 https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset 并单击请求复位服务器来复位服务器。

如果前发行版是使用 zip 文件安装的,那么与先前安装没有交集。您可以使用 zip 文件将 2.0 发行版安装在新位置,也可以使用 IBM Installation Manager 来安装 2.0 的实例。

如果前发行版是使用 IBM Installation Manager 安装的,那么可以将 2.0 作为独立实例进行安装或者将先前实例更新至 2.0。如果安装 2.0 发行版的服务器的独立实例,请在安装向导的安装软件包页面上选择创建新的软件包组

注:
对于为 Jazz Team Server 部署的 WebSphere Application Server,如果要将其升级,请除去先前的 jazz.war 文件并部署 2.0 jazz.war 文件。

要完成升级,请参阅从先前安装的服务器复制所需的配置文件安装 2.0 激活密钥

将服务器从一个 Rational Team Concert 版本升级至另一个版本

可以在 Rational Team Concert 版本之间进行升级。典型升级包括从 Express-C Edition 升级到 Express Edition 或者从 Express Edition 升级到 Standard Edition。通过执行同一过程,还可以按反方向进行降级。

由于所有 Rational Team Concert 2.0 版都支持 Derby 数据库,因此,如果您正在从 Express-C Edition 升级到 Express Edition 或 Standard Edition,那么不需要从 Derby 迁移到 DB2® 或 Oracle。我们建议您先迁移服务器版本,确保系统使用现有数据库平稳运行,然后在需要时执行数据库迁移工作。有关执行数据库迁移的信息,请参阅在升级 Jazz Team Server 之后迁移 Jazz 存储库

如果您已安装 Rational Team Concert 2.0 版并且要升级到另一版本,请下载新版本并将其与现有版本并列安装,然后复制所需的配置文件以运行新版本。下一节描述您所需的配置文件。

如果先前版本是使用 zip 文件安装的,那么与先前安装没有交集。您可以使用 zip 文件将新版本安装到新位置,也可以使用 IBM Installation Manager 来安装新版本。我们建议您使用 IBM Installation Manager 来安装生产服务器,以便将来能够应用更新。

如果您先前使用 IBM Installation Manager 来安装服务器,并且要使用 IBM Installation Manager 来安装新版本,那么在使用 Installation Manager 执行新安装期间,请不要覆盖先前版本。在安装向导的安装软件包页面上,请选择创建新的软件包组

这将在另一位置安装新版本,并且将使用新的软件包组名来创建程序快捷方式。

如果您未执行此任务,那么安装过程将由于文件冲突而失败。在这种情况下,您将看到标题为安装失败的错误对话框,并且详细信息将显示以下文本:

安装失败。
  "安装"阶段发生错误:
    未能将 zip 标准 1.0.1.I20081018-1820 解压缩。文件
    D:\JazzTeamServer\server\license-update-site\site.xml 已存在。

这不是致命错误;您可以重新启动安装并正确地创建新的软件包组。

WebSphere Application Server 配置更新

要在 Rational Team Concert 2.0 中正确地配置 WebSphere Application Server,必须执行下列步骤。

  1. 确保已安装 WAS 和 WASDK 的最新修订包。如果正在 WAS 7.0 中执行部署,那么至少安装 WebSphere Application Server 7.0.0.3 至关重要。
  2. 除去旧的定制 JVM 属性:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. 添加新的定制 JVM 属性 JAZZ_HOME 并将值设置为:
    file:///<JazzInstallDir>/server/conf
  4. 确保已选中 WAS 安全设置"访问未受保护的 URI 时使用可用的认证数据"。如果您正在使用 WAS 集成解决方案控制台,那么可以通过以下过程来完成此任务:
    1. 转到"安全性"->"安全管理、应用程序和基础结构"->"Web 安全性 - 常规设置"。
    2. 选中"访问未受保护的 URI 时使用可用的认证数据"复选框。

从先前安装的服务器复制所需的配置文件

请将下列文件从源服务器复制到目标服务器。首先,将所升级服务器中的原始文件重命名,以便创建备份。如果您先前曾使用 IBM Installation Manager 从 1.0, 1.0.1 或 1.0.1.1 更新到 2.0,那么已在安装位置的服务器子目录中创建名称类似于 backup-config-timestamp 的备份目录,此目录包含 1.0.x 配置文件。

如果您正在升级至 Standard Edition 或 Enterprise Edition,并且已购买 Developer Client Activation Kit for Express,那么请购买并安装 Developer Client Activation Kit for Standard Edition 或 Enterprise Edition,以便可以使用那些客户机许可证。分配给您的开发者许可证仍有效,但开发者许可证在正确的激活套件安装完毕后将被取消激活。

安装 2.0 激活密钥

2.0 发行版使用 2.0 激活密钥。如果将服务器从 1.0.x.x 升级至 2.0,那么完成升级后,将恢复试用许可证,您必须从 Passport Advantage® 获取 2.0 激活密钥。以下是每个套件的适用密钥的名称:

设置项目时间线

在 Rational Team Concert 1.x 中,项目可以包含多条时间线(以前称为"开发线"),并且所有这些时间线都被视为等同。

在 Rational Team Concert 2.0 中,项目仍可以包含多条时间线,但可以将其中一条时间线标记为"项目时间线"。将数据库迁移至 2.0 之后,项目的主时间线未知,因此不会对项目设置项目时间线。升级至 2.0 之后,您可以手动更新项目以设置项目时间线。

配置源代码控制快照

数据仓库的源代码控制管理(SCM)快照用于收集流的数据,其中包括关于流大小以及流中的活动(变更集和文件/文件夹变更)的信息。在 V1.0 中,此快照将自动收集关于所有流的信息。由于此操作的成本很高,所以在 V2.0 中,对 SCM 快照添加了可配置性选项,以便允许用户决定应该对哪些流收集数据。此变更的直接效果是,除非您进行配置,否则不会收集任何数据。

要配置 SCM 快照,请执行下列操作:

  1. 要收集流的数据,您必须对其具有写许可权。
  2. 转到 Web UI 中的报告页面。
  3. 在左导航面板中,选择管理 SCM 快照。此时将显示流的列表。
  4. 选中一个或多个流的复选框,然后选择保存变更

在所有后续快照中,将对选择的流收集数据。

对 BIRT 报告所作的不兼容变更

如果您已使用 BIRT 报告设计器来创建自己的报告模板,那么尝试在 V2.0 中使用这些报告时,您可能会遇到一个或多个问题。您应该了解以下问题:

导入数据仓库中的工作项数据

在 Rational Team Concert 2.0 中,对数据仓库中的工作项表进行了多项模式变更。所以,从 1.0 迁移至 2.0 时,导入器将忽略任何仓库工作项数据。因此,第一次启动 2.0 服务器时,工作项报告可能无法正常工作。变通方法是,等待工作项快照第一次运行,或者在启动服务器后以手动方式运行该快照。在完成迁移后的第一次运行时,工作项快照将重新构造数据仓库中的全部历史工作项信息。这还意味着,在完成迁移后第一次运行快照时,耗时有可能远远超出一般的夜间运行。

发现新报告

在 Rational Team Concert 2.0 中,添加了多个新报告。虽然这些报告将在随产品一起交付的新过程模板中出现,但在迁移期间,它们不会被自动添加到现有的项目区域。我们添加了一项新操作,此操作将帮助您在完成迁移后发现这些新报告模板并将其部署到现有的项目区域。要部署新的报告模板,请执行下列操作:

  1. 在胖客户机中,打开团队工件视图。
  2. 展开项目区域,然后展开报告
  3. 右键单击报告模板并选择部署新模板

此对话框将帮助您发现可用但尚未部署到项目区域的任何报告模板。您可以选择其中的一个或多个报告模板,将创建这些报告模板。在创建之后,您可以通过可用的菜单操作根据那些模板来创建新报告。

定制

从 1.x 升级到 2.0 时,您对工作项类型、属性、工作流程、角色和事件处理程序所作的变更都将保留下来。请注意,如果您已对预定义的过程模板(例如 Scrum)进行定制,那么在"过程模板"视图中重新部署预定义的模板时,将覆盖您所作的定制。如果需要重新部署预定义的模板,那么应该先变更已定制的预定义模板的名称和标识,以使其不会被覆盖。

将 Rational Team Concert 与安全性增强型 Linux 并列安装

如果已启用安全性增强型 Linux(SELinux),那么您必须禁用它或者变更用于安装和运行 Rational Team Concert 的 Java™ 运行时环境(JRE)的安全上下文,以允许对文本重新定位。

关于此任务

如果您已经设置了一台机器,且此机器仅用于评估 Rational Team Concert,而 SELinux 功能部件对您来说并不重要,那么可以继续完成后续步骤的最简单方法是禁用 SELinux。

注: