为 SAP HANA 配置基于 Backint 的备份和恢复

本指南介绍如何配置 Google Cloud的 Agent for SAP，以便为 SAP HANA 执行基于 Backint 的备份和恢复。

如需了解此功能的概念信息（可帮助您规划实现），请参阅使用 Backint 为 SAP HANA 执行备份和恢复。

如需了解如何创建基于 Backint 的备份并使用这些备份恢复 SAP HANA，请参阅使用 Backint 备份和恢复 SAP HANA。

准备工作

• 验证已安装Google Cloud的 Agent for SAP 3.8 版（最新版）。如需查看相关说明，请参阅适合您的场景的安装指南。
• 如果您已在裸金属解决方案服务器上安装代理，请确保已满足所需的前提条件并设置服务账号。如需查看相关说明，请参阅在 Linux 上配置 Google Cloud的 Agent for SAP。
• 如果您的 SAP HANA 数据库在本地环境中运行，请务必设置服务账号及其密钥。如需了解如何执行此操作，请参阅在 Linux 上配置 Google Cloud的 Agent for SAP。
• 如果您需要为在 Compute Engine 实例或裸金属解决方案服务器以外的主机上运行的Google Cloud的 Agent for SAP 实例启用此功能，则必须在组件 BC-OP-LNX-GOOGLE 中创建支持 SAP 的事件，以便 SAP 和 Google Cloud 能够评估您的配置。
• 安装 SAP HANA：
  • 如需了解如何使用 Terraform 在Google Cloud 上自动安装 SAP HANA，请参阅适合您的场景的部署指南。
  • 如需了解如何在裸金属解决方案上安装 SAP HANA，请参阅裸金属解决方案上的 SAP HANA 规划指南。

创建 Cloud Storage 存储桶

在启用 Google Cloud的 Agent for SAP 的 Backint 功能之前，请确保存在一个用于存储备份的 Cloud Storage 存储桶。如果您有 Cloud Storage 存储桶，则可以跳过本部分。

如需了解如何将备份存储在 Cloud Storage 存储桶中，请参阅将备份存储在 Cloud Storage 存储桶中。

要创建 Cloud Storage 存储桶，请执行以下操作：

设置 IAM 角色

如需允许 Google Cloud的 SAP for Agent 为 SAP HANA 执行备份和恢复操作，您必须确保 Compute Engine 实例或裸金属解决方案服务器使用的服务账号包含 IAM 角色 Storage Object Admin (storage.objectAdmin)。

如需将此角色添加到您的服务账号，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 IAM 页面。

   转到 IAM

2. 选择您的 Google Cloud 项目。

3. 识别要添加角色的服务账号。

   • 如果该服务账号不在主账号列表中，则表明还没有为它分配任何角色。点击添加，然后输入该服务账号的电子邮件地址。
   • 如果该服务账号已经在主账号列表中，则表明它已具有角色。点击要修改的服务账号对应的修改按钮。

4. 从可用角色列表中，选择 Storage Object Admin。

5. 点击添加或保存，将相应角色应用于该服务账号。

如需获得精细的访问权限级别，您可以在项目级别为服务账号的自定义角色设置以下 IAM 权限：

• storage.objects.list
• storage.objects.create

您还必须在存储桶上设置 IAM 政策，为您的主账号授予以下 IAM 权限：

• storage.objects.get
• storage.objects.update
• storage.objects.delete

如果您想执行分段上传，请添加以下权限：

• storage.multipartUploads.create
• storage.multipartUploads.abort

如需详细了解如何创建自定义角色，请参阅创建和管理自定义角色。如需详细了解如何向主账号授予存储桶级访问权限的自定义角色，请参阅将主账号添加到存储桶级层政策中。

启用对 Cloud API 和元数据服务器的访问权限

在备份和恢复操作期间，Google Cloud的 Agent for SAP 需要访问以下 Google CloudIP 地址和主机：

• 用于访问 Cloud Storage：storage.googleapis.com。
• 对于 Compute Engine 实例元数据服务器：
  • oauth2.googleapis.com（用于进行身份验证）
  • 169.254.169.254
  • metadata.google.internal

如果 Google Cloud的 Agent for SAP 和 SAP HANA 系统在无法访问互联网的 Compute Engine 实例上运行，则需要配置专用 Google 访问通道，以便代理可以与 Cloud Storage 交互；如果使用专用服务账号，则可向 Google Cloud验证自己的身份。如需了解说明，请参阅配置专用 Google 访问通道。

启用 Backint 功能

如需启用 Google Cloud的 Agent for SAP 的 Backint 功能，请完成以下步骤：

1. 使用 SSH 连接到您的 SAP HANA 主机。

   如果您的主机是 Compute Engine 实例，则可在 Google Cloud 控制台中的虚拟机实例页面针对您的实例点击 SSH 按钮，或使用您偏好的 SSH 方法。

2. 切换到 SAP HANA 系统管理员：

   sudo su - SID_LCadm

   将 SID_LC 替换为 SID。对于任何字母，请使用小写字母。

   此命令还会设置多个环境变量，包括使用 SAP HANA 数据库 SID 设置的 $SAPSYSTEMNAME。

3. 为 Google Cloud的 Agent for SAP 启用 Backint 功能：

   /usr/bin/google_cloud_sap_agent installbackint

   或者，如需在具有不同 SID 的主机上安装 Backint 相关文件，请添加 sid 标志：

   /usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC

   将 DIFFERENT_SID_LC 替换为所需 SAP HANA 实例的 SID。对于任何字母，请使用小写字母。

   命令成功运行后，与 Google Cloud的 Agent for SAP 的 Backint 功能相关的所有文件都将安装在 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/ 目录中。这包括将代理与 SAP HANA 集成所必需的文件。它还会在主机上检测适用于 SAP HANA 的 Cloud Storage Backint 代理，停用该代理，并将其文件复制到主机上的可恢复目录。如需了解详情，请参阅从 Backint 代理升级。

4. 配置 Backint 功能：

   运行命令

   • 如果您的 SAP HANA 数据库在 Compute Engine 实例或裸金属解决方案服务器上运行，请运行 configurebackint 命令以配置代理的 Backint 功能。我们建议使用此方法，而不是修改代理的 Backint 配置文件。

     /usr/bin/google_cloud_sap_agent configurebackint \
      -f="PATH_TO_PARAMETERS_FILE" \
      -bucket="BUCKET_NAME"

   • 如果您的 SAP HANA 数据库在本地环境中运行，请通过运行以下命令来配置代理的 Backint 功能：

     /usr/bin/google_cloud_sap_agent configurebackint \
      -f="PATH_TO_PARAMETERS_FILE" \
      -bucket="BUCKET_NAME" \
      -service_account_key="PATH_TO_KEY" \
      -log_to_cloud=false \
      -send_metrics_to_monitoring=false

     替换以下内容：

     • PATH_TO_PARAMETERS_FILE：PARAMETERS.json Backint 配置文件的路径
     • BUCKET_NAME：存储 SAP HANA 备份的 Cloud Storage 存储桶的名称
     • PATH_TO_KEY：您设置的 JSON 编码 Google Cloud 服务账号密钥的完全限定路径

   您可以选择在运行此命令时设置更多参数。如需了解这些参数，请参阅配置参数。

   修改配置文件

   作为运行代理的 configurebackint 命令的替代方法，您可以按如下方式修改 Backint 配置文件：

   1. 打开 Backint 配置文件：

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

      将 SID 替换为安装 Backint 相关文件的 SAP 系统的 SID。

      以下是配置文件所包含内容的示例：

      {
       "bucket": "",
       "log_to_cloud": true
      }

   2. 如需允许 Google Cloud的 Agent for SAP 为 SAP HANA 系统执行基于 Backint 的备份和恢复操作，请修改配置文件，然后指定以下参数：

      • bucket：指定存储 SAP HANA 备份的 Cloud Storage 存储桶的名称
      • service_account_key：如果您已为 Google Cloud的 Agent for SAP 创建服务账号，请指定主机上用于上传相应 JSON 编码服务账号密钥的目录的绝对路径

      如需了解详情，请参阅服务账号注意事项。

   3. 如果您的 SAP HANA 数据库在本地环境中运行，请务必也设置以下内容：

      • "log_to_cloud": false
      • "send_metrics_to_monitoring": false

   4. （可选）您可以修改其他配置参数。如需了解这些参数，请参阅配置参数。

   5. 保存配置文件。

自定义 Backint 配置文件

（可选）启用 Google Cloud的 Agent for SAP 的 Backint 功能后，您可以执行以下自定义操作：

• 重命名 parameters.json 文件。

  为了指明此重命名操作，该文件在 Google Cloud的 SAP for Agent 文档中称为 PARAMETERS.json。

• 为以下各项创建单独的配置文件：SAP HANA 数据卷、SAP HANA 日志卷和 SAP HANA 备份目录。

  请确保为每个配置文件设置唯一的名称。

• 将这些配置文件移动到其他目录。例如，在横向扩容部署中，您可以将所有节点的 Backint 相关配置文件存储在可供节点访问的共享目录中。这样，您就可以更轻松地管理这些文件。

如果要执行上述任一自定义操作，请务必为 SAP HANA 的 global.ini 文件中的参数指定适当的文件名和路径。如需查看相关说明，请参阅配置 SAP HANA 以使用 Backint 功能。

配置 SAP HANA 以使用 Backint 功能

启用 Google Cloud的 Agent for SAP 的 Backint 功能后，需要配置 SAP HANA 系统以使用此功能：

1. 使用 SAP HANA Studio 或 SAP HANA Cockpit 修改 global.ini 配置文件。

2. 在 global.ini 文件的 backup 部分中，为以下参数指定值：

   参数	值
   data_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json。
   parallel_data_backup_backint_channels	对于多流处理数据备份，请根据您使用的 Cloud Storage 存储桶类型、所需的性能和磁盘吞吐量指定通道数量。
   log_backup_using_backint	如果要为 SAP HANA 备份日志卷使用单独的配置文件，请指定值 true。
   log_backup_parameter_file	如果要为 SAP HANA 备份日志卷使用单独的配置文件，请指定以下值： /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json。 将 PARAMETERS_LOG 替换为用于 SAP HANA 日志卷备份的配置文件的名称。
   catalog_backup_using_backint	如果要为 SAP HANA 备份目录使用单独的配置文件，请指定值 true。
   catalog_backup_parameter_file	如果要为 SAP HANA 备份目录使用单独的配置文件，请指定以下值： /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json。 将 PARAMETERS_CATALOG 替换为用于 SAP HANA 备份目录备份的配置文件的名称。

   以下是一个 global.ini 文件的示例，该文件配置为使用 Google Cloud的 Agent for SAP 的 Backint 功能：

   [backup]
   log_backup_using_backint = true
   catalog_backup_using_backint = true
   parallel_data_backup_backint_channels = 16
   catalog_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.json
   data_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.json
   log_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.json

3. 在 global.ini 文件的 persistence 部分中，为以下参数指定值：

   • basepath_logbackup：指定 SAP HANA 无法连接到 Cloud Storage 存储桶时文件系统中 SAP HANA 可用于存储日志备份的目录；确保此目录有足够的空间来存储备份。
   • basepath_catalogbackup：指定 SAP HANA 无法连接到 Cloud Storage 存储桶时文件系统中 SAP HANA 可用于存储 SAP HANA 备份目录的备份的目录；确保此目录有足够的空间来存储备份。

   

验证基于 Backint 的备份和恢复的设置

您可以验证是否已正确设置 Google Cloud 代理，以便为 SAP HANA 系统执行基于 Backint 的备份和恢复。您可以通过运行代理的 status 命令来执行此验证，该命令从代理 3.7 版开始受支持。

为此，请完成以下步骤：

1. 与 Compute Engine 实例或裸金属解决方案服务器建立 SSH 连接。

2. 运行以下命令：

   sudo /usr/bin/google_cloud_sap_agent status -b="BACKINT_PARAM_FILE_PATH"
   

   如果您为基于 Backint 的备份和恢复设置的 Google Cloud 设置正确，则输出包含以下内容。您的配置将为与 Backint 相关的配置参数提供不同的值。

   Agent Status:
       ...
       Systemd Service Enabled: True
       Systemd Service Running: True
       Cloud API Full Scopes: True
       Configuration File: /etc/google-cloud-sap-agent/configuration.json
       Configuration Valid: True
   ...
   ----------------------------------------------------------------------------
   Backint: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           bucket:           my-bucket                                                           (configuration file)
           log_to_cloud:     true                                                                (default)
           parallel_streams: 16                                                                  (configuration file)
           param_file:       /usr/sap/NS1/SYS/global/hdb/opt/backint/backint-gcs/parameters.json (configuration file)
           threads:          32                                                                  (configuration file)
   ...

验证备份和恢复

启用 Google Cloud的 Agent for SAP 的 Backint 功能后，请务必通过在测试系统中创建和恢复备份来验证此功能。

如需进行测试，您可以使用代理的内置自身诊断工具。您的文件系统中至少需要有 18 GB 的可用磁盘空间才能运行此内置工具。如需使用此内置工具验证备份和恢复，请运行以下命令：

sudo /usr/bin/google_cloud_sap_agent backint -u=IDENTIFIER -p=PATH_TO_PARAMETERS_FILE -f=diagnose

替换以下内容：

• IDENTIFIER：可标识命令执行的值。此标识符用于命名在执行诊断时在 Cloud Storage 存储桶中创建的临时文件夹。
• PATH_TO_PARAMETERS_FILE：PARAMETERS.json 文件的路径

使用此工具时，您可以使用可选参数 diagnose_file_max_size_gb 和 diagnose_tmp_directory。如需详细了解这些参数，请参阅配置参数中这些参数的说明。

如果您在主机上安装了 Backint 代理，则首次使用 Google Cloud的 Agent for SAP 执行备份操作时，Google Cloud的 Agent for SAP 会创建 JSON 版本的文本配置文件。如需了解详情，请参阅从 Backint 代理升级。

示例配置文件

以下是 Google Cloud的 Agent for SAP 的 Backint 功能的已完成 PARAMETERS.json 配置文件：

{
  "bucket": "example-bucket-backup",
  "recovery_bucket": "example-bucket-recovery",
  "parallel_streams": 8,
  "service_account_key": "path/to/key/file.json",
  "rate_limit_mb": 100,
  "log_to_cloud": true,
  "log_level": "DEBUG"
}

配置参数

下表说明了Google Cloud的 Agent for SAP 的特定于 Backint 功能的配置参数。

如需了解 Backint 代理的配置参数与 Google Cloud的 Agent for SAP 之间的映射，请参阅配置参数映射。

如需了解 Google Cloud的 SAP for Agent 的配置参数（包括与指标收集相关的参数），请参阅适用于您的场景的安装指南。

{
  "bucket": "example-bucket-backup",
  "metadata": {"key1": "value1", "key2": "value2"},
  "log_to_cloud": true
}

{
  "bucket": "example-bucket-backup",
  "custom_time": "UTCNow+30d",
  "log_to_cloud": true
}

{
  "bucket": "example-bucket-backup",
  "custom_time": "2024-06-25T13:25:00Z",
  "log_to_cloud": true
}

问题排查

如需排查Google Cloud的 Agent for SAP 3.8 版（最新版）的问题，请参阅Google Cloud的 Agent for SAP 问题排查指南。

获取支持

如果您在解决 Google Cloud的 Agent for SAP 的问题时需要帮助，请收集所需的诊断信息并与 Cloud Customer Care 团队联系。如需了解详情，请参阅适用于 SAP HANA 的Google Cloud的 Agent for SAP 诊断信息。

后续步骤

• 如需了解如何创建基于 Backint 的备份并使用这些备份恢复 SAP HANA 数据库，请参阅使用 Backint 备份和恢复 SAP HANA。