ON-Bar 返回码

您可以通过查看适用于特定返回码的活动日志消息来对问题进行故障诊断。

下表显示所有 GBase 8s 数据库服务器的 ON-Bar 返回码。这些返回码都与 ON-Bar 活动日志中的消息一起出现。有关错误的详细信息，请在致电技术支持前查看活动日志。

表 1. 公共 ON-Bar 返回码
十进制值 ON-Bar 返回码描述
2 到 34 这些返回码由 XBSA 产生。要了解更多信息，请查阅您的存储管理器文档和日志文件。
100 ON-Bar 在 sysutils、紧急引导文件或处理时需要的存储管理器目录中找不到某些内容。

请检查 ON-Bar 活动日志中表示未找到内容的消息并尝试解决该问题。如果问题再次发生，请联系技术支持。

104 Adstar Distributed Storage Manager (ADSM) 处于生成密码方式中。

ON-Bar 不支持 ADSM 在生成密码的方式下运行。有关更改 ADSM 安全配置的信息，请查看您的 ADSM 手册。

115 正在冷复原的数据库空间集中缺少一个关键数据库空间。
116 onsmsync 实用程序已在运行。
117 sysutils 数据库和紧急引导文件中包含的信息不一致。
118 尝试向存储管理器提交备份对象时出错。
120 自该对象上次备份以来传送缓冲区大小已经改变。该对象无法复原。将传输缓冲区大小设置为原始值并重试复原。
121 ON-Bar 无法确定数据库空间的列表。
122 检测到死锁。

ON-Bar 命令与另一个进程发生争用。重试 ON-Bar 命令。

123 根数据库空间不在冷复原中。
在不复原根数据库空间的情况下无法执行冷复原。要解决问题，请尝试以下过程之一：
  • 让数据库服务器处于停顿或联机方式，这样只需要复原存储空间。
  • 如果数据库服务器处于脱机状态，请发出 onbar -r 命令来复原所有的存储空间。
  • 确保根数据库空间和其他关键数据库空间在命令行或 -f filename 中列出。
124 缓冲区在备份期间有不完整的页。

要获取帮助，请联系技术支持。
126 处理紧急引导文件出错。

检查 ON-Bar 活动日志以获取对问题的描述，并查看紧急引导文件以获取毁坏的情况，例如非 ASCII 字符或列数不同的行。如果问题来源不明显，请联系技术支持。

127 无法写入紧急引导文件中。
通常，操作系统错误消息将与该问题一起出现。 检查以下文件和目录的许可权：
  • UNIX™ 上的 $GBASEDBTDIR/etc
  • 紧急引导文件
128 对象描述中的数据丢失。

要获取帮助，请联系技术支持。
129 ON-Bar 接收到要进行复原的对象不是预期的对象。（备份对象不匹配。）请求的备份对象可能已被删除或对于存储管理器已到期。

运行 onsmsync 让 sysutils 数据库、紧急引导文件和存储管理器目录同步。要获取帮助，请联系技术支持。

130 数据服务器未响应。
在备份或复原期间数据库服务器可能已失败。 运行 onstat - 命令检查数据库服务器状态，接着：
  • 如果操作是冷复原，重新启动该操作。
  • 如果操作是备份或热备份，请重新启动数据库服务器并重试备份或热复原。
131 在 ON-Bar 和数据库服务器的接口中发生故障。

要获取帮助，请联系技术支持。
132 函数不在 XBSA 共享库中。

请验证是否为存储管理器使用了正确的 XBSA。相关信息请查阅存储管理器手册。
133 装入 XBSA 库函数失败。

请验证是否为存储管理器使用了正确的 XBSA。确保 onconfig 文件中的 BAR_BSALIB_PATH 值指向 XBSA 共享库的正确位置。相关信息请查阅存储管理器手册。

134 用户希望复原的逻辑日志文件太早。
您可能在执行单独的物理复原后尝试了日志点复原 (onbar -r -l -n)。指定的逻辑日志太旧而无法与物理复原中使用的备份相匹配。 请执行以下两个步骤之一：
  • 从一组较旧的物理备份重新运行物理复原。
  • 当您重新运行日志点复原时，在 -n 选项中指定较晚的逻辑日志。要查找您可以使用的最早的逻辑日志，请查看紧急引导文件。要获取帮助，请联系技术支持。
136 ON-Bar 无法对关键数据库空间执行热复原。
请执行以下两个步骤之一：
  • 不列出任何关键数据库空间的情况下重新发出热复原命令。
  • 关闭数据库服务器并执行冷复原。
137 超过了 MAX_DBSPACE_COUNT。

要获取帮助，请联系技术支持。
138 发生了 XBSA 错误。

请验证是否为存储管理器使用了正确的 XBSA。同时还检查 bar_act.log 中的 XBSA 错误消息。相关信息请查阅存储管理器手册。

139 可能是 XBSA 版本不在 sm_versions 文件中或 sm_versions 文件中存在不正确的 XBSA 版本。

将正确的 XBSA 版本插入到 sm_versions 文件中。要了解更多信息，请查阅存储管理器手册。

140 伪备份失败。

使用 onbar -b -F 命令重试该伪备份。仅 GBase 8s 支持伪备份。如果伪备份再次失败，请与技术支持联系。

141 ON-Bar 接收到操作系统信号。 最可能的情况是，用户输入 Ctrl-C 命令停止了 ON-Bar 进程。

修复导致中断的问题，然后重试 ON-Bar 命令。

142 ON-Bar 无法打开文件。

请验证指定的文件存在并且许可权也是正确的。检查 ON-Bar 活动日志中操作系统的错误消息。

143 ON-Bar 无法创建子进程。

如果 BAR_MAX_BACKUP 不是 0，ON-Bar 将无法创建子进程来执行并行备份或复原。很可能操作系统的资源已用尽。可能是没有足够的内存可用于启动新进程或进程表中没有空槽。

检查操作系统日志、ON-Bar 活动日志或控制台。

144 日志备份由于一个或多个 Blob 空间关闭而停止。

尝试复原 Blob 空间。如果复原失败，请使用 onbar -l -O 命令重试日志备份。执行此命令可能使 Blob 空间无法复原。

145 ON-Bar 无法获取更多的内存空间。

等待系统资源释放出空间，然后重试 ON-Bar 命令。

146 ON-Bar 无法连接到数据库服务器。

网络或数据库服务器可能已关闭。要获取帮助，请联系技术支持。
147 ON-Bar 找不到任何要进行备份或复原的存储空间或逻辑日志。

例如：如果指定时间点复原但使用第一次标准备份前的 datetime 值，那么 ON-Bar 将无法构建要复原的存储空间列表。如果指定了整个系统的复原而没有执行整个系统的备份，也将显示该返回码。

请验证数据库服务器和存储空间是否针对备份或复原请求而处于正确的状态。请与技术支持联系。
148 发生内部 SQL 错误。

将来自 ON-Bar 活动日志的信息提供给技术支持。

149 在命令行上输入了错误的 ON-Bar 语法，或者为 GLS 环境输入了无效或错误的 datetime 值。

根据 ON-Bar 活动日志中的用法消息检查您尝试过的命令。如果没有用，请将 datetime 值放在引号中，然后重试该命令。如果您的数据库语言环境不是英语，请使用 GL_DATE 或 GL_DATETIME 环境变量来设置日期和时间格式。

150 从 onconfig 文件收集数据时出错。

检查 onconfig 文件中的许可权、格式和值。检查是否正确地设置了 ONCONFIG 环境变量。

151 对于该备份或复原请求数据库服务器处于不正确的状态，或在确定数据库服务器状态时发生错误。

可能是尝试了与数据库服务器方式不兼容的操作，或者可能是 ON-Bar 无法确定数据库服务器状态。例如：无法在数据库服务器处于复原方式时执行物理备份。

检查 ON-Bar 活动日志中的错误消息。如果发生了 ASF 错误，那么在 ON-Bar 活动日志中显示以下消息： 
初始化 ASF 时发生致命错误；asfcode = code

要确定 ASF 错误的原因，请参阅该消息中 ASF 错误代码并重复备份或复原命令。如果未发生 ASF 错误，请更改数据库服务器状态并重复备份或复原命令。
152 ON-Bar 无法备份逻辑日志。
可能由于以下原因之一无法备份逻辑日志：
  • 当前正在运行另一个日志备份。
  • 您所执行的逻辑日志备份中 LTAPEDEV 参数设置为了 /dev/null (UNIX) 。

没有日志备份完成时您将接收到该返回码。

要启用日志备份，请将 LTAPEDEV 参数更改为有效值。
153 ON-Bar 无法设置进程组标识。如果将 BAR_MAX_BACKUP 设置为除 1 以外的任意值，并且 ON-Bar 在设置进程组标识时发生错误，将返回该值。

该消息是对可能的操作系统问题的警告。
154 ON-Bar 用户没有正确的许可权。

要执行 ON-Bar 命令，您必须是 root 用户、gbasedbt 用户、UNIX 上 bargroup 组的成员。

155 未设置 GBASEDBTSERVER 环境变量。

将 GBASEDBTSERVER 环境变量设置为正确的数据库服务器名。

156 未执行备份或复原，因为 LTAPEDEV 参数值无效。

如果未设置 LTAPEDEV 或在 UNIX 中设置为 /dev/null，那么将不备份逻辑日志，并且 ON-Bar 会返回警告 152。

157 试图将 GBASEDBTSHMBASE 环境变量设置为 -1 出错。

ON-Bar 无法将 GBASEDBTSHMBASE 设置为 -1。要获取帮助，请与系统管理员或技术支持联系。

158 发生内部 ON-Bar 错误。

请与技术支持联系。
159 发生意外错误。

请与技术支持联系。
160 外部复原失败。

要确定外部复原失败的原因，请查看 bar_act.log 和 online.log 文件。 确保已执行外部复原的手动部分，然后再重试 onbar-r -e 命令以完成外部复原。如果不起作用，请尝试从不同的外部备份进行外部复原。

161 重新启动的复原失败。

请验证 RESTARTABLE_RESTORE 是否设置为 ON 并重试原始复原。要了解更多信息，请查看 ON-Bar 活动日志和数据库服务器消息日志。

162 ON-Bar 日志文件不能是符号链接。

除去符号链接或更改 onconfig 文件，使 ON-Bar 参数 BAR_DEBUG_LOG 或 BAR_ACT_LOG 指向非符号链接文件。

163 ON-Bar 日志文件的所有者必须是用户 gbasedbt。

将日志文件的所有者更改为用户 gbasedbt 或者更改 onconfig 文件中 BAR_ACT_LOG 或 BAR_DEBUG_LOG 的值以指向不同的日志文件。

164 无法打开文件。

由于该文件或其目录的许可权问题，无法创建或打开该文件。 验证该文件及其目录的许可权。

177 联机的数据库空间已复原。该返回码通知用户 -O 选项在 ON-Bar 中重设了内部检查。

您不需要采取任何操作。
178 当一个或多个 Blob 空间关闭时备份了逻辑日志。该返回码通知用户 -O 选项在 ON-Bar 中重设了内部检查。

检查 Blob 空间中的数据以确定需要重新创建哪些简单大对象。这些 Blob 空间可能无法复原。 要获取帮助，请联系技术支持。

179 ON-Bar 创建了复原数据库空间所需要的块。该返回码通知用户 -O 选项在 ON-Bar 中重设了内部检查。

您不需要采取任何操作。
180 ON-Bar 无法创建复原数据库空间所需要的块。

请手动创建块文件。不带 -O 选项重试该复原。

181 ON-Bar 使备份或复原所需的对象到期。

onsmsync 实用程序使复原可能需要的对象到期。您可能使用 -O 指定了 onsmsync。如果错误地使用了 -O 选项，请与技术支持联系以便从存储管理器复原对象。

183 ON-Bar 无法从存储管理器获得逻辑日志的唯一标识。

缺少指定逻辑日志的备份。查询存储管理器以确定指定的逻辑文件的备份是否存在，是否可复原。

247 在 UNIX 上，请查看 /tmp/bar_act.log 以及由 BAR_ACT_LOG 参数指向的文件，以获得线索。（onbar-merger 向 /tmp/bar_act.log 中写入直到它有足够的信息来读取 onconfig 文件。）解决 bar_act.log 描述的问题并重试冷复原。如果冷复原仍然失败，请联系技术支持。
252

要获取帮助，请联系技术支持。
父主题： ON-Bar 消息和返回码