升级到 Rational Team Concert 2.0.0.2

通常,您可以通过执行 zip 文件安装或 IBM® Installation Manager 安装来升级 Rational Team Concert™ 客户机和服务器。
注: 如果使用 IBM Installation Manager 在计算机上安装 Rational Team Concert 2.0.0.2,而此计算机上当前未安装 Rational Team Concert,那么 Installation Manager 将提示您选择要安装的语言。但是,如果您是从更低版本更新至 2.0.0.2,那么 IBM Installation Manager 会假定您将使用当前语言,因此不会提示您选择语言。要选择其他语言,在更新至 2.0.0.2 之后,请从 IBM Installation Manager 的主屏幕中选择修改,然后选择产品。下一屏幕显示了支持的语言。请选择需要的语言。
在更新至 2.0.0.2 之后,如果在未选择修改以添加或除去语言的情况下启动 Jazz™ Team Server,那么必须复位服务器,如下所示:
  1. 在 Web 浏览器中,浏览到
    https://<服务器主机>:<Jazz-端口>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
  2. 单击请求复位服务器
  3. 关闭服务器。

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

Rational Team Concert 客户机与服务器的兼容性

下表列示 Rational Team Concert 客户机版本与 Jazz Team Server 版本的兼容性。
表 1. 客户机与服务器兼容性
Rational Team Concert 客户机版本 兼容的 Jazz Team Server 版本
1.0.x for Eclipse 0.6.x
2.0.x for Eclipse 1.0.x
2.0.0.0 for Microsoft Visual Studio 1.0.0.0
2.0.x for Microsoft Visual Studio 1.0.x

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

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

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

如果您已有用于 Microsoft® Visual Studio IDE 的 V1.0.1.1 客户机,那么需要获取 2.0.x 客户机才能连接至新的 V2.0.x 服务器。
切记: 未提供可安装用于 Microsoft Visual Studio 的客户机的 .zip 文件。要安装 V2.0.x 或升级至 V2.0.x,必须使用 IBM Installation Manager。

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

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

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

从 1.0, 1.0.1、1.0.1.1 或 2.0 升级服务器

可以从前发行版直接升级至 Rational Team Concert 的 2.0.0.2 发行版。对于 1.x 至 2.x 的更新,需要进行数据库迁移。有关执行数据库迁移的信息,请在升级 Jazz Team Server 后参阅 迁移 Jazz 存储库。。

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

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

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

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

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

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

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

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

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

如果先前版本是使用 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.0.2 中正确地配置 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 更新到 2.0.0.2,那么已在安装位置的服务器子目录中创建名称类似于 backup-config-时间戳记 的备份目录,此目录包含 1.0.x 或 2.0 配置文件。

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

安装 2.0.0.2 激活密钥

2.0.0.2 发行版使用 2.0.0.2 激活密钥。如果将服务器从 1.0.x.x 升级至 2.0.x,那么完成升级后,将恢复试用许可证,您必须从 IBM Rational 许可证密钥中心获取 2.0 或 2.0.0.2 激活密钥。

有关 IBM Rational 许可证密钥中心的更多信息,请参阅 IBM Rational 许可证发放支持站点以及相关的 jazz.net 技术提示

以下是每个套件的适用密钥的名称:

  • IBM Rational Team Concert Express Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Standard Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Enterprise Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBMRational Team Concert Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Express Edition Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Developer Client Access Activation Kit V2.0, 2.0.0.2

设置项目时间线

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 中使用这些报告时,您可能会遇到一个或多个问题。您应该了解以下问题:
  • 对 Java 和 JavaScript 类的解析顺序所作的变更。如果已在使用 importPackage() 语句来导入 java.lang 包的 BIRT 报告中编写 JavaScript 代码,那么要注意,代码中对 Object 的未限定引用(以前用来引用 Java 类)现在可能会引用 JavaScript 类(因此无法正确工作)。其他在 JavaScript 与 Java 之间名称完全相同的类(例如 java.util.Date)可能会遇到相同的问题。解决方案是,对 Java 类引用进行完全限定并除去 importPackage() 语句。
  • 对数据集处理所作的变更。过去,将元素(例如“标签”)与数据集绑定这一简单操作将致使显示该元素时完整地处理该数据集。这十分方便,其原因在于,用户可以通过按数据集的处理顺序使用与数据集绑定的隐式标签对数据集处理进行排序。现在,这样的绑定将只处理数据集的第一行。要恢复先前的行为,请使用“动态文本”元素并调用一些用于强制处理整个数据集的 JavaScript 代码。Total.count() 是一个不错的选项。
  • BIRT 报告设计器的错误可能会导致丢失数据。当您在 BIRT 2.3.2(即,RTC 2.0)报告设计器中打开通过 BIRT 2.2.2(即,RTC 1.0)创建的 BIRT 报告设计文件时,将发生这些问题。已发现下列问题:
    • 使用 BIRT 2.3.2 第一次编辑数据集时,在“参数”页面上,可能会丢失“缺省值”和“报告参数”字段。变通方法是,重新输入这些值,或者从先前版本的编辑器复制并粘贴这些值。在保存输入了新值的文件之后,此问题将不再出现。
    • 使用 BIRT 2.3.2 第一次编辑报告设计文件时,可能会丢失报告参数的缺省值。在发生以上描述的问题之后,也可能会发生此问题。 变通方法是,重新输入这些值,或者从先前版本的编辑器复制并粘贴这些值。在保存输入了新值的文件之后,此问题将不再出现。

    如果不对这些问题加以注意,它们可能会变得非常严重,这是因为,报告所收集的数据可能不正确。使用 BIRT 2.3.2 报告设计器第一次编辑报告时,最好检查每个数据集以及每个报告参数。对于使用 BIRT 2.3.2 工具创建的新报告而言,不会发生这些问题。

    上述变更是对所有 Rational Team Concert 2.0 现成报告进行的 - 您无需执行任何操作。但是,如果您已使用我们的现成报告以手动方式在项目区域中创建报告模板,并且未指定适当的标识(与我们的用法一致),那么迁移报告模板时不会对其进行刷新。即,内容由于已过期而无效。在这种情况下,您应该使用相应的现成 .rptdesign 文件来上载受影响模板的新内容。

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

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

发现新报告

Rational Team Concert 2.0 中,添加了多个新报告。虽然这些报告将在随产品一起交付的新过程模板中出现,但在迁移期间,它们不会被自动添加到现有的项目区域。我们添加了一项新操作,此操作将帮助您在完成迁移后发现这些新报告模板并将其部署到现有的项目区域。要部署新的报告模板,请执行下列操作:
  1. 在胖客户机中,打开团队工件视图。
  2. 展开项目区域,然后展开报告
  3. 右键单击报告模板并选择部署新模板

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

定制

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


反馈

这些对您是否有帮助?您可以在 Jazz.net 中提供反馈(需要注册):在论坛中发表意见提交 bug