执行升级后步骤

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

关于此任务

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

安装 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,且如 保存先前的安装 中所述保存了先前 ptcli 配置文件的已修改副本,请立即将其合并。 ptcli 文件为:Program Files\IBM Rational\IBM Rational Synergy 7.2\etc\ptcli.cfg

Rational Synergy Distributed 升级后传输

Rational Synergy 7.2 支持 DCM 与发行版 7.0, 7.1, or 7.1a 的相互传输。 这些发行版的修补程序需要与 DCM 兼容。

关于此任务

如需更多信息,请参阅 Rational Synergy 发行版 7.2自述文件以及更早发行版的修补程序的产品自述文件。

更新工作区

如果已在升级过程中将数据库移至新路径(可能在新计算机上),请更新现有工作区以使其引用新路径。对于基于副本和基于链接的工作区而言,适合应用该信息。

过程

  1. 已移动数据库的每个用户必须运行命令以更新其工作项目:
    ccm wa /dbpath old_database_path /show project_spec...
    ccm wa /dbpath old_database_path /replace -show project_spec...
    1. 构建管理员还必须更新其 prep 项目。
  2. ccm wa /dbpath 命令使用相应的 /scope 选项,以更新共享或静态项目。

禁用 7.0, 7.1, or 7.1a 服务

升级过程已停止,并呈现已升级的服务器上不能用的先前发布标识。

过程

  1. 在任务栏上,单击开始 > 控制面板 > 管理工具 > 服务,以打开“服务”窗口。
  2. 对每个 7.0, 7.1, or 7.1a Rational Synergy 服务重复以下步骤:
    1. 右键单击服务条目,然后选择属性
    2. 常规选项卡中,将“启动”类型更改为“已禁用”。

除去先前的安装

不再需要旧发布标识时,请使用卸载命令除去先前的安装。

关于此任务

注: 如果已在此台计算机上使用过程“升级现有服务器”,请勿删除先前的 Rational Synergy 安装目录。如果错误地将其除去,那么已升级的服务器可能会受损。有关更多信息,请联系 IBM® Rational 软件支持人员。

安装 Windows 客户机

如果需要,请为 Rational Synergy R7.2 安装 Windows 客户机。 您不需要卸载以前发行版的客户端。但是,如果您不需要访问使用先前发布标识的数据库,那么可以执行此操作。

关于此任务

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

测试 Rational Synergy 客户机

使用已升级的数据库测试 Rational Synergy 客户机

过程

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

    cmsynergy /d database_path [/s server_url]

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

使数据库可用

完成升级之后,测试升级结果,并执行任何所需的升级后操作,这样升级便完成。

过程

  1. 如果在升级、测试或升级后过程中对数据库进行了保护,现在请撤消保护。
  2. 请告诉用户,数据库可以使用了。
  3. 升级用户的客户机软件。

检查查询限制和加速属性

Rational Synergy 7.0 和 7.1 中,字符串和文本属性在单字节编码 Windows CP1252 中编码,字符串或文本属性查询只检查每个字符串的前 64 个字符(字节)。在 Rational Synergy 7.2 中,文本属性采用可变长度编码方式 UTF-8 进行编码。查询限制已从 64 个字节提高至 72 个字节,但是 CP1252 中由 64 个或更少的字符和字节所表示的字符串在 UTF-8 中可能需要 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 软件支持人员。

反馈