本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 安装和配置 SAP HAN Amazon A 的 Backint Agent
安装和配置

本节提供的信息可帮助您使用 Syst Amazon ems Manager 文档或 Amazon Backint 安装程序安装 Amazon Backint 代理。它还提供了帮助您配置代理、查看日志和获取当前代理版本的信息。

**Topics**
+ [

## 使用 Syst Amazon ems Manager 文档安装 Amazon Backint 代理
](#install_shared_aws_backint_agent_using_the_shared_aws_systems_manager_document)
+ [

## 使用 Amazon Backint 安装程序安装 Amazon Backint 代理 — 交互模式
](#install_shared_aws_backint_agent_using_shared_aws_backint_installer_8201_8212_8201_interactive_mode)
+ [

## 使用 Amazon Backint 安装程序安装 Amazon Backint 代理 — 静默模式
](#aws-backint-agent-installer-silent)
+ [

## 在 B Amazon ackint 代理中使用代理地址
](#aws-backint-agent-sap-hana-proxy)
+ [

## Backint 相关的 SAP HANA 参数
](#aws-backint-agent-sap-hana-parameters)
+ [

## 修改 Amazon Backint 代理配置参数
](#aws-backint-agent-modifying-config)
+ [

## 将 SAP HANA 配置为对数据和日志备份使用其他 Amazon S3 存储桶和文件夹
](#configure-sap-hana-to-use-different-amazon-s3-bucket-and-folder-for-data-and-log-backup)
+ [

## 将 SAP HANA 配置为对目录备份使用其他 Amazon S3 存储桶和文件夹
](#configure-sap-hana-to-use-different-amazon-s3-bucket-and-folder-for-catalog-backup)
+ [

## 将 Amazon Backint 代理配置为使用较短的 Amazon S3 路径
](#configure-aws-backint-agent-to-use-shorter-amazon-s3-paths)
+ [

## 查看 Amazon Backint 代理日志
](#aws-backint-agent-view-logs)
+ [

## 获取当前安装的 Amazon Backint 代理版本
](#aws-backint-agent-latest-version)
+ [

## 更新到最新版本或安装先前版本的 Amazon Backint 代理
](#update_to_the_newest_version_or_install_a_previous_version_of_shared_aws_backint_agent)
+ [

## 性能优化
](#aws-backint-agent-performance-tuning)
+ [

## 订阅 Amazon Backint 代理通知
](#aws-backint-agent-sns)

## 使用 Syst Amazon ems Manager 文档安装 Amazon Backint 代理


使用以下步骤使用 Amazon SSM 文档安装 Amazon Backint 代理。

**重要**  
在继续安装之前，禁用任何现有备份过程（包括计划日志备份）。如果在运行 SSM 文档之前没有禁用现有备份过程，则可能会损坏正在进行的备份，这会影响您恢复数据库的能力。

1. 在 Amazon 管理控制台中，选择 “**管理和治****理” 下的 System** s Manager，或者`Systems Manager`在 “**查找服务**” 搜索栏中输入。

1. 从 Systems Manager 控制台中，选择左侧导航窗格的**共享资源**下的**文档**。

1. 在“文档”页面上，选择**归 Amazon 所有**选项卡。您应该会看到一个名为 ** Amazon SAP-** 的文档InstallBackint。

1. 选择 S ** Amazon AP InstallBackint** 文档，然后选择 “**运行” 命令**。

1. 在命令参数下，输入以下内容

   1.  **存储桶名称**。输入要存储 SAP HANA 备份文件的 Amazon S3 存储桶的名称。

   1.  **存储桶文件夹**。或者，输入要存储 SAP HANA 备份文件的 Amazon S3 存储桶内的文件夹的名称。

   1.  **系统 ID**。输入您的 SAP HANA 系统 ID，例如 `HDB`。

   1.  **存储桶区域**。输入您要存储 SA **P HANA 备份文件**的 Amazon S3 存储桶 Amazon 区域。 Amazon Backint 代理支持跨区域和跨账户备份。您必须提供 Amazon 地区和 Amazon S3 存储桶拥有者账户 ID 以及 Amazon S3 存储桶名称，代理才能成功执行。

   1.  **存储桶拥有者账户 ID**。输入要存储 SAP HANA 备份文件的 Amazon S3 存储桶的账户 ID。

   1.  **KMS 密钥**。输入 Amazon KMS 的 ARN， Amazon Backint 代理可以用它来加密存储在您的 Amazon S3 存储桶中的备份文件。

   1.  **安装目录**。输入要安装 B Amazon ackint 代理的目录位置的路径。避免使用 `/tmp` 作安装路径。

   1.  **代理版本**。输入要安装的代理的版本号。如果不输入版本号，则会安装代理的最新发布版本。
**注意**  
1.0 版本已在中国（北京和宁夏）区域推出。

   1.  **修改全局 ini 文件**。选择修改 `global.ini` 文件的方式。必须更新 SAP HANA 系统数据库的 `global.ini` 文件才能完成设置。

      1.  “modify”– SSM 将直接更新 `global.ini` 文件。

      1.  “sql”– SSM 将创建一个包含 SQL 语句且名为 `modify_global_ini.sql` 的文件，您可以在目标 SAP HANA 系统中运行该文件来设置所需的参数。您可以在 `<installation directory>/aws-backint-agent/` 文件夹中找到 `modify_global_ini.sql` 文件。

      1.  “none”– SSM 不会执行任何操作来修改 `global.ini` 文件。您必须手动更新它才能完成设置。

   1.  **忽略存储桶检查**。选择**是**可忽略 S3 存储桶的健全性检查。S3 存储桶健全性检查将验证以下几点：
      + 存储桶存在于您的账户中
      + 存储桶区域正确
      + 存储桶是公有的

   1.  **调试模式**。选择**是**可激活调试模式。

   1.  **重要提示！确保没有正在进行的备份**。选择**是**以确认您已禁用现有备份并准备好继续安装。**如果选择了“否”，SSM 文档将失败。**

1. 在 “**目标**” 下，选择目标实例用于安装 Amazon Backint 代理的方法，然后选择要安装该代理的实例。如果您无法在列表中找到您的实例，请核实您是否遵循了[先决条件](aws-backint-agent-s3-prerequisites.md)中的所有步骤。

1. 在**其他参数**下，将字段留空，然后选择**运行**。
**重要**  
如果您没有安装 SSM 代理的最新版本（2.3.274.0 或更高版本），则 **Run Command** 将无法执行。

1. 成功安装代理后，您将在**命令 ID** 下看到**成功**状态。

1. 要验证安装，请登录到您的实例并查看 `/<install directory>/aws-backint-agent` 目录。您应该在目录中看到以下文件： Amazon Backint 代理二进制`THIRD_PARTY_LICENSES.txt`文件、包含代理所用库许可证的文件、启动器脚本、YAML 配置文件和可选`modify_global_ini.sql`文件。此外， Amazon Backint 代理的源文件 (`aws-backint-agent.tar.gz`) 存储在软件包目录中。您可以验证此文件的签名，以确保下载的源文件为原始文件且未修改。有关详细信息，请参阅本文档[中的验证 SAP HANA 的 Amazon Backint 代理和安装程序的签名](aws-backint-agent-signature.md)部分。

   SSM 文档在 SAP HANA 全局目录中为 Backint 配置创建符号链接 (symlink)。确定 `/usr/sap/<SID>/SYS/global/hdb/opt` 目录中存在 `hdbbackint` 的符号链接，且 `/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig` 目录中存在 `aws-backint-agent-config.yaml` 的符号链接。

## 使用 Amazon Backint 安装程序安装 Amazon Backint 代理 — 交互模式


安装 Amazon Backint 代理的另一种方法是使用 B Amazon ackint 安装程序。您可以从亚马逊 S3 存储桶下载 Amazon Backint 安装程序。

对于中国（北京），存储桶名称为 `s3://awssap-backint-agent-cn-north-1`。

对于中国（宁夏），存储桶名称为 `s3://awssap-backint-agent-cn-northwest-1`。

对于中国（北京），您可以随时在 `s3://awssap-backint-agent-cn-north-1/binary/latest/install-aws-backint-agent` 中找到最新安装程序。

对于中国（宁夏），您可以随时在 `s3://awssap-backint-agent-cn-northwest-1/binary/latest/install-aws-backint-agent` 中找到最新安装程序。

按照以下步骤在 SAP HANA Amazon 实例上使用 SSH 会话中的 Amazon Backint 安装程序安装 Backint 代理。

**重要**  
在继续安装之前，禁用任何现有备份过程（包括计划日志备份）。如果在运行 Back Amazon int 代理安装程序之前未禁用现有备份进程，则可能会损坏正在进行的备份，这可能会影响恢复数据库的能力。

1. 导航到 `/tmp`（或保存已下载安装程序的另一个临时目录）。

   ```
   $ cd /tmp
   ```

1. 运行以下命令之一下载安装程序。

    **中国（北京）** 

   ```
   $ sudo aws s3 cp s3://awssap-backint-agent-cn-north-1/binary/latest/install-aws-backint-agent /tmp/ --region cn-north-1
   ```

   ```
   $ sudo wget https://awssap-backint-agent-cn-north-1.s3.cn-north-1.amazonaws.com.cn/binary/latest/install-aws-backint-agent -O /tmp/install-aws-backint-agent
   ```

    **中国（宁夏）** 

   ```
   $ sudo aws s3 cp s3://awssap-backint-agent-cn-northwest-1/binary/latest/install-aws-backint-agent /tmp/ --region cn-northwest-1
   ```

   ```
   $ sudo wget https://awssap-backint-agent-cn-northwest-1.s3.cn-northwest-1.amazonaws.com.cn/binary/latest/install-aws-backint-agent -O /tmp/install-aws-backint-agent
   ```
**注意**  
如果您在使用 Amazon CLI 下载 Amazon Backint 安装程序时遇到权限问题，请检查您的 IAM 策略并确保您的策略允许从`awssap-backint-agent`存储桶下载对象。有关详细信息，请参阅本文档的[身份和访问管理](aws-backint-agent-s3-prerequisites.md#aws-backint-agent-iam)部分。

1. 使用 `-h` 标志运行安装程序以查找所有可用选项。

   ```
   $ sudo python install-aws-backint-agent -h
   ```

1. 运行以下命令以执行安装程序。

   ```
   $ sudo python install-aws-backint-agent
   ```
**注意**  

   ```
   Run the installer with the `-l` flag if you want the installer to get the {aws} Backint agent binary file from your own file system or Amazon S3 bucket. Specify the location of the [path]``aws-backint-agent.tar.gz`` file.
   ```

   ```
   $ sudo python install-aws-backint-agent -l /tmp/backint/aws-backint-agent.tar.gz
   ```

   ```
   $ sudo python install-aws-backint-agent -l s3://<S3 bucket>/aws-backint-agent.tar.gz
   ```

   ```
   $ sudo python install-aws-backint-agent -l https://<S3 bucket>.s3.amazonaws.com/aws-backint-agent.tar.gz
   ```

1. 输入以下参数的信息。

   1.  **安装目录**-输入要安装 Amazon Backint 代理的目录位置的路径。安装目录的默认值为 `/hana/shared/`。

   1.  **Amazon S3 存储桶所有者** – 输入要存储 SAP HANA 备份文件的存储桶的 Amazon S3 存储桶所有者的账户 ID。

   1.  **亚马逊 S3 存储桶区域**-输入您要存储 SAP HANA 备份文件的亚马逊 S3 存储桶 Amazon 区域。

   1.  **Amazon S3 存储桶名称** – 输入要存储 SAP HANA 备份文件的 Amazon S3 存储桶的名称。

   1.  **S3 存储桶中的文件夹** – 输入要存储 SAP HANA 备份文件的 Amazon S3 存储桶中的文件夹的名称。此参数为可选的。

   1.  **Amazon S3 SSE KMS ARN** — 输入 Amazon Backint 代理可以用来加密存储在 Amazon S3 存储桶中的备份文件的 Amazon KMS 的 ARN。
**注意**  
如果您将此字段留空， Amazon Backint 安装程序将提示您确认您不想使用存储在 Amazon KMS 中的加密密钥对备份文件进行加密。如果您不确认您不想使用 kms-key 进行加密，安装程序将中止。我们强烈建议您对数据进行加密。

   1.  **SAP HANA 系统 ID** – 输入您的 SAP HANA 系统 ID，例如 `HDB`。

   1.  **HANA opt 目录** – 确认 SAP HANA opt 目录的位置。

   1.  **修改 global.ini [modify/sql/[none]]** – 选择修改 `global.ini` 文件的方式。必须更新 SAP HANA 系统的 `global.ini` 文件才能完成设置。

      1.  “修改” —Amazon Backint 安装程序将直接更新`global.ini`文件。

      1.  “sql” —Amazon Backint 安装程序将创建一个名为 `modify_global_ini.sql` SQL 语句的文件，你可以在目标 SAP HANA 系统中运行该文件来设置所需的参数。您可以在 `<installation directory>/aws-backint-agent/` 文件夹中找到 `modify_global_ini.sql` 文件。

      1.  “none” — Amazon Backint 安装程序不会采取任何操作来修改`global.ini`文件。您必须手动更新它们才能完成设置。

   1.  **HANA 系统数据库 global.ini 文件** – 确认 `global.ini` 文件的位置。

   1.  **验证代理二进制 `–0—tar` 文件的签名** – 
      + 选择`y`验证 Amazon Backint 代理源文件的签名。如果您选择了 `y`，请输入代理二进制 `–0—tar` 文件的签名文件的 Amazon S3 存储桶位置，例如 `https://s3.amazonaws.com/awssap-backint-agent/binary/latest/aws-backint-agent.sig`。或者，提供存储在实例上的本地文件。如果未进行选择就继续操作，则会使用方括号（[]）中列出的默认位置。
      + `n`如果您不想验证 Amazon Backint 代理源文件的签名，请选择此选项。

   1.  **保存回复以备将来使用？** — 您可以将 Amazon Backint 安装程序的信息保存到文件中。如果需要，您可以稍后使用它以静默模式运行安装程序。

   1.  **是否要继续安装？**– 确认您已禁用现有备份并准备好继续安装。

1. 要验证安装，请登录到您的实例并查看 `/<install directory>/aws-backint-agent` 目录。您应该在目录中看到以下文件： Amazon Backint 代理二进制`THIRD_PARTY_LICENSES.txt`文件、包含代理所用库许可证的文件、启动器脚本、YAML 配置文件和可选`modify_global_ini.sql`文件。此外， Amazon Backint 代理的源文件 (`aws-backint-agent.tar.gz`) 存储在软件包目录中。您可以验证此文件的签名，以确保下载的源文件为原始文件且未修改。有关详细信息，请参阅本文档[中的验证 SAP HANA 的 Amazon Backint 代理和安装程序的签名](aws-backint-agent-signature.md)部分。

   此外， Amazon Backint 安装程序还会在 SAP HANA 全局目录中为 Backint 配置创建符号链接（符号链接）。确定 `/usr/sap/<SID>/SYS/global/hdb/opt` 目录中存在 `hdbbackint` 的符号链接，且 `/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig` 目录中存在 `aws-backint-agent-config.yaml` 的符号链接。
**注意**  
如果由于验证错误而导致安装失败，并且您希望忽略验证并继续安装，则可以使用 `-n` 标志执行安装程序以忽略验证步骤。您还可以使用 `-d` 标志在调试模式下运行安装程序，生成详细的安装日志以进行故障排除。

## 使用 Amazon Backint 安装程序安装 Amazon Backint 代理 — 静默模式


您可以使用 Amazon Backint 安装程序在静默模式下安装 Amazon Backint 代理。如果您希望自动执行安装过程而无需手动干预，请选择此选项。

要在静默模式下运行 Amazon Backint 安装程序，请创建一个包含所有必需安装参数的响应文件。按照中的步骤下载 Amazon Backint 安装程序并创建响应文件。您无需确认即可在交互模式下继续安装 Amazon Backint 代理。 Amazon Backint 安装程序将创建一个名`aws-backint-agent-install-YYYYMMDDHHMMSS.rsp`为的响应文件。

当您有一个响应文件时，您可以使用 vim 编辑器修改它，并根据需要调整参数。

下面是一个示例响应文件。

```
[DEFAULT]
s3_bucket_name = <S3 bucket>
s3_bucket_owner_account_id = 111122223333
modify_global_ini = sql
s3_bucket_region = <us-east-1>
s3_sse_kms_arn = arn:aws:kms:<us-east-1>:111122223333:key/1abcd9b9-ab12-1a2a-1abc-12345abc12a3
s3_bucket_folder = myfolder
hana_sid = TST
installation_directory = /hana/shared/
```

如果要以编程方式生成响应文件，而不是在交互模式下使用 Amazon Backint 安装程序，则可以使用该`-g`标志生成新的响应文件。以下是如何使用 B Amazon ackint 安装程序生成响应文件的示例。

```
$ sudo python install-aws-backint-agent -g "s3_bucket_owner_account_id = 111122223333,s3_bucket_name = <S3 bucket>,s3_bucket_region = <us-east-1>,hana_sid = TST,s3_sse_kms_arn = arn:aws:kms:<us-east-1>:111122223333:key/1abcd9b9-ab12-1a2a-1abc-12345abc12a3,s3_bucket_folder = myfolder,installation_directory = /hana/shared/,modify_global_ini = sql" -f myresponse.rsp
```

创建响应文件后，使用以下步骤在静默模式下运行 Amazon Backint 安装程序。

**重要**  
在继续安装之前，禁用任何现有备份过程（包括计划日志备份）。如果在运行 Back Amazon int 代理安装程序之前未禁用现有备份进程，则可能会损坏正在进行的备份，这可能会影响恢复数据库的能力。

运行以下命令，使用生成的响应文件执行安装程序。

```
$ sudo python install-aws-backint-agent -m silent -f backint-agent-install-YYYYMMDDHHMMSS.rsp -a yes
```

如果要选择安装代理的位置，请运行带有 `-l` 标志的命令并指定位置。

```
$ sudo python install-aws-backint-agent -f aws-backint-agent-install-YYYYMMDDHHMMSS.rsp -m silent -a yes -d -l /tmp/backint/aws-backint-agent.tar.gz
```

**注意**  
您必须确认已禁用现有备份，并已准备好通过传递确认标志 (`-a yes`) 在静默模式下继续安装。如果您未通过确认标志， Amazon Backint 安装程序将无法执行。

## 在 B Amazon ackint 代理中使用代理地址


如果您在安装代理时在 SAP HANA 环境中使用代理地址，则必须使用以下 shell 脚本安装代理，以确保 Amazon Backint 代理安装程序使用正确的代理设置。

```
#!/bin/bash
export https_proxy=<PROXY_ADDRESS>:<PROXY_PORT>
export HTTP_PROXY=<PROXY_ADDRESS:PROXY_PORT>
export no_proxy=169.254.169.254
export NO_PROXY=169.254.169.254
sudo python install-aws-backint-agent
```

如果您在 SAP HANA 环境中使用代理地址，则必须更新位于 Amazon Backint 代理安装目录中的`aws-backint-agent-launcher.sh`文件（例如`/hana/shared/aws-backint-agent/`）。您必须执行以下更新，以确保 Amazon Backint 代理在备份和还原操作期间使用正确的代理设置。

向 `aws-backint-agent-launcher.sh` 脚本添加 `http_proxy`、`HTTP_PROXY`、`no_proxy` 和 `NO_PROXY` 变量。务必使用 `no_proxy` 变量排除 `169.254.169.254` 地址。如果不排除此地址， Amazon Backint 代理发出的实例元数据服务调用将失败，并在备份和还原操作期间导致错误。有关实例元数据和用户数据的更多信息，请参阅 *Amazon Linux 实例 EC2 用户指南中的实例*[元数据和](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)用户数据。

```
#!/bin/bash
export https_proxy=<PROXY_ADDRESS>:<PROXY_PORT>
export HTTP_PROXY=<PROXY_ADDRESS>:<PROXY_PORT>
export no_proxy=169.254.169.254
export NO_PROXY=169.254.169.254
/hana/shared/aws-backint-agent/aws-backint-agent "$@"
```

## Backint 相关的 SAP HANA 参数


要使用 Amazon Backint 代理启用 SAP HANA 备份，您必须设置以下 SAP HANA 参数。如果您为`global.ini`文件更新选择了 “修改” 选项，SSM 文档或 Amazon Backint 安装程序会在系统数据库中`global.ini`添加或更新以下与 SAP HANA 备份相关的参数。如果选择了“sql”，则可以运行 `modify_global_ini.sql` 文件中指定的 SQL 语句来更新这些参数。有关这些参数的更多详细信息，请参阅《SAP HANA 管理指南》**中的[备份配置参数](https://help.sap.com/viewer/6b94445c94ae495c83a19646e7c3fd56/2.0.03/en-US/c1eb6ff410f946318dae539cb3d33f9f.html)。

```
[backup]
catalog_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
data_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
log_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
catalog_backup_using_backint = true
log_backup_using_backint = true
parallel_data_backup_backint_channels = 8
data_backup_buffer_size = 4096
max_recovery_backint_channels = 1
[communication]
tcp_backlog = 2048
[persistence]
enable_auto_log_backup = yes
verify_signature = yes
input_signature_filepath = https://s3.amazonaws.com/awssap-backint-agent/binary/latest/aws-backint-agent.sig
```

**注意**  
更改 `tcp_backlog` 参数需要重新启动 SAP HANA 才能生效。  
 `max_recovery_backint_channels`确定恢复过程中并 restored/recovered 行日志文件的数量。恢复多流备份时，SAP HANA 始终使用与备份过程相同的通道数。有关更多详细信息，请参阅 SAP 文档中的[使用第三方备份工具进行多流数据备份](https://help.sap.com/viewer/6b94445c94ae495c83a19646e7c3fd56/2.0.02/en-US/9159de1e829740908e0ba022f8e8d1b0.html)。

## 修改 Amazon Backint 代理配置参数


 Amazon Backint 代理配置参数保存在目录下的 YAML 文件中。`/<installation directory>/aws-backint-agent/`配置文件的名称是 `aws-backint-agent-config.yaml`。下表汇总了在 Amazon Backint 代理安装过程中添加的配置参数，以及您可以添加或更改的其他参数。

 **在初始设置期间添加到 `aws-backint-agent-config.yaml` 的参数** 


| 参数的名称 | 说明 | 默认 值 | 
| --- | --- | --- | 
|   `S3BucketName`   |  用于存储 SAP HANA 备份文件的 Amazon S3 存储桶的名称。例如 `amzn-s3-demo-bucket`。  |  不适用  | 
|   `S3BucketAwsRegion`   |   Amazon 您的亚马逊 S3 存储桶所在的区域。例如 `us-east-1`。  |  不适用  | 
|   `S3BucketFolder`   |  用于存储 SAP HANA 备份文件的 Amazon S3 存储桶中的文件夹的名称。例如 `my-folder`。  |  空  | 
|   `S3BucketOwnerAccountID`   |  Amazon S3 存储桶所有者的 12 位账户 ID。例如 `111122223333`。  |  不适用  | 
|   `LogFile`   |   Amazon Backint 代理日志文件的位置。  |   `/hana/shared/aws-backint-agent/aws-backint-agent.log`   | 
|   `S3SseKmsArn`   |   Amazon Backint 代理可用于加密存储在 Amazon S3 中的备份文件的 kms-key 的 ARN。例如 `arn:aws:kms:<us-east-1>: 111122223333:key/5bfbc9b9-ab12-ab12-a123-11111xxx22xx`。  |  空  | 
|   `S3SseEnabled`   |  指定是否启用 KMS 加密。  |  如果 `S3SseKmsArn` 参数为空，则设置为 `false`。否则，设置为 `true`。  | 

 **可以添加到 `aws-backint-agent-config.yaml` 文件以更新默认值的参数** 


| 参数的名称 | 说明 | 默认 值 | 支持的起始版本 | 
| --- | --- | --- | --- | 
|   `BackupObjectTags`   |  启用对其他 S3 对象标签的支持。  要使用 `BackupObjectTags`，必须将 `EnableTagging` 设置为 `true`。 允许的值：必须是使用以下语法的有效 JSON 字符串： <pre>-BackupObjectTags: "[{Key=string,Value=string},{Key=string,Value=string},...]</pre> 有关适用的标签限制，请参阅《*Amazon EC2 用户指南*》中的[标签限制](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions)。  |  不适用  |  版本 1.03  | 
|   `EnableTagging`   |  启用或禁用 S3 中存储的备份文件的默认对象标记。标记有助于识别 Amazon 备份期间使用的 Backint 版本和 SAP HANA 版本。 允许的值：`true` 或 `false`。  |   `true`   |  版本 1.03  | 
|   `LogLevel`   |  指定代理日志的日志记录级别。 允许的值：`info` 或 `debug`。  |   `info`   |  版本 1.0  | 
|   `LogRotationFrequency`   |  指定 `aws-backint-agent.log` 文件轮换频率。 允许的值：`minute`、`hour`、`day` 或 `never`。  |   `never`   |  版本 1.03  | 
|   `S3StorageClass`   |  指定 Amazon Backint 代理在存储备份文件时可以使用的 S3 存储类类型。 允许的值：`STANDARD`、`STANDARD_IA`、`ONEZONE_IA` 或 `INTELLIGENT_TIERING`。  |   `STANDARD`   |  版本 1.0（自 1.05 版本起推出的 Intelligent-Tiering）  | 
|   `UploadConcurrency`   |  指定备份期间可以并行运行的 Amazon S3 线程数。 允许的值：`1` 至 `200`。  |   `100`   |  版本 1.0  | 
|   `UploadChannelSize`   |  指定备份期间可与 S3 存储桶并行上传的文件数。 允许的值：`1` 至 `32`。  |   `10`   |  版本 1.0  | 
|   `MaximumConcurrentFilesForRestore`   |  指定还原期间可从 S3 并行下载的文件数。 允许的值：`1` 至 `32`。  |   `5`   |  版本 1.0  | 
|   `S3ShortenBackupDestinationEnabled`   |  指定是否使用较短的 Amazon S3 路径。 允许的值：`true` 或 `false`。  |   `false`   |  版本 1.05  | 
|   `DownloadConcurrency`   |  指定还原期间可以并行运行的 Amazon S3 线程数。 允许的值：`1` 至 `200`。  |   `100`   |  版本 1.0  | 

## 将 SAP HANA 配置为对数据和日志备份使用其他 Amazon S3 存储桶和文件夹


 Amazon 默认情况下，Backint 代理对数据和日志备份使用相同的参数。它将数据和日志备份存储在同一 Amazon S3 存储桶和文件夹中。

```
data_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
log_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
```

要对数据和日志备份使用其他 Amazon S3 存储桶和文件夹，请执行以下步骤。

1.  **检查 SAP HANA 备份参数** 

   创建 `data_backup_parameter_file` 和 `log_backup_parameter_file` 参数。这些参数的默认值应该为 `/<installation directory>/aws-backint-agent/aws-backint-agent-config.yaml`。如果您看不到此默认值，请检查配置文件以确认其显示的 Amazon S3 位置相同。

1.  **保留对存储在先前 Amazon S3 位置的日志备份的访问权限** 

   如果这是新设置或者您不想保留之前的日志备份，请跳过此步骤并继续执行步骤 3。

   将源类型为 `volume` 的先前日志备份移动到新的 Amazon S3 位置，该位置仅用于日志备份。您可以通过运行以下 SQL 命令来确认源类型。

   ```
   select SOURCE_TYPE_NAME, DESTINATION_PATH from M_BACKUP_CATALOG_FILES
   ```

   系统将按照以下格式为备份目录指定名称：`log_backup_0_0_0_0.<BackupID>`。这种类型的备份由其他 SAP HANA 参数管理，具有源类型 `catalog`，并且应保留在数据备份位置。此文件包含备份目录文件，其中存储了所有备份的历史记录。只有源类型为 `volume` 的日志备份才应移动到新的 Amazon S3 位置。要更改 Amazon S3 目录备份位置，请参阅[将 SAP HANA 配置为对目录备份使用其他 Amazon S3 存储桶和文件夹](#configure-sap-hana-to-use-different-amazon-s3-bucket-and-folder-for-catalog-backup)。

   下表提供了系统数据库文件夹结构的示例：    
[\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/sap/latest/sap-hana/aws-backint-agent-s3-installing-configuring.html)

   下表提供了租户数据库文件夹结构的示例：    
[\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/sap/latest/sap-hana/aws-backint-agent-s3-installing-configuring.html)
**注意**  
在执行步骤 a 和 b 之前，请确保没有正在运行的备份进程。

   1.  **更改系统数据库的日志备份位置** 

      运行以下命令以移动系统数据库日志的卷类型。在这个示例中，我们使用了相同的 Amazon S3 存储桶，但为日志备份创建了另一个文件夹。

      ```
      # Create the folder structure
      aws s3api put-object --bucket <S3 bucket> --key <S3 folder for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --region <us-east-1>
      
      # Execute a Dry Run to check
      aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ s3://<S3 bucket>/<S3 folder for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "*" --include "log_backup_1_0*" --recursive --dryrun --region <us-east-1>
      
      # Run the command to move the logs to the new S3 location
      aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ s3://<S3 bucket>/<S3 folder for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "*" --include "log_backup_1_0*" --recursive --region <us-east-1>
      
      # Check the output of the S3 location for logs
      aws s3 ls s3://<S3 bucket>/<S3 folder for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --region <us-east-1>
      ```

   1.  **更改租户数据库的日志备份位置** 

      运行以下命令以移动租户数据库日志的卷类型。在这个示例中，我们使用了相同的 Amazon S3 存储桶，并为日志备份创建了另一个文件夹。您需要为每个租户数据库重复此步骤。

      ```
      # Create the folder structure
      aws s3api put-object --bucket <S3 bucket> --key <S3 folder for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --region <us-east-1>
      
      # Execute a Dry Run
      aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ s3://<S3 bucket>/<S3 bucket for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include "log_backup_2_0" --include "log_backup_3_0" --recursive --dryrun --region <us-east-1>
      
      # Run the command to move the logs to the new S3 location
      aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ s3://<S3 bucket>/<S3 bucket for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include "log_backup_2_0" --include "log_backup_3_0" --recursive --region <us-east-1>
      
      # Check the output of the S3 location for logs
      aws s3 ls s3://<S3 bucket>/<S3 bucket for logs>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --region <us-east-1>
      ```

1.  **创建 `aws-backint-agent-config-logs.yaml` 参数文件** 

   1. 复制现有 Amazon Backint 代理配置以进行日志备份。

      ```
      $ cp /hana/shared/aws-backint-agent/aws-backint-agent-config.yaml /hana/shared/aws-backint-agent/aws-backint-agent-config-logs.yaml
      ```

   1. 使用您的首选编辑器在 `aws-backint-agent-config-logs.yaml` 中修改 `S3BucketName`、`S3BucketFolder` 和 `LogFile` 参数。

      ```
      S3BucketName: "<Amazon S3 bucket for SAP HANA logs>"
      S3BucketFolder: "<Amazon S3 folder for SAP HANA logs>"
      LogFile: "/hana/shared/aws-backint-agent/aws-backint-agent-logs.log"
      ```

   1. 创建从 `/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/` 到 `/hana/shared/aws-backint-agent/` 的 `hdbbackint` 软链接。

      ```
      $ ln -s /hana/shared/aws-backint-agent/aws-backint-agent-config-logs.yaml /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config-logs.yaml
      ```

1.  更新 `global.ini` 文件 

   使用以下配置更新 `global.ini` 文件。

   ```
   log_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config-logs.yaml
   ```

1.  **为更新运行重新配置** 

   运行 `hdbnsutil -reconfig` 以使更新生效。

1.  **验证以确保所有步骤均已正确完成** 

   1. 运行 point-in-time恢复到之前的状态，确保您可以访问新的 Amazon S3 位置中以前的日志文件。

   1. 验证新日志是否已上传到新的 S3 位置。

1.  **删除之前的备份** 

   验证成功后，我们建议等待至少一周后再删除之前的日志。

   准备就绪后，使用以下命令删除之前的日志。

   ```
   # Delete previous backups in SYSTEMDB
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "" --include "log_backup_1_0" --recursive --dryrun --region <us-east-1>
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "" --include "log_backup_1_0" --recursive --region <us-east-1>
   
   # Delete previous backups in the TENANT database (Repeat for each tenant)
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include --include "log_backup_2_0" --include "log_backup_3_0" --recursive --dryrun --region <us-east-1>
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include "log_backup_2_0" --include "log_backup_3_0" --recursive --region <us-east-1>
   ```

## 将 SAP HANA 配置为对目录备份使用其他 Amazon S3 存储桶和文件夹


 Amazon 默认情况下，Backint 代理对数据、日志和目录备份使用相同的参数。它将备份存储在同一 Amazon S3 存储桶和文件夹中。

```
data_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
log_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
catalog_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config.yaml
```

要对目录备份使用其他 Amazon S3 存储桶和文件夹，请执行以下步骤。

1.  **检查 SAP HANA 备份参数** 

   找到 `data_backup_parameter_file`、`log_backup_parameter_file` 和 `catalog_backup_parameter_file` 参数。这些参数的默认值应该为 `/<installation directory>/aws-backint-agent/aws-backint-agent-config.yaml`。如果您看不到此默认值，请检查配置文件以确认其显示的 Amazon S3 位置相同。

1.  **保留对存储在先前 Amazon S3 位置的日志备份的访问权限** 

   如果这是新设置或者您不想保留之前的目录备份，请跳过此步骤并继续执行步骤 3。

   将源类型为 `catalog` 的先前目录备份移动到新的 Amazon S3 位置，该位置仅用于目录备份。您可以通过运行以下 SQL 命令来确认源类型。

   ```
   select SOURCE_TYPE_NAME, DESTINATION_PATH from M_BACKUP_CATALOG_FILES
   ```

   系统将按照以下格式为备份目录指定名称：`log_backup_0_0_0_0.<BackupID>`。这种类型的备份的源类型为 `catalog`。此文件包含备份目录文件，其中存储了所有备份的历史记录。只有源类型为 `catalog` 的目录备份才应移动到新的 Amazon S3 位置。要更改 Amazon S3 日志备份位置，请参阅[将 SAP HANA 配置为对目录备份使用其他 Amazon S3 存储桶和文件夹](#configure-sap-hana-to-use-different-amazon-s3-bucket-and-folder-for-data-and-log-backup)。

   下表提供了系统数据库文件夹结构的示例：    
[\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/sap/latest/sap-hana/aws-backint-agent-s3-installing-configuring.html)

   下表是租户数据库文件夹结构的示例：    
[\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/sap/latest/sap-hana/aws-backint-agent-s3-installing-configuring.html)
**注意**  
在执行步骤 a 和 b 之前，请确保没有正在运行的备份进程。

   1.  **更改系统数据库的目录备份位置** 

      运行以下命令以移动系统数据库日志的 `catalog` 类型。在这个示例中，我们使用了相同的 Amazon S3 存储桶，但为目录备份创建了另一个文件夹。

      ```
      # Create the folder structure
      aws s3api put-object --bucket <S3 bucket> --key S3 folder for catalog/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --region <us-east-1>
      
      # Execute a Dry Run to check
      aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ s3://<S3 bucket>/<S3 folder for catalog>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "*" --include "log_backup_0_0_0_0*" --recursive --dryrun --region <us-east-1>
      
      # Run the command to move the logs to the new S3 location
      aws s3 cp s3://example-s3-bucket;/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ s3://<S3 bucket>/<S3 folder for catalog>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "*" --include "log_backup_0_0_0_0*" --recursive --region <us-east-1>
      
      # Check the output of the S3 location for logs
      aws s3 ls s3://<S3 bucket>/<S3 folder for catalog>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --region <us-east-1>
      ```

   1.  **更改租户数据库的目录备份位置** 

      运行以下命令以移动租户数据库日志的 `catalog` 类型。在这个示例中，我们使用了相同的 Amazon S3 存储桶，并为目录备份创建了另一个文件夹。您需要为每个租户数据库重复此步骤。

      ```
      # Create the folder structure
      aws s3api put-object --bucket <S3 bucket> --key S3 folder for catalog/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --region <us-east-1>
      
      # Execute a Dry Run
      aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ s3://<S3 bucket>/<S3 bucket for catalog>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include "log_backup_0_0_0_0*" --recursive --dryrun --region <us-east-1>
      
      # Run the command to move the catalog to the new S3 location
      aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ s3://<S3 bucket>/<S3 bucket for catalog>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include "log_backup_0_0_0_0*" --recursive --region <us-east-1>
      
      # Check the output of the S3 location for catalog
      ```

1. 创建 ` aws-backint-agent-config-catalog.yaml ` 参数文件

   1. 复制现有 Amazon Backint 代理配置以进行目录备份。

      ```
      $ cp /hana/shared/aws-backint-agent/aws-backint-agent-config.yaml  /hana/shared/aws-backint-agent/aws-backint-agent-config-catalog.yaml
      ```

   1. 使用您的首选编辑器在 `aws-backint-agent-config-catalog.yaml` 中修改 `S3BucketName`、`S3BucketFolder` 和 `LogFile` 参数。

      ```
      S3BucketName: "Amazon S3 bucket for SAP HANA catalog"
      S3BucketFolder: "Amazon S3 folder for SAP HANA catalog"
      LogFile: "/hana/shared/aws-backint-agent/aws-backint-agent-catalog.log"
      ```

   1. 创建从 `/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/` 到 `/hana/shared/aws-backint-agent/` 的 `hdbbackint` 软链接。

      ```
      $ ln -s /hana/shared/aws-backint-agent/aws-backint-agent-config-catalog.yaml  /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config-catalog.yaml
      ```

1. 更新 ` global.ini ` 文件

   使用以下配置更新 `global.ini` 文件。

   ```
   log_backup_parameter_file = /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/aws-backint-agent-config-logs.yaml
   ```

1. 为更新运行重新配置

   运行 `hdbnsutil -reconfig` 以使更新生效。

1. 验证以确保所有步骤均已正确完成

   1.  point-in-time恢复到之前的状态，确保您可以访问新的 Amazon S3 位置中以前的日志文件。

   1. 验证新日志是否已上传到新的 S3 位置。

1. 删除之前的备份

   验证成功后，我们建议等待至少一周后再删除之前的目录。

   准备就绪后，使用以下命令删除之前的日志。

   ```
   # Delete previous backups in SYSTEMDB
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "" --include "log_backup_0_0_0_0" --recursive --dryrun --region <us-east-1>
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/SYSTEMDB/ --exclude "" --include "log_backup_0_0_0_0" --recursive --region <us-east-1>
   
   # Delete previous backups in the TENANT database (Repeat for each tenant)
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include --include "log_backup_0_0_0_0" --recursive --dryrun --region <us-east-1>
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/DB_<SID>/ --exclude "" --include "log_backup_0_0_0_0" --recursive --region <us-east-1>
   ```

## 将 Amazon Backint 代理配置为使用较短的 Amazon S3 路径


 Amazon Backint 代理使用 SAP HANA 操作系统路径作为备份的默认位置，但您可以将其配置为使用较短的路径。


|  |  | 
| --- |--- |
|  默认路径  |  <SID>s3:////<Amazon-s3-bucket><Amazon-s3-folder><SID>usr/sap///SYS/global/hdb/backint  | 
|  新路径  |  s3://<Amazon-s3-bucket>/<Amazon-s3-folder>/<SID>/  | 

要使用较短的路径，请完成以下步骤。

1. 检查 SAP HANA 备份参数

   找到 `data_backup_parameter_file`、`log_backup_parameter_file` 和 `catalog_backup_parameter_file` 参数。如果您对数据、日志和目录备份使用了相同的参数，则只需在 `aws-backint-agent-config.yaml` 文件中进行此更改。如果您使用了不同的文件，则需要在两个文件中进行这些更改。

1. 保留对存储在先前 Amazon S3 位置的备份的访问权限

   如果这是新设置或者您不想保留之前的目录备份，请跳过此步骤并继续执行步骤 3。

   确保没有正在运行的备份进程，然后运行以下命令将所有之前的备份移动到新的 Amazon S3 位置。此步骤假设您对数据和日志使用了相同的配置参数。下面的示例使用了相同的 S3 存储桶，但您可以使用一个新存储桶。

   ```
   # Execute a Dry Run to check
   aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/ s3://<S3 bucket>/<S3 folder>/<SID>/ --recursive --dryrun --region <us-east-1>
   
   # Run the command to move the backups to new S3 location
   aws s3 cp s3://<S3 bucket>/<S3 folder>/<SID>/usr/sap/<SID>/SYS/global/hdb/backint/ s3://<S3 bucket>/<S3 folder>/<SID>/ --recursive --region <us-east-1>
   
   # Check the output of both S3 location
   aws s3 ls s3://<S3 bucket>/<S3 folder>/<SID>/ --region <us-east-1>
   ```

1. 修改 `aws-backint-agent-config.yaml`。

   ```
   $ vi /hana/shared/aws-backint-agent/aws-backint-agent-config.yaml
   ```

   使用您的首选编辑器在 `aws-backint-agent-config.yaml` 中添加 `S3ShortenDestinationBackupEnabled` 参数。

   ```
   S3ShortenBackupDestinationEnabled: "true"
   ```

1. 验证以确保所有步骤均已正确完成

   1.  point-in-time恢复到之前的状态，确保您可以访问新的 Amazon S3 位置中以前的日志文件。

   1. 验证新日志是否已上传到新的 S3 位置。

1. 删除之前的备份

   验证成功后，我们建议等待至少一周后再删除之前的目录。

   准备就绪后，使用以下命令删除之前的日志。

   ```
   # Execute a Dry Run to make sure
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr --recursive --dryrun --region <us-east-1>
   
   # Run the command to delete it in the previous S3 location
   aws s3 rm s3://<S3 bucket>/<S3 folder>/<SID>/usr --recursive --region <us-east-1>
   
   # Check the output of both S3 location
   aws s3 ls s3://<S3 bucket>/<S3 folder>/<SID>/ --region <us-east-1>
   ```

## 查看 Amazon Backint 代理日志


当 SAP HANA 调用 Amazon Backint 代理进行与备份和还原相关的操作时，日志`aws-backint-agent.log`将写入`<installation_directory>/aws-backint-agent/`文件夹。如果要更改 Amazon Backint 代理日志的位置，可以更新`aws-backint-agent-config.yaml`文件`LogFile`中的参数。

## 获取当前安装的 Amazon Backint 代理版本


要显示 backint 版本及其支持的当前 Amazon Backint 代理版本，请以`<SID>adm`用户身份使用安装目录中的`–v`参数运行`hdbbackint`命令，如下例所示。

```
$ /usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint -v
```

例如，在带有 a `<SID>` s 的系统上运行上述命令会`HDB`返回 Amazon Backint 代理版本为 1.05，如下图所示。

![\[Backint Agent 版本 1.05 的图像。\]](http://docs.amazonaws.cn/sap/latest/sap-hana/images/get-currently-installed-backint-example.png)


```
$ /usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint -v
```

## 更新到最新版本或安装先前版本的 Amazon Backint 代理


 **先决条件** 

在更新代理之前，您必须完成以下任务。
+ 禁用计划数据备份，因为这些备份可能会在版本更新期间失败。
+ 从 SAP HANA 控制台、SAP HANA Studio 或通过 SQL 命令停止日志备份。

 **使用安装方法进行更新** 

可以在以下 S3 存储桶位置找到安装程序的最新版本和先前版本。
+  *针对中国（北京）的最新版本* – `s3://awssap-backint-agent-cn-north-1/binary/latest/install-aws-backint-agent` 
+  针对中国（北京）的*先前版本* – `s3://awssap-backint-agent-cn-north-1/binary/agent-version/install-aws-backint-agent` 
+  *针对中国（宁夏）的最新版本* – `s3://awssap-backint-agent-cn-northwest-1/binary/latest/install-aws-backint-agent` 
+  *针对中国（宁夏）的先前版本* – `s3://awssap-backint-agent-cn-northwest-1/binary/agent-version/install-aws-backint-agent` 

 **使用代理二进制文件进行更新** 

1. 根据您 Amazon 所在的地区，将代理二进制 tar 文件从相关的 Amazon S3 位置下载到临时位置。

   ```
   cd /tmp
   ```

   ```
   $ mkdir agent_download && cd agent_download
   ```

   ```
   $ aws s3 cp s3://awssap-backint-agent/binary/<agent-version>/aws-backint-agent.tar.gz aws-backint-agent.tar.gz --region <us-east-1>
   ```

   可以在以下 S3 存储桶位置找到安装程序的最新版本和先前版本。

    *针对中国（北京）的最新版本* – `s3://awssap-backint-agent-cn-north-1/binary/latest/aws-backint-agent.tar.gz` 

    针对中国（北京）的*先前版本* – `s3://awssap-backint-agent-cn-north-1/binary/agent-version/aws-backint-agent.tar.gz` 

    *针对中国（宁夏）的最新版本* – `s3://awssap-backint-agent-cn-northwest-1/binary/latest/aws-backint-agent.tar.gz` 

    针对中国（宁夏）的*先前版本* – `s3://awssap-backint-agent-cn-northwest-1/binary/agent-version/aws-backint-agent.tar.gz` 

1. 使用以下命令提取二进制文件。

   ```
   $ tar -xf aws-backint-agent.tar.gz
   ```

1. 禁用计划数据和日志备份（如果尚未作为先决条件禁用）。

1. 使用以下命令备份现有代理二进制文件。这是为了确保在需要还原代理版本时有备份。

   ```
   $ cp <INSTALLATION_DIR>/aws-backint-agent/aws-backint-agent <INSTALLATION_DIR>/aws-backint-agent/aws-backint-agent. <mmddyy>
   ```

1. 使用以下命令复制新提取的代理二进制文件。

   ```
   $ cp aws-backint-agent <INSTALLATION_DIR>/aws-backint-agent/aws-backint-agent
   ```

1. 使用以下命令更改所有权和模式。

   ```
   $ cd <INSTALLATION_DIR>/aws-backint-agent
   ```

   ```
   $ chmod 770 aws-backint-agent
   ```

   ```
   $ chown <sid>adm:sapsys aws-backint-agent
   ```

1. 安装或更新完成后，您可以重新启用计划数据备份和日志备份。

有关根据版本适用的[代理配置参数，请参阅修改 Amazon Backin](#aws-backint-agent-modifying-config) t 代理配置参数。

要使用 S Amazon ystems Manager 安装代理，请将**代理版本**留空或输入特定的代理版本，然后按照中的步骤进行操作。

## 性能优化


 Amazon Backint 代理安装时使用默认值，可优化备份和还原操作的性能。如果要进一步优化备份和还原操作的性能，可以调整 `UploadChannelSize` 和 `MaximumConcurrentFilesForRestore` 参数。确保使用正确的实例类型和存储配置，以获得最佳性能。 Amazon Backint 代理受实例中可用资源的限制。

`UploadChannelSize` 参数用于确定备份期间可以将多少个文件并行上传到 S3 存储桶。此参数的默认值为 `10`，它在大多数情况下可提供最佳性能。

`UploadConcurrency` 参数用于确定备份期间可以并行工作的 S3 线程的数量。此参数的默认值为 `100`，它在大多数情况下可提供最佳性能。

`MaximumConcurrentFilesForRestore` 参数用于确定在还原操作期间可以从 S3 并行下载多少个文件。此参数的默认值为 `5`，它为大多数使用案例提供最佳性能。

如果要调整这些参数，可以将它们添加到 `aws-backint-agent-config.yaml` 文件并调整值（最多可达到允许的最大值）。我们强烈建议您在更改后测试备份和恢复操作，以确保不会对您的备份和还原操作以及其他标准操作产生意想不到的影响。

对于非生产服务器和小于 512 GB 的 SAP HANA 实例，您可以降低 Amazon S3 上传和还原参数，以避免数据量 Amazon EBS 吞吐量达到上限。您可以为非生产实例分配较低的参数值。


|  |  | 
| --- |--- |
|   `UploadConcurrency`   |  10  | 
|   `UploadChannelSize`   |  5  | 

在提高参数值以获得最佳备份时间和磁盘使用率之前，您可以测试备份速度和 Amazon EBS 使用情况。有关更多信息，请参阅 [SAP HANA 的存储配置](https://docs.amazonaws.cn/sap/latest/sap-hana/hana-ops-storage-config.html)。

## 订阅 Amazon Backint 代理通知


当新版本 Amazon 的 Backint 代理 Amazon 或 Backint 安装程序发布时，亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 可以通知您。以下过程显示了如何订阅这些通知。

1. 在 v3/home 上打开亚马逊 SNS 控制台。 https://console.aws.amazon.com/sns/

1. 从导航栏的区域选择器中，如果尚未选中**美国东部（弗吉尼亚北部）**，请选择它。您必须选择此区域，因为您订阅的 B Amazon ackint 代理的 SNS 通知仅从该区域生成。

1. 在导航窗格中，选择**订阅**。

1. 选择**创建订阅**。

1. 对于**创建订阅**，请执行以下操作：

   1. 对于 **Topic ARN**，请使用以下 Amazon Resource Name (ARN)：

       `arn:aws:sns:<us-east-1>:464188257626:Amazon-Backint-Agent-Update` 

      对于和区域，请使用 `arn:aws-cn:sns:cn-north-1:476271213511:Amazon-Backint-Agent-Update` 

      对于 Amazon GovCloud （美国东部）和 Amazon GovCloud （美国西部），请使用 `arn:aws-us-gov:sns:us-gov-east-1:516607370456:Amazon-Backint-Agent-Update` 

   1. 对于**协议**，选择**电子邮件**或 **SMS**。

   1. 对于**端点**，输入可用来接收通知的电子邮件地址。如果您选择 **SMS**，请输入区号和号码。

   1. 选择**创建订阅**。

1. 如果选择**电子邮件**，您会收到一封要求确认订阅的电子邮件。打开电子邮件，然后按照说明操作以完成订阅。

   每当发布新版本的 Amazon Backint 代理或 Amazon Backint 安装程序时，我们都会向订阅者发送通知。如果您不希望再收到这些通知，请通过以下步骤取消订阅。

1. 打开 Amazon SNS 控制台。

1. 在导航窗格中，选择 **Subscriptions**。

1. 选择订阅，然后依次选择**操作**、**删除订阅**。当系统提示进行确认时，选择 **Delete**。