onrestorept 实用程序

如果升级到新版本服务器失败，可以使用 onrestorept 实用程序来将服务器实例恢复到其刚刚开始升级前的原始状态。仅当 CONVERSION_GUARD 配置参数设置为 1 或 2 并且升级到新版本服务器失败时，才能运行 onrestorept 实用程序。

但是，如果将 CONVERSION_GUARD 配置参数设置为 1 或 2，而转换保护操作失败（例如，由于服务器空间不足而无法存储复原点数据），并且升级到新版本失败，那么您将无法使用 onrestorept 实用程序来复原数据。

开始升级之前：

将 CONVERSION_GUARD 配置参数设置为 1 以在升级过程中启用恢复点，并在发生捕获恢复点数据相关错误时停止升级。
如果希望即使在发生与捕获复原点数据相关的错误（例如，由于服务器空间不足而无法存储复原点数据）时服务器也继续升级，请将值设置为 2（缺省值）。

启用 CONVERSION_GUARD 配置参数后，onrestorept 实用程序将使用升级期间捕获的且存储在 RESTORE_POINT_DIR 配置参数所指定的目录的数据。如果升级成功完成，服务器将自动删除恢复点文件。

升级开始时 RESTORE_POINT_DIR 配置参数指定的目录必须为空。如果该目录包含来自先前升级的任何恢复点文件，那么必须在新升级开始产生新恢复点之前除去这些文件。

重要：运行 onrestorept 实用程序时，GBase 8s 必须处于脱机状态。在 onrestorept 实用程序完成运行之前，不要启动服务器。在服务器不处于脱机状态时执行 onrestorept 实用程序，或者在 onrestorept 实用程序完成运行之前启动服务器，都可能会损坏数据库，从而需要从备份副本复原数据库。

仅在升级失败后才能使用 onrestorept 实用程序。如果在成功升级到新版本后需要还原到服务器的上一版本，那么必须使用 onmode -b 命令还原。在开始升级之前，您仍然应该备份您的文件，以防成功迁移后需要使用 onmode -b 命令还原到服务器的先前版本。