你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

配置Azure 应用程序一致性快照工具

项目
10/24/2023

本文介绍如何运行azacsnap -c configure可用于Azure NetApp 文档Azure 应用程序一致性快照工具（AzAcSnap）的命令。

配置文件的命令

可以使用命令为 AzAcSnap azacsnap -c configure 创建或编辑配置文件。命令的选项如下：

--configuration new 创建新配置文件
--configuration edit 编辑现有配置文件
[--configfile <config filename>] （可选参数）允许自定义配置文件名称

默认情况下，配置文件的名称为 azacsnap.json。可以将自定义文件名与参数一起使用 --configfile= （例如， --configfile=<customname>.json）。

以下示例为 Azure 大型实例配置创建配置文件：

azacsnap -c configure --configuration new

Building new config file
Add comment to config file (blank entry to exit adding comments): This is a new config file for AzAcSnap 6
Add comment to config file (blank entry to exit adding comments):
Enter the database type to add, 'hana', 'oracle', or 'exit' (for no database): hana

=== Add SAP HANA Database details ===
HANA SID (e.g. H80): H80
HANA Instance Number (e.g. 00): 00
HANA HDB User Store Key (e.g. `hdbuserstore List`): AZACSNAP
HANA Server's Address (hostname or IP address): testing01
Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n]:

=== Azure NetApp Files Storage details ===
Are you using Azure NetApp Files for the database? (y/n) [n]:

=== Azure Managed Disk details ===
Are you using Azure Managed Disks for the database? (y/n) [n]:

=== Azure Large Instance (Bare Metal) Storage details ===
Are you using Azure Large Instance (Bare Metal) for the database? (y/n) [n]: y
--- DATA Volumes have the Application put into a consistent state before they are snapshot ---
Add Azure Large Instance (Bare Metal) resource to DATA Volume section of Database configuration? (y/n) [n]: y
Storage User Name (e.g. clbackup25): clt1h80backup
Storage IP Address (e.g. 192.168.1.30): 172.18.18.11
Storage Volume Name (e.g. hana_data_soldub41_t250_vol): hana_data_h80_testing01_mnt00001_t020_vol
Add Azure Large Instance (Bare Metal) resource to DATA Volume section of Database configuration? (y/n) [n]: n
--- OTHER Volumes are snapshot immediately without preparing any application for snapshot ---
Add Azure Large Instance (Bare Metal) resource to OTHER Volume section of Database configuration? (y/n) [n]: n

Enter the database type to add, 'hana', 'oracle', or 'exit' (for no database): exit


Editing configuration complete, writing output to 'azacsnap.json'

配置文件的必需值

以下部分提供有关配置文件的数据库部分所需值的详细指导。

向配置添加“SAP HANA 数据库”时，需要以下值：

HANA Server's Address：SAP HANA 服务器的主机名或 IP 地址。
HANA SID：SAP HANA 系统 ID （SID）。
HANA Instance Number：SAP HANA 实例编号。
HANA HDB User Store Key：配置了运行数据库备份的权限的 SAP HANA 用户。
Do you need AzAcSnap to automatically disable/enable backint during snapshot：默认值 n 为（否）。可以将它设置为 y （是）以允许 AzAcSnap 禁用或重新启用 Backint 接口。本文中的 Backint 共存部分更详细地介绍了此选项。
Single node：节点的主机名和 IP 地址。
HSR with STONITH：节点的主机名和 IP 地址。
Scale-out (N+N, N+M)：主节点的当前主机名和 IP 地址。
HSR without STONITH：节点的主机名和 IP 地址。
Multi SID on Single node：承载这些 SID 的节点的主机名和 IP 地址。

Backint 共存

Azure 备份服务为 SAP HANA 提供备用备份工具。可以将数据库和日志备份流式传输到Azure 备份。

某些客户希望将基于 Backint 的流式备份与基于快照的常规备份组合在一起。但是，基于 Backint 的备份会阻止其他备份方法，例如使用基于文件的备份或基于存储快照备份（例如 AzAcSnap）。有关详细信息，请参阅使用 Azure 备份在数据库上运行 SAP HANA 本机客户端备份。

Azure 备份文档描述的过程已通过 AzAcSnap 实现，以便自动执行以下步骤：

强制将日志备份刷新到 Backint。
等待运行备份完成。
禁用基于 Backint 的备份。
将 SAP HANA 置于备份的一致状态。
创建基于存储快照备份。
发布 SAP HANA。
重新启用基于 Backint 的备份。

默认情况下禁用此选项。可以通过对问题Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n]运行azacsnap -c configure –configuration edit并回答y（是）来启用它。

如所述编辑配置会将 autoDisableEnableBackint JSON 配置文件中的值（ true 例如 azacsnap.json）中设置。还可以直接编辑该配置文件来更改此值。

将 Db2 数据库添加到配置时，需要以下值：

Db2 Server's Address：数据库服务器的主机名或 IP 地址。

如果 Db2 Server Address （serverAddress）匹配127.0.0.1或localhost快照工具在本地运行所有db2命令。否则，快照工具使用serverAddress值作为 SSH 登录名作为主机通过安全外壳（SSHInstance User）连接到。

可以使用 SSH ssh <instanceUser>@<serverAddress>验证远程访问。替换 <instanceUser> 并 <serverAddress> 替换为相应的值。
Instance User：数据库系统的实例用户。
SID：数据库系统 ID。

重要

设置 Db2 Server Address （serverAddress）直接与用于与 Db2 通信的方法保持一致。确保正确设置它，如前所述。

Azure 大型实例（裸机）
Azure NetApp 文档（使用虚拟机）

将 Azure 大型实例存储添加到数据库部分时，需要以下值：

Storage User Name：用于建立与存储的 SSH 连接的用户名。
Storage IP Address：存储系统的 IP 地址。

Storage Volume Name：要快照的卷名称。可以通过多种方式确定此值。一种简单的方法是使用以下 shell 命令：

grep nfs /etc/fstab | cut -f2 -d"/" | sort | uniq

hana_data_p40_soldub41_mnt00001_t020_vol
hana_log_backups_p40_soldub41_t020_vol
hana_log_p40_soldub41_mnt00001_t020_vol
hana_shared_p40_soldub41_t020_vol

将Azure NetApp 文档存储添加到数据库部分时，需要以下值：

Service Principal Authentication filename （JSON 字段： authFile）：
- 若要使用系统托管标识，请将此字段留空且无值，然后选择 Enter 键转到下一个字段。
  
  有关设置 Azure 系统托管标识的示例，请参阅安装Azure 应用程序一致快照工具。
- 若要使用服务主体，请使用在配置与Azure NetApp 文档存储通信时在 Azure Cloud Shell 中生成的身份验证文件（例如 authfile.json）的名称。
  
  有关设置服务主体的示例，请参阅安装Azure 应用程序一致的快照工具。
Full ANF Storage Volume Resource ID（JSON 字段：resourceId：要快照的卷的完整资源 ID。可以转到Azure 门户，然后选择Azure NetApp 文档>Volume>设置或属性>资源 ID 来检索此字符串。

示例配置文件

在以下示例中， azacsnap.json 配置了一个 SID。

必须将参数值设置为特定的 SAP HANA 环境。对于 Azure 大型实例系统，Microsoft 服务管理在调用载入和移交期间以 Excel 文件的形式提供此信息。如果需要 Microsoft Service Management 再次发送信息，请打开服务请求。

以下输出只是一个示例配置文件。它是配置示例生成的文件的内容。相应地更新所有值。

cat azacsnap.json

{
  "version": "6",
  "logPath": "./logs",
  "securityPath": "./security",
  "comments": [
    "This is a new config file for AzAcSnap 6"
  ],
  "database": [
    {
      "hana": {
        "serverAddress": "testing01",
        "sid": "H80",
        "instanceNumber": "00",
        "hdbUserStoreName": "AZACSNAP",
        "savePointAbortWaitSeconds": 600,
        "autoDisableEnableBackint": false,
        "hliStorage": [
          {
            "dataVolume": [
              {
                "backupName": "clt1h80backup",
                "ipAddress": "172.18.18.11",
                "volume": "hana_data_h80_testing01_mnt00001_t020_vol"
              }
            ],
            "otherVolume": []
          }
        ],
        "anfStorage": [],
        "amdStorage": []
      },
      "oracle": null
    }
  ]
}

注意

对于在 DR 站点上运行备份的灾难恢复（DR）方案，在 DR 站点（例如， DR.jsonDR 站点）中配置的 HANA 服务器名称应与生产服务器名称相同。

对于 Azure 大型实例，存储 IP 地址必须与服务器池位于同一子网中。例如，在这种情况下，服务器池子网为 172.18.18.0/24，分配的存储 IP 地址为 172.18.18.11。

后续步骤

测试Azure 应用程序一致性快照工具