适用于 SAP HANA 的 Backint 代理问题排查

如果在执行备份或恢复过程中出现错误,则相应错误消息会显示在 SAP HANA Studio 或 SAP HANA Cockpit 中,因此,请先在这些位置检查是否存在与错误原因有关的信息。此信息可能会显示在 backup.logbackint.log 跟踪文件中。使用多租户数据库容器 (MDC) 时,务必选择相关的数据库名称。

确保您已以 sidadm 用户身份安装了 Backint 代理。

日志文件

如果出现错误,请查看以下日志:

  • SAP HANA backup.log,其中包含有关 SAP HANA 备份和恢复操作的信息。
  • SAP HANA backint.log,其中包含对 Backint 代理和其他外部备份工具使用的备份接口的调用。
  • Backint 代理日志文件,其中包含 Backint 代理安装和操作事件。Backint 代理日志文件位于 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs 中。Backint 代理日志可能指示与 Cloud Storage 的通信错误以及相关的配置或权限问题。
  • Google Cloud 日志,可能包含与 Backint 代理使用的服务账号相关的错误。如需查看 Google Cloud 日志,请参阅 Google Cloud 控制台中的“日志浏览器”页面

此外,还要检查 SAP HANA 主机上的磁盘和网络 I/O 信息以验证活动。

如需详细了解 Backint 代理日志记录,请参阅 Backint 代理的日志记录

连接问题

如果 Backint 代理无法连接到 Cloud Storage 存储桶,请查看具体配置步骤。请特别检查以下内容:

  • 重试失败的备份或恢复,以确保错误不是由于暂时的连接问题导致的。
  • 如果您将主机虚拟机的服务账号与 Backint 代理搭配使用,则存储的访问权限范围会在 Google Cloud 控制台中的虚拟机实例详情页面上的 Cloud API 访问权限范围下列为读写。如果不是,请停止实例并修改访问权限范围。
  • 如果您为 Backint 代理创建了服务账号:
    • 在 Google Cloud 控制台中的存储桶详情页面的权限标签页上,确认已列出 Backint 代理服务账号,并且该账号具有 Storage Object Admin 角色。
    • 确认您已创建私钥,将其存储在 SAP HANA 主机上,并且在 Backint 代理配置文件 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt 中正确指定了 JSON 密钥文件的路径。
  • parameters.txt Backint 代理配置文件和 SAP HANA global.ini 文件中正确指定了所有参数。

您可以使用 Google Cloud CLI 测试从 SAP HANA 主机到 Cloud Storage 存储桶的访问。使用 gcloud CLI 在 Cloud Storage 存储桶中保存和访问文本文件:

  1. 如果您没有使用默认服务账号,请以有权访问 Cloud Storage 存储桶的用户身份,或使用 Backint 代理服务账号向 Google Cloud 进行身份验证:

    gcloud auth login user-account
    或:
    gcloud auth activate-service-account --key-file=/path/key-file-name.json
    如需详细了解服务账号的 Cloud Storage 身份验证,请参阅 gcloud CLI 身份验证

  2. 确认您可以列出存储在存储桶中的对象:

    gcloud storage ls gs://bucket/

  3. 创建测试文件:

    touch test.txt

  4. 确认您可以将测试文件写入存储桶:

    gcloud storage cp test.txt gs://bucket/test.txt

  5. 确认您可以读取存储桶中的测试文件:

    gcloud storage cp gs://bucket/test.txt

低吞吐量

如果吞吐量低于预期,请验证是否停用了压缩功能。

要停用压缩,请将 #DISABLE_COMPRESSION 标志添加到 Backint 代理 parameters.txt 文件中。

多流处理错误

如果您在多流处理时遇到错误,请将流的数量更改为一 (1),看看该错误是否与流的数量有关。

如需详细了解 Backint 代理日志记录,请参阅使用 Backint 代理多流处理数据备份