执行升级后步骤

本部分详细解释升级完成后可能需要您执行的一些操作。

关于此任务

  1. 安装 Rational Change 5.3(如果适用)
  2. 阅读 Rational Synergy Distributed 升级后传输(如果适用)
  3. 用户可能需要更新工作区
  4. 当不再需要时,除去先前的安装
  5. 更新 ccm 符号链接(如果适用)
  6. 安装 Windows 客户机(如果适用)
  7. 使数据库可供使用
  8. 检查查询限制和加速属性
  9. 更新系统级别文件名过滤器
  10. 对升级后问题进行故障诊断

安装 Rational Change 5.3

如果您使用带有该数据库的 Rational Change,请安装 Rational Change 5.3。 较早的 Rational Change 发行版与 Rational Synergy 7.2 不兼容。 有关详细指示信息,请参阅安装文档。

开始之前

在安装 Rational Change 5.3 之前,您必须至少创建或升级一个数据库,因为 Rational Change 需要访问 Rational Synergy 数据库。

过程

如果您使用 Rational Change,且如2中所述保存了先前 ptcli 配置文件的已修改副本,请立即将其合并。 ptcli 文件为:/usr/local/ccm72/etc/ptcli.cfg

Rational Synergy Distributed 升级后传输

Rational Synergy 7.2支持与 R7.0, 7.1, or 7.1a 之间的 DCM 传输。 需要这些发行版的补丁才能实现 DCM 兼容性。

关于此任务

有关更多信息,请参阅针对 R7.2Rational Synergy 自述文件以及较早发行版的补丁的产品自述文件。

有关升级 DCM 数据库的完整信息,请参阅升级 Rational Synergy Distributed 集群

更新工作区

如果您在升级期间将数据库移至新路径(可能在新计算机上),请更新现有工作区以使它们引用新路径。此信息适用于基于副本和基于链接的工作区。

过程

  1. 所移动数据库的每个用户必须运行以下命令才能更新其工作项目:
    $ ccm wa -dbpath old_database_path -show project_spec...
    $ ccm wa -dbpath old_database_path -replace -show project_spec...
    1. 构建管理员还必须更新其 prep 项目。
  2. 通过将相应的 -scope 选项用于 ccm wa -dbpath 命令来更新共享或静态项目。

除去先前的安装

当您不再需要旧发行版时,请除去先前的安装。

关于此任务

注: 仅当您确定其他任何安装都没有共享该目录的一部分(可能是通过从其他计算机进行的 NFS 安装)时,才能删除旧发行版目录。例如,在异构安装中,常见做法是共享目录 $CCM_HOME/etc
注: 阅读升级注意事项以了解有关保存先前安装的更多原因。

过程

运行以下命令以除去先前的安装:
$ su -
root# rm -rf /usr/local/ccm71
root# exit

更新 ccm 符号链接

要更改缺省版本的 Rational Synergy,请删除指向前发行版的任何符号链接。然后,创建指向新发行版的链接。

过程

运行以下命令:
$ su -
root# rm /usr/local/ccm
root# ln -s /usr/local/ccm72 /usr/local/ccm
root# exit

安装 Windows 客户机

如果需要,请为 Rational Synergy R7.2 安装 Windows 客户机。 您无需卸载前发行版的客户机。但是,如果您不需要访问仍使用前发行版的任何数据库,那么可以卸载这些客户机。

关于此任务

有关详细指示信息,请参阅安装文档。

测试 Rational Synergy 客户机

测试 Rational Synergy 客户机是否正常运行。

过程

  1. 运行 ccm monitor 命令并检查相应的 CCM 服务器是否正在运行。如果没有,请使用 ccm_server 命令将其启动。请注意运行 ccm monitor 命令后在返回的信息中显示的服务器 URL。
  2. 在浏览器中,输入 protocol://server:port/admin,其中协议(http 或 https)、serverport 都在服务器 URL 中。
  3. 出现提示时,输入管理员密码。
  4. 数据库选项卡上,检查您要测试的数据库是否列为连接至此服务器。如果它显示为连接至不同的服务器,请使用这一不同的服务器,或使用 Web 页面更改数据库的服务器。
  5. 使用您已验证的服务器 URL 启动 Rational Synergy 会话:

    $cmsynergy -d database_path [-s server_url]

    注: 用于指定服务器 URL 的 -s 选项是可选的。在大多数情况下,并不需要该选项,并且服务器 URL 是通过 Rational Synergy 路由器自动确定的。

使数据库可供使用

完成升级、测试了结果并执行了任何必需的升级后操作之后,您的升级即完成。

过程

  1. 如果在升级、测试或升级后过程中保护了数据库,请立即对其取消保护。
  2. 通知用户这些数据库随时可供使用。
  3. 升级用户的客户机软件。

检查查询限制和加速属性

Rational Synergy 7.0 和 7.1 中,字符串和文本属性是使用 Windows CP1252(一种单字节编码)进行编码的,对字符串或文本属性的查询仅检查每个字符串的前 64 个字符(字节)。在 Rational Synergy 7.2 中,文本属性采用可变长度编码方式 UTF-8 进行编码。 查询限制已从 64 个字节升至 72 个字节,但在 UTF-8 中,CP1252 中由 64 个或更少的字符和字节表示的字符串可能需要 72 个以上的字节。用户必须复审自己的查询以查看是否出现此问题。

开始之前

Rational Synergy 7.1a 升级的用户可跳过该任务。

过程

  1. 检查查询以便查找未正确编码的字符串。
  2. 将属性加速以解决此问题。加速属性的查询限制为 700 个字节。

示例

Rational Synergy 7.0 和 7.1 中使用时,字符串“ééééééééééééééééééééééééééééééééééééé”(37 个 e-acute Latin-1 字符)在 CP1252 编码中占据 37 字节。在 Rational Synergy 7.2 中使用时,同样的字符串在 UTF-8 编码中占据 74 字节。 因此,对某属性等于该值的对象进行查询在 7.0 和 7.1 中将成功,但在 7.2 中将失败。

更新系统级别文件名过滤器

如果更新 Synergy 7.0 和 7.1 中的基本模型属性“system_filename_filters”中定义的系统级别过滤器,使其包含除内置过滤器之外的所有新过滤器,那么需要使用映射规则语法在基本模型属性“mapping_rules”中对其进行定义。

开始之前

如果在先前的 Synergy 发行版中未更新“system_filename_filters”基本模型属性,那么可跳过该步骤。

过程

  1. 将除内置过滤器之外在“system_filename_filters”基本模型属性上更新的系统级别过滤器转换为映射规则语法。
  2. 在“mapping_rules”基本模型上更新上一步骤中创建的规则。

示例

如果在该示例所示的基本模型属性“system_filename_filters”上存在过滤器:

*.XYZ

,那么应使用该示例所示的映射规则语法转换该过滤器,并且必须在基本模型属性“mapping_rules”上更新转换后规则:

WHEN %name =~ '.*\\.XYZ' IGNORE

对升级后问题进行故障诊断

如果您在命令或过程中遇到困难,或者收到不能理解的错误消息,请尝试以下故障诊断步骤。

过程

  1. 请参阅位于 IBM® Rational 支持站点中的故障诊断信息。
  2. 如果仍有疑问,请联系 IBM Rational 软件支持人员。

反馈