onsmsync 实用程序

使用 onsmsync 实用程序可通过存储管理器目录来同步 sysutils 数据库和紧急引导文件。

如果您的存储管理器是 GBase 8s Primary Storage Manager，那么还可以使用 onsmsync 实用程序的导出和导入选项来将 GBase 8s Primary Storage Manager 备份对象导出至外部设备，并将外部设备中的对象导入到 GBase 8s Primary Storage Manager 管理的设备。 不能对其他存储管理器使用导出和导入选项。

导出和导入选项（仅用于 Primary Storage Manager）

下表列出了所有 onsmsync 命令元素，但用于导入和导出备份生成的元素除外。用于导入和导出的命令元素在表 2 中列出。

表 1. onsmsync 命令的元素
元素 用途 关键注意事项
-b 将紧急引导文件 (ixbar.servernum) 和 sysutils 数据库通过对方重新生成。 如果 ixbar 文件为空或不存在，那么 onsmsync -b 会重新创建 ixbar 文件并从 sysutils 表填充该文件。

如果 ixbar 文件不为空且包含对象数据，那么 onsmsync -b 会更新 sysutils 数据库和 ixbar 文件，以使其同步。

如果 ixbar 文件具有条目，并且 sysutils 数据库已重新构建，但由于不包含数据而为空，那么 onsmsync -b 会从 ixbar 文件重新创建 sysutils 数据。

请不要将 -b 元素与其他 onsmsync 选项一起使用。

-b 元素不与存储管理器同步。

dbspace 指定要使其到期的一个或多个存储空间 如果输入多个存储空间的名称，请使用空格来分隔这些名称。
-f filename 指定包含要到期存储空间列表的文件的路径名 使用该选项可避免输入一长串存储空间。文件名可以是任何有效的 UNIX™ 文件名。
-g generation 指定每个 0 级备份要保留的版本数 保留最近生成的备份并使此前的所有备份都到期。
-i interval 指定保留备份的时间间隔。 实用程序：
  • 保留在此时间间隔之后创建的备份。
  • 使在此时间间隔之前创建的备份到期，并在到期的对象也被除去时除去这些备份。

如果从该间隔后的其他备份复原时需要在此间隔之前的备份，那么该间隔之前的备份不会到期。使用 ANSI 或 GLS 格式来表示 interval：YYYY-MM 或 DD HH:MM:SS

-O 覆盖内部错误检查，并强制实施到期策略 如果与 -t、 -g 或 -i 选项一起使用，即使从发生在此到期日期之后的备份进行复原时需要所有级别的备份中的一部分，也要使所有级别的备份到期。-O 选项不影响逻辑日志到期。请参阅使所有备份到期。
-s 跳过对到期的备份的同步 如果提供了 -s 选项，那么对象到期取决于其他参数。
-t timestamp 在特定日期和时间之前让所有备份到期 保留在指定时间戳记后完成的备份。如果从该时间戳记后发生的其他备份复原时需要在该时间戳记之前发生的备份，那么后者不会到期。

使用 ANSI 或 GLS_DATETIME 格式来表示时间戳记。
-cf value 指定是否备份关键文件

在与 -g、-i 或 -t 一起使用时，从 GBase 8s Primary Storage Manager 删除关键文件备份

有效值为：
  • Yes。备份关键文件。该值为 0 级、1 级或 2 级备份的缺省值。
  • No。不备份关键文件。该值为备份逻辑日志文件的缺省值。
  • Only。仅备份关键文件。
表 2. onsmsync 导出和导入命令的元素
元素 用途 关键注意事项
-E 将单一备份生成导出至 GBase 8s Primary Storage Manager 外部池 仅当设置 GBase 8s Primary Storage Manager 外部池时使用此选项。

如果导出备份生成，那么必须指定前缀，以标识导出的备份。onsmsync 实用程序会在外部池中创建一个包含该前缀的子目录，并将导出的对象放入该目录。

-g generation 指定要导出的备份生成。 缺省值是当前备份。
-I 从外部 GBase 8s Primary Storage Manager 池导入单一备份生成。 如果从外部池导入备份生成，那么必须指定导出的备份的前缀。该前缀用于标识要导入的备份生成。
-l log_ID 导出包含逻辑日志标识的备份生成。  
-p prefix 指定要分配给将导出的备份生成的前缀，或用于标识要导入的备份的前缀。 当 onsmsync 实用程序导出备份生成时，它会使用该前缀作为放置该备份的子目录的名称。
-t timestamp 指定包含特定日期和时间的备份生成（仅用于导出）。 使用 ANSI 或 GLS_DATETIME 格式。

当您推出应用程序的新版本时，可能希望包含日期和时间。

用途

如果不指定任何选项，那么 onsmsync 命令会使用存储管理器目录来同步 sysutils 数据库和紧急引导文件。onsmsync 实用程序会将 sysutils 数据库和紧急引导文件中的备份与存储管理器目录中的备份进行比较，然后从 sysutils 数据库和紧急引导文件中除去存储管理器目录内不存在的所有备份。

提示： 要控制 sysutils 数据库是否保留已到期的备份与复原的历史记录，请 使用 BAR_HISTORY 配置参数。有关信息，请参阅BAR_HISTORY 配置参数。

除了存储空间名或文件名必须放在最后之外，命令的顺序无关紧要。

命令的顺序无关紧要，但以下情况除外：
  • 存储空间名称或文件名必须放在最后。
  • 导出或导入时，-E 或 -I 选项必须放在最前。例如，指定 onsmsync -E -g 2，而不是 onsmsync -g 2 -E。
在不同计算机上导入和导出备份生成的先决条件如下：
  • 在源计算机和目标计算机上必须具有相同版本的 GBase 8s，并且这些计算机必须使用相同的操作系统。
  • 在源计算机和目标计算机上必须设置 GBase 8s Primary Storage Manager 并创建一个外部池。

当您使用 -E 或 -I 选项导出或导入备份生成时，必须指定用于标识放置备份生成的子目录的前缀。

如果使用 -E 或 -I 选项导出或导入备份生成，那么不能使用与导出或导入操作无关的任何 onsmsync 命令选项。例如，不能同时导出备份生成并重新生成紧急引导文件。

onsmsync -I 命令重命名当前 ixbar 文件，并创建仅包含复原导入的备份所必需信息的新文件

您可以将 -cf 选项与 -g、-i 或 -t 选项一起使用，以从存储管理器删除关键文件备份。

如果应用 -g 选项，并且 onsmsync 实用程序的对象列表仅包含逻辑日志而不包含任何空间备份，那么这些日志备份不会到期。在此情况下，请使用 -t 或 -i 选项来使逻辑日志备份到期。

示例

以下示例使 2012 年 11 月 30 日前开始的备份到期：
onsmsync -t "2012-11-30 00:00:00""
以下命令将最后一个备份生成导出到外部池中名为 gen 的目录：
onsmsync -E -p gen -g 1
以下命令将按最新程度排名第 4 位的备份生成导出到外部池中名为 gen 的目录：
onsmsync -E -p gen -g 4
以下命令将当前备份生成导出到外部池中名为 gen 的目录：
onsmsync -E -p gen
以下命令将生成 2 中的所有备份对象导出到外部池中名为 gen 的目录：
onsmsync -E -p gen -g 2
以下命令将时间戳记为 2012-12-31 12:00:00 的所有备份对象导出到外部池中名为 gen 的目录：
onsmsync -E -p gen -t “2012-12-31 12:00:00“
以下命令导入以前缀 gen 标识的子目录中的所有对象：
onsmsync -I -p gen
以下命令导入使用前缀 gen 和时间戳记 2012-12-31 12:00:00 导出的所有备份对象。由于前缀用于标识备份生成，因此不用指定时间戳记。
onsmsync -I -p gen

以下命令将除了最后两次生成的关键文件备份之外的所有内容删除：

onsmsync -g 2 -cf yes
父主题： 使备份目录到期和同步