适用于 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 附带的 Cloud Storage gsutil 工具测试从 SAP HANA 主机到 Cloud Storage 存储桶的访问。使用 gsutil 工具在 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 身份验证，请参阅 gsutil 身份验证。
确认您可以列出存储在存储桶中的对象：
```
gsutil ls gs://bucket/
```
创建测试文件：
```
touch test.txt
```
确认您可以将测试文件写入存储桶：
```
gsutil cp test.txt gs://bucket/test.txt
```
确认您可以读取存储桶中的测试文件：
```
gsutil cp gs://bucket/test.txt
```

低吞吐量

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

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

多流处理错误

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