升级数据库

本部分说明了在升级到新服务器时,如何将 Rational® Synergy 数据库升级至 Rational Synergy R7.2 或更高版本

关于此任务

数据库升级需求

要能够将 R7.0、7.1 或 7.1a 数据库与 Rational Synergy R7.2 或更高版本结合使用,必须先升级这些数据库。此外,在升级这些数据库之前,必须已安装 Rational Synergy R7.2 或更高版本

关于此任务

该信息中心描述了如何升级 Rational Synergy 7.0、7.1 或 7.1a 基本模型数据库。这些数据库尚未通过使用来自模型数据库的模型安装进行定制。

使用“类型定义”对话框或通过修改控制文件来定制的数据库仍视为基本模型数据库。 这些数据库必须通过使用这些过程进行升级。

要升级模型数据库以及使用模型安装定制的数据库,请与 IBM® Rational 软件支持联系。

解压缩先前的数据库

要准备数据库以进行升级,请针对要升级的每个数据库完成以下任务以解压缩先前的数据库。

关于此任务

如果您遵循创建数据库服务器中的指示信息,那么新服务器为空并且随时可供使用。

解压缩先前的数据库

如果您使用 ccmdb backupccmdb pack 压缩了前发布标识中的数据库,请通过 R7.2 或更高版本将数据库解压缩至新服务器中。

过程

运行 ccmdb unpack 命令:
ccm_root$ CCM_HOME=/usr/local/ccm72x; export CCM_HOME
ccm_root$ PATH=$CCM_HOME/bin:$PATH; export PATH
ccm_root$ ccmdb unpack packfile -to database_path [-s server]
注: 如果包文件来自 Windows 服务器,那么必须将 -w 选项与 ccmdb upgrade 结合使用,如将基本模型数据库升级至 7.2 或更高版本中所述。

将基本模型数据库升级至 7.2 或更高版本

针对每个要升级的 UNIX 生产数据库执行以下步骤。

过程

  1. ccm_root 身份登录。
    $ su - ccm_root
  2. 保存手动定制。

    升级程序会自动保存先前的 ptnotify 目录以及先前的迁移规则文件。

    如果您更改了任何特定于数据库的配置文件,请制作这些文件的备份副本以保存这些更改。

    如果将任何过程图像存储在 Rational Synergy 安装中,那么请保存这些图像文件,然后将它们复制到新的 Rational Synergy 安装或其他某个位置。

    如果将图像存储在 Rational Synergy 安装中,或将其托管在 Rational Synergy CCM 服务器中,请更新 Web 服务器以从新位置托管这些文件,然后更新 Rational Synergy 中的 URL 以引用新的 URL(如果发生了更改)。

  3. 运行升级程序。
    ccm_root$ CCM_HOME=/usr/local/ccm72x; export CCM_HOME
    ccm_root$ PATH=$CCM_HOME/bin:$PATH; export PATH
    ccm_root$ ccmdb upgrade [-w] database_path_1 database_path_2  -l logfile

    database_path 必须作为绝对路径提供。您可以为要升级的数据库列表指定任意数量的 database_path 路径。升级程序可能需要花费一定时间来完成,从几分钟(针对小型数据库)到许多个小时(针对大型数据库)。

    可以解压缩 UNIX 安装上的 Windows 数据库。UNIX 上的 ccmdb unpack 命令可以读取在 Windows 系统上创建的包文件。 生成的数据库的重要文件中可能包含必须更新的 Windows 样式 ASCII 数据。命令 ccmdb upgrade 具有选项 -w,除执行升级外,该选项还会转换数据库文件。将检查 ascii 类型或其子类型的所有数据库配置文件和受控文件,并将其转换为 UNIX ASCII 格式。这种转换仅影响归档和高速缓存中的受控文件,因为不会更新工作区。

    注: 由于该操作会更改静态已归档文件的内容,所以使用时要特别小心。请始终保留原始数据库备份,以防发现任何问题。

    有关升级程序的更多信息,请参阅运行 Rational Synergy 升级程序

  4. 升级程序取消了对数据库的保护。 通过使用 ccmdb protect database_path 重新保护数据库,直至您完成以下步骤并测试结果。
  5. 完成数据库升级后,浏览您在步骤 3 中创建的日志文件以及通过 ccmdb upgrade 命令创建的 ccm_upgrade.log 文件。找出需要进一步操作的任何错误或警告消息。
  6. 复原手动定制。

    如果您更改了任何特定于数据库的配置文件(如触发器),请将 2 中保存的更改合并到转换的数据库中。

    注: 必须将这些文件与 R7.2 或更高版本版本合并,而不复制回保存的版本。
  7. 将以下目录保存至单独目录中以供将来参考。

    ccmdb upgrade 程序在安装新 7.2 或更高版本文件之前保存从数据库中所选的文件。 对数据库上的第一项完成 ccmdb upgrade 后,请将这些文件保存至其他位置以防止它们被未来的升级覆盖。保存的文件位于数据库路径下。

    保存以下目录的内容:
    • old_types
    • oldbin
    • oldpt
    • lib/oldnotify
    保存以下文件的内容:
    • lib/Unix/migrate.old
    • lib/Windows/migrate.old
  8. 修改标准类型。

    如果自先前模型安装以来修改了数据库中的任何标准类型,那么这些类型会自动导出到 database_path/old_types 目录中。 将任何修改的类型与对应的 R7.2 或更高版本类型进行比较,如下所示:

    1. 启动 Rational Synergy CLI。
    2. 通过使用以下命令导出 R7.2 或更高版本类型:
      ccm typedef -export type_name -to xml_file
    3. 将 R7.2 或更高版本类型与 database_path/old_types 目录中的对应类型进行比较。 您可以通过比较 XML 文件来执行此操作。
    4. 如果您必须重新应用更改,请通过 R7.2 或更高版本在升级的数据库上启动 Rational Synergy CLI,然后运行 ccm typedef -modify 命令以重新应用更改。在未检查和了解所有差异的情况下,请勿执行从先前发布标识到已升级数据库的类型定义导入。如果这样做,该类型定义的其他属性可能会还原为其在先前发布标识中的定义。这些属性可能与 R7.2 或更高版本不兼容。
  9. 合并任务属性定制。

    某些任务属性的设置和可能值保存在数据库的 pt 目录中。

    使用这些指示信息将数据库从 R7.0、7.1 或 7.1a 升级至 R7.2 或更高版本后,在该数据库下有 2 个 pt 目录。要完成升级,必须将您在先前发布标识中进行的更改重新应用于新的 database_path/pt 目录。 先前的 pt 目录保存在 database_path/oldpt 中。

    注: 必须将这些文件与 R7.2 或更高版本版本合并,而不复制回保存的版本。

    还必须记住恢复对 task 类型所做的任何更改,如向 source_attrs 属性中添加属性。

  10. 合并 notify 定制。

    使用这些指示信息将数据库从 R7.0、7.1 或 7.1a 升级至 R7.2 或更高版本后,在该数据库下有 2 个 notify 目录。要完成升级,必须将您在先前发布标识中进行的更改重新应用于新的 database_path/lib/notify 目录。 先前的 notify 目录保存在 database_path/lib/oldnotify 中。

    注: 必须将这些文件与 R7.2 或更高版本版本合并,而不复制回保存的版本。如果您使用 Rational Change,那么必须执行此合并,因为它需要修改的通知脚本。
  11. 升级 DCM 设置。

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

结果

现在,您的数据库已升级至 R7.2 或更高版本

测试数据库升级

您已完成对生产数据库的升级。 要测试结果,请启动 Rational Synergy 会话并执行若干操作。本主题包含操作的短列表。

关于此任务

如果升级后手动保护了数据库,那么您必须取消对该数据库的保护,然后才能启动会话。 要运行测试,请取消对数据库的保护并启动会话。然后,立即再次保护数据库,以便开发者在您确认数据库正常运行之后才开始使用数据库。 每次您启动会话以进行测试或执行升级后操作时,请重复这些步骤。

过程

  1. 通过使用 cmsynergy 命令在升级的数据库上启动 Rational Synergy 会话。
  2. 通过 Rational Synergy 中的资源管理器和“工作”窗格执行操作。
  3. 创建任务并将其分配给自己。
  4. 创建项目。
  5. 在新项目中创建一个或多个源对象。
  6. 检入其中一个或多个源对象。
  7. 检出您所检入的一个或多个源对象。
  8. 查看其中一个或多个源对象的历史记录。
  9. 使用某个已检出的源对象的较早版本。
  10. 更新项目并验证是否替换了您使用的版本。
  11. 确保您可以使用普通构建脚本来构建自己的产品。
  12. 将您的工作区与数据库同步。

结果

请参阅升级注意事项以获取有关测试升级的详细信息。


反馈