NetBackup™ for MariaDB 管理指南

Last Published:
Product(s): NetBackup (11.1)

解决在使用 NetBackup for MariaDB 时出现的错误

解决问题的一般性准则

表：解决问题的常规步骤 列出了一些常规步骤，可帮助您解决在使用 NetBackup for MariaDB Agent 时可能遇到的问题。

表：解决问题的常规步骤

步骤

操作

描述

步骤 1

记住错误消息.

错误消息通常是指出哪里出现故障的手段。如果在命令行中没有看到错误，但仍怀疑有问题，请检查日志和报告。这些工具可提供错误消息，直接指向问题。日志和报告是必备的故障排除工具。

步骤 2

确定出现问题时您正在做什么.

提出以下问题：

  • 尝试进行了什么操作？

  • 您使用的方法是什么？

  • 涉及哪种类型的服务器平台和操作系统？

  • 如果您的站点同时使用主服务器和介质服务器，那么它是主服务器还是介质服务器？

  • 如果涉及客户端，那么它是哪种类型的客户端？

  • 以前是否成功地执行过该操作？如果是，与现在有什么不同？

  • Service Pack 级别是什么？

  • 您使用的操作系统软件是否安装了最新的修补程序，尤其是那些必须和 NetBackup 一起使用的修补程序？

  • 您的设备固件所处级别是否已依照发布的设备兼容性列表经过测试，或处于更高级别？

步骤 3

记录所有信息.

捕获以下可能有价值的信息：

  • NetBackup 日志。

  • 特定于 NetBackup for MariaDB 的日志。

  • 特定于 NetBackup XBSA 的日志。

步骤 4

更正问题.

定义问题后，请使用信息更正问题。

步骤 5

与技术支持联系。

如果无法排除故障，请与技术支持联系。

使用日志解决错误

要解决错误，可以参考 NetBackup 日志。这些日志位于以下位置：

NetBackup 主服务器日志位于：

  • install_path\NetBackup\logs\bprd

  • install_path\NetBackup\logs\bpcd

  • install_path\NetBackup\logs\user_ops\dbext\logs

必须启用 bprd 和 bpcd 日志文件。有关更多信息，请参见NetBackup 故障排除指南。

特定于 NetBackup 客户端的日志位于：

  • install_path\NetBackup\logs\nbmariadb

特定于 NetBackup XBSA 的日志位于：

  • install_path\NetBackup/logs/exten_client

NetBackup 故障排查

关于 NetBackup 故障排查，请参见NetBackup 故障排除指南和NetBackup 命令参考指南。

解决 NetBackup for MariaDB 错误

表：解决 NetBackup for MariaDB 错误 列出了在运行操作时出现的错误以及对问题进行故障排除的解决方案。

表：解决 NetBackup for MariaDB 错误

问题

描述

解决方法

nbmariadb 备份失败并显示以下错误：

Unable to load mariadb library

如果未在 nbmariadb 命令中使用 "-l" 开关提供库路径，或提供了库路径但其不包含 libmariadb.so (Linux) 或 libmariadb.dll (Windows)，则可能会遇到此问题。

验证下列内容，然后再次运行备份：

  • 确保提供正确的 MariaDB 库路径，其中包含 libmariadb.so (Linux) 或 libmariadb.dll (Windows) 文件。

  • (Linux) 如果未提供 libmariadb.so，请创建一个名为 libmariadb.so 的符号链接，该链接指向 libmariadb.so.<n>。

  • (Windows) 如果 MariaDB 安装位置的 bin 目录下未提供 libmariadb.dll，则它可能位于 lib 目录下。

nbmariadb 备份失败并显示以下错误：

Unable to connect to the database

使用无效的数据库用户名、端口号或密码运行 nbmariadb 命令时，mariadb 备份将失败。

  • 使用 nbmariadb 命令的 "-u" 开关提供数据库用户名。

  • 使用 nbmariadb 命令的 "-portnum" 开关提供数据库端口号。

  • 使用 my.cnf (Linux) 或 my.ini (Windows) 文件提供数据库密码。

请参见验证 MariaDB 环境密码。

nbmariadb 备份失败并显示以下错误：

Unable to load xbsa.dll

如果未使用 NetBackup bin 目录更新环境变量路径，nbmariadb 备份将失败。

要运行 nbmariadb 备份，请执行以下操作：

  • 使用 NetBackup_install_path/bin 更新环境变量路径。

nbmariadb 备份失败并显示以下错误：

XBSA initiation failed

如果未在命令行上指定所需参数，则 nbmariadb 备份将失败。

要运行 nbmariadb 备份，请执行以下操作：

  • 通过命令行配置有效的主服务器名称、策略名称、日程表类型。

  • 验证 nbmariadb 代理和 NetBackup 主服务器之间是否存在通信错误。

    有关更多信息，请参见《NetBackup 管理指南，第 I 卷》。

(Windows)VSS snapshot creation failed

如果用户无权运行 nbmariadb 操作，nbmariadb 备份可能会失败。

在管理员模式下运行 cmd.exe。

nbmariadb 还原操作不会从目标 NetBackup 客户端还原任何数据。

如果未更新 NetBackup 客户端名称和目标目录，nbmariadb 还原将失败。

对于成功的还原：

  • 验证目标目录是否有效且为空。

  • 从 NetBackup 源客户端启动还原。

  • 设置 NetBackup 客户端名称和目标目录参数。

nbmariadb 备份失败并显示以下错误：

(Linux) Error creating LVM snapshot

如果卷组的空间不足，无法存放快照，nbmariadb 备份可能会失败。

验证卷组中的空间

  1. 要查看卷中的空间，请运行以下命令：

    $vgs

    该命令显示卷组详细信息。

  2. 提供适当的快照大小。快照应等于或大于实例大小。

成功备份之后的错误消息：

<volume_group>/<snapshot_name> Read failure after 0 of 4096 at 29393616896: input or output error.

或者

<volume_group>/<snapshot_name>: read failure after 0 of 4096 at 4096: input or output error.

如果卷组包含快照，nbmariadb 备份会显示这些错误。您可以列出快照，将其删除，然后再次运行备份。

注意:

nbmariadb 创建的 LVM 快照名称前缀为 mariadbsnap

要删除快照，请执行以下操作：

  1. 要列出现有快照，请运行以下命令：

    $lvs

    该命令显示快照详细信息。

  2. 要删除快照，请运行以下命令：

    $ lvremove -f <volume_group>/<snapshot_name>

Linux (LVM) 上的 nbmariadb 备份失败并显示以下错误：

Error unmounting the snapshot-Device or resource busy

或者

Error removing the snapshot-mariadbsnap_<timestamp>

在尝试卸载快照、设备期间或在删除现有快照时，nbmariadb 备份失败。

卸载快照

  1. 要列出所有已装入的文件系统，请运行以下命令：

    $ mount-l

  2. 如果快照仍然存在，请使用以下命令创建装入目录：

    $mount<mount_directory>

    注意:

    此目录在 /mnt/<snapshot_name> 中创建。快照的前缀名称为 mariadbsnap。

  3. 要删除装入目录，请运行以下命令：

    $rm -rf <mount_directory>

  4. 要手动删除快照，请运行以下命令：

    $ lvremove -f <volume_group>/<snapshot_name>

即使成功还原后，仍未能启动 MariaDB 服务。

仅当在次要版本与 MariaDB 相同的计算机上还原备份时，还原操作才会成功。

例如，如果从 MariaDB 版本 10.2.x 备份文件，则必须将文件还原到 MariaDB 版本为 10.2.x 的计算机。

  • 验证备份数据的 MariaDB 版本是否与要还原数据的计算机上的 MariaDB 版本相同。