排查Azure上SAP HANA数据库的备份问题

本文提供故障排除信息，用于备份Azure virtual machines上的SAP HANA数据库。 有关我们当前支持的SAP HANA备份方案的详细信息，请参阅 Scenario 支持。

先决条件和权限

在配置备份之前，请参阅先决条件和预注册脚本的功能部分。

备份和还原SAP HANA数据库的常见用户错误

UserErrorHANAInternalRoleNotPresent

UserErrorInOpeningHanaOdbcConnection

UserErrorHanaInstanceNameInvalid（用户错误：Hana实例名称无效）

UserErrorHANALSNValidationFailure（用户错误：HANA日志序列号验证失败）

UserErrorSDCtoMDCUpgradeDetected（已检测到从SDC升级到MDC的用户错误）

用户错误：配置Backint无效 (UserErrorInvalidBackintConfiguration)

用户错误：源和目标系统不兼容，无法恢复

用户错误HANA PO不存在

用户错误：数据库用户权限不足

用户错误数据库用户密码已过期

用户错误不一致SSFS

用户错误无法连接到Azure Active Directory服务

用户错误配置的SSL CA存储

用户错误备份失败因为补救备份正在进行中

操作取消，因为存在冲突的正在运行的用户操作错误

操作已取消，因为正在运行的自动修复操作存在冲突 用户错误

环境预注册脚本运行错误

用户错误：Hana预脚本未运行

UserErrorPreregistrationScriptNotRun

用户错误目标PO已存在未指定覆盖

用户错误恢复系统脚本未能触发还原

用户错误：数据库名称格式不正确

UserErrorDefaultSidAdmDirectoryChanged

UserErrorHDBsettingsScriptNotFound (用户错误：未找到HDB设置脚本)

用户错误：系统驱动器上没有足够的空间用于扩展元数据

云Dos绝对限制已达

云端DoS绝对限制已达重试

用户错误无效Backint

UserErrorHanaSQLQueryFailed

用户错误恢复目标目录缺失

扩展升级时作业已取消

恢复SAP HANA数据库的检查流程

还原SAP HANA数据库时，请确保遵循以下准则：

单容器数据库 (SDC) 还原

在将 HANA 的单容器数据库 (SDC) 还原到另一台 SDC 计算机时，请注意输入。 数据库名称应采用小写形式，后跟括在括号中的sdc。 HANA 实例将以大写字母显示。

已对 SDC HANA 实例 “H21” 进行了备份。 备份项页会将备份项名称显示为“h21(sdc)”。 如果尝试将此数据库还原到另一个目标 SDC（如 H11），则需要提供以下输入。

请注意以下几点：

• 默认情况下，还原的数据库名称将用备份项名称填充。 在本例中为 h21(sdc)。
• 选择 H11 作为目标不会自动更改已还原的数据库名称。 应将其编辑为“h11(sdc)”。 对于 SDC，还原的数据库名称将是小写字母后跟用英文括号括起的“sdc”的目标实例 ID。
• 由于 SDC 只能包含一个数据库，因此还需要选择相应的复选框，以允许使用恢复点数据替代现有的数据库数据。
• Linux 区分大小写。 因此请小心保留大小写。

多容器数据库 (MDC) 还原

在 HANA 的多容器数据库中，标准配置是 SYSTEMDB 加上一个或多个租户数据库。 还原整个 SAP HANA 实例会同时还原 SYSTEMDB 和租户数据库。 首先还原 SYSTEMDB，然后再还原租户数据库。 系统数据库实质上旨在覆盖所选目标上的系统信息。 这种还原还会替代目标实例中与 BackInt 相关的信息。 因此，在将系统数据库还原到目标实例后，请再次运行注册前脚本。 只有这样，随后的租户数据库还原才会成功。

备份复制的 VM

方案 1

原始 VM 是使用Azure Site Recovery或Azure VM 备份复制的。 新 VM 是为模拟旧的 VM 而构建的。 也就是说，设置完全相同。 （这是因为原始 VM 已删除，还原是从 VM 备份或Azure Site Recovery完成的）。

此方案可包含两种可能的情况。 了解如何在这两种情况下备份复制的 VM：

1. 创建的新 VM 与已删除的 VM 同名，并且位于已删除的 VM 所属的资源组和订阅中。

   • 此扩展已在 VM 中，但对所有服务都不可见
   • 运行预注册脚本
   • 在 Azure portal（备份 ->查看详细信息 ->选择相关的 Azure VM ->重新注册）
   • 然后，现有的已备份数据库（源自已删除的 VM）应该会成功开始备份

2. 创建的新 VM 会出现以下两种情况之一：

   • 名称与已删除的 VM 不同
   • 名称与已删除的 VM 相同，但其资源组或订阅与被删除的 VM 相比不同。

   如果是这样，请执行以下步骤：

   • 此扩展已在 VM 中，但对所有服务都不可见
   • 运行预注册脚本
   • 如果发现并保护新数据库，你将在门户中看到重复的活动数据库。 为避免出现这种情况，请对旧数据库停止保护并保留数据。 然后继续执行其余步骤。
   • 探索数据库
   • 对这些数据库启用备份
   • 现有的已备份数据库（来自已删除的 VM）继续存储在保管库中。 这些数据库连同其保留的备份将根据策略一起存储。

方案 2

原始 VM 是使用Azure Site Recovery或Azure VM 备份复制的。 新 VM 是根据内容构建的 — 将用作模板。 该 VM 是新的，并具有新的 SID。

请按照以下步骤对新 VM 启用备份：

• 此扩展已在 VM 上，但对所有服务都不可见
• 运行预注册脚本。 根据新 VM 的 SID，可能会出现两种情况：
  • 原始 VM 和新 VM 具有相同的 SID。 预注册脚本将成功运行。
  • 原始 VM 和新 VM 具有不同的 SID。 预注册脚本将会失败。 请联系Azure支持以获取帮助。
• 发现要备份的数据库
• 对这些数据库启用备份

在同一 VM 上升级 SDC 版本或 MDC 版本

在不导致 SID 更改的情况下，OS 升级、SDC 版本更改或 MDC 版本更改可以按以下方式处理：

• 确保新的 OS 版本、SDC 或 MDC 版本当前是由 Azure Backup 支持的。
• 对数据库停止保护并保留数据
• 执行升级或更新
• 重新运行预注册脚本。 通常，升级过程可能会删除所需的角色。 运行预注册脚本以验证所有必需的角色。
• 再次恢复对数据库的保护

从 SDC 升级到 MDC（不更改 SID）

要从 SDC 升级到 MDC 而不导致 SID 更改，可以按如下方式进行处理：

• 确保新的 MDC 版本当前受 Azure Backup 的支持
• 对旧的 SDC 数据库停止保护，同时保留数据
• 执行升级。 完成后，HANA 系统现在便是包含一个系统 DB 和多个租户 DB 的 MDC
• 重新运行预注册脚本
• 在 Azure portal（备份 ->查看详细信息 ->选择相关的 Azure VM ->重新注册）
• 选择重新发掘数据库以匹配同一 VM。 此操作应将步骤 3 中的新 DB 显示为 SYSTEMDB 和租户 DB，而不是 SDC
• 旧的 SDC 数据库将继续位于保管库中，并根据策略保留旧的备份数据。
• 为这些数据库配置备份

从 SDC 升级到 MDC（更改 SID）

要从 SDC 升级到 MDC 并更改 SID，可以按如下方式进行处理：

• 确保新的 MDC 版本当前受 Azure Backup 的支持
• 对旧的 SDC 数据库停止保护，同时保留数据
• 移动位于 的 config.json 文件。
• 执行升级。 在完成后，HANA 系统现在便是包含一个系统 DB 和多个租户 DB 的 MDC。
• 重新运行具有正确详细信息（新 SID 和 MDC）的预注册脚本。 由于 SID 发生更改，你可能会遇到阻碍脚本成功运行的问题。 如果遇到问题，请联系Azure Backup支持人员。
• 在 Azure portal （Backup ->查看详细信息 -> 选择相关的 Azure VM -> 重新注册）。
• 选择重新发掘数据库以匹配同一 VM。 此操作应将步骤 3 中的新 DB 显示为 SYSTEMDB 和租户 DB，而不是 SDC。
• 旧的 SDC 数据库将继续位于保管库中，并根据策略保留旧的备份数据。
• 为这些数据库配置备份。

重新注册失败

在触发重新注册操作之前，请检查是否存在以下一种或多种症状：

• VM 上所有操作（例如备份、还原和配置备份）都失败，并出现以下某一错误代码：WorkloadExtensionNotReachable、UserErrorWorkloadExtensionNotInstalled、WorkloadExtensionNotPresent、WorkloadExtensionDidntDequeueMsg。

• 如果备份项的“备份状态”区域显示“无法访问”，请排除可能导致相同状态的所有其他原因 ：

  • 缺少对 VM 执行与备份相关的操作的权限
  • VM 已关闭，因此无法进行备份
  • 网络问题

由于下面的一个或多个原因，可能会出现这些症状：

• 扩展已从门户网站中删除或卸载。
• 通过就地磁盘还原，VM 被恢复到过去的时间点。
• 该 VM 已关闭较长时间，因此其上的扩展配置已过期。
• VM 已删除。 另外，在已删除 VM 所在的同一资源组中创建了另一个同名的 VM。

在上述方案中，我们建议你对 VM 触发重新注册操作。

SAP HANA数据库日志备份的常见问题

尽管完整备份成功，但日志备份未触发。

可能的原因：触发日志备份时SAP HANA数据库的值不正确。

Recommended action：确保正确设置SAP HANA配置的以下值：

• enable_auto_log_backup：Yes
• log_backup_using_backint：真
• catalog_backup_using_backint：真
• log_mode：正常
• log_backup_timeout_s：与Azure portal的日志备份策略相同（频率为秒）。

后续步骤

• 查看经常提出的问题有关Azure VM 上SAP HANA数据库的备份。