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

如果在执行备份或恢复过程中出现错误，则相应错误消息会显示在 SAP HANA Studio 或 SAP HANA Cockpit 中，因此，请先在这些位置检查是否存在与错误原因有关的信息。此信息可能会显示在 backup.log 和 backint.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 存储桶中保存和访问文本文件：

如果您没有使用默认服务账号，请以有权访问 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 身份验证。
确认您可以列出存储在存储桶中的对象：
```
gcloud storage ls gs://bucket/
```
创建测试文件：
```
touch test.txt
```
确认您可以将测试文件写入存储桶：
```
gcloud storage cp test.txt gs://bucket/test.txt
```
确认您可以读取存储桶中的测试文件：
```
gcloud storage cp gs://bucket/test.txt
```

低吞吐量

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

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

多流处理错误

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