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

安装 Azure 应用程序一致性快照工具

项目
10/16/2024

本文提供相关指南，指导如何安装可与 Azure NetApp 文件或 Azure 大型实例配合使用的 Azure 应用程序一致性快照工具 (AzAcSnap)。

重要

Azure 大型实例系统部署在专用网络中，因此只能采用分布式安装。必须在每个系统上安装 AzAcSnap 以确保连接。

AzAcSnap 10 支持更多数据库和操作系统，因此不再提供自安装程序。

下载 AzAcSnap

首先，将 AzAcSnap 可执行文件下载到计算机上的任意目录。 AzAcSnap 是一个免安装的可执行文件。

Linux x86-64（二进制文件）
- Linux 二进制文件具有关联的 Linux 签名文件。此文件是使用 Microsoft 的公钥签名的，允许 GPG 验证下载的安装程序。
重要

该安装程序不再适用于 Linux。请按照此处的指南设置用户的配置文件以运行 AzAcSnap 及其依赖项。
Windows 64 位（可执行文件）
- Windows 二进制文件由 Microsoft 签名。

完成这些下载后，安装 Azure 应用程序一致性快照工具。

安装的先决条件

按照准则设置和运行快照和灾难恢复命令。建议在安装和使用快照工具之前，先以 root 身份完成以下步骤：

修补操作系统
1. 对于 Azure 大型实例上的 SUSE，设置 SUSE 订阅管理工具 (SMT)。有关详细信息，请参阅安装和配置 Azure 上的 SAP HANA（大型实例）。
设置时间同步。提供与网络时间协议 (NTP)兼容的时间服务器，并相应地配置操作系统。
安装数据库。按照你正在使用的受支持数据库的说明进行安装。
选择用于部署的存储后端。有关详细信息，请参阅本文后面的启用与存储的通信。
启用与数据库的通信。有关详细信息，请参阅本文后面的启用与数据库的通信。
- SAP HANA
- Oracle
- IBM Db2
按照数据库配置文档中“启用与数据库的通信”部分的说明设置适当的 SAP HANA 用户。

设置后，可以使用下面的示例在命令行中测试连接。下面的示例适用于与 SAP HANA 的非 SSL 通信。

HANA 1.0：

hdbsql -n <HANA IP address> -i <HANA instance> -U <HANA user> "\s"

HANA 2.0：

hdbsql -n <HANA IP address> -i <HANA instance> -d SYSTEMDB -U <HANA user> "\s"

按照数据库配置文档中“启用与数据库的通信”部分中的说明设置适当的 Oracle Database 和 Oracle 钱包。

设置后，可以使用下面的示例在命令行中测试连接：

sqlplus /@<ORACLE_USER> as SYSBACKUP
按照数据库配置文档中“启用与数据库的通信”部分中的说明设置适当的 IBM Db2 连接方法。

设置后，使用下面的示例在命令行中测试连接：
- 安装到数据库服务器，然后使用 Db2 本地连接完成设置：
  
  db2 "QUIT"
- 安装到集中式备份系统，然后使用 Db2 远程连接完成设置：
  
  ssh <InstanceUser>@<ServerAddress> 'db2 "QUIT"'
上述命令应生成以下输出：
```
DB20000I  The QUIT command completed successfully.
```

安装快照工具

完成先决条件步骤后，安装 AzAcSnap 的步骤如下：

创建快照用户 azacsnap、创建主目录，并设置组成员身份。
配置 azacsnap 用户的登录 ~/.profile 信息。
在文件系统中搜索要添加到 $PATH (Linux) 或 %PATH% (Windows) 的 AzAcSnap 目录。此任务允许运行 AzAcSnap 的用户使用数据库特定的命令，例如 hdbsql 和 hdbuserstore。
在文件系统中搜索要添加到 $LD_LIBRARY_PATH (Linux) 的 AzAcSnap 目录。许多命令要求设置库路径以正确运行它们。
将 AzAcSnap 二进制文件复制到用户的 $PATH (Linux) 或 %PATH% (Windows) 上的某个位置。
在 Linux 上，可能需要正确设置 azacsnap 二进制文件权限，包括所有权和可执行位。

执行以下步骤以获取正在运行的 azacsnap：

对于 Linux，通过 shell 会话：
1. 以根超级用户身份创建一个 Linux 用户
  1. useradd -m azacsnap
2. 以用户身份登录
  1. su – azacsnap
  2. cd $HOME/bin
3. 下载 azacsnap
  1. wget -O azacsnap https://aka.ms/azacsnap-linux
4. 运行 azacsnap
  1. azacsnap -c about
对于 Windows，通过 GUI：
1. 创建 Windows DSVM
2. 以用户身份登录
3. 下载 azacsnap.exe
4. 打开终端会话并运行 azacsnap
  1. azacsnap.exe -c about

更新用户配置文件

运行 AzAcSnap 的用户需要更新所有环境变量，以确保 AzAcSnap 可以运行数据库特定的命令，而不需要命令的完整路径。如果出于特殊目的需要，此方法允许覆盖数据库命令。

SAP HANA 需要 hdbuserstore 和 hdbsql。
OracleDB 需要 sqlplus。
IBM Db2 需要 db2 和 ssh（用于在进行集中安装时远程访问 Db2）。

Linux

在 Linux 上，用户的 $PATH 设置通常是通过使用适当的 $PATH 信息来更新用户的 $HOME/.profile 来定位二进制文件，并且可能使用 LD_LIBRARY_PATH 变量来确保 Linux 二进制文件的共享对象的可用性。

在文件系统中搜索要添加到 AzAcSnap 的 $PATH 的目录。

例如：

# find the path for the hdbsql command
export DBCMD="hdbsql"
find / -name ${DBCMD} -exec dirname {} + 2> /dev/null | sort | uniq | tr '\n' ':'
/hana/shared/PR1/exe/linuxx86_64/HDB_2.00.040.00.1553674765_c8210ee40a82860643f1874a2bf4ffb67a7b2add
#
# add the output to the user's profile
echo "export PATH=\"\$PATH:/hana/shared/PR1/exe/linuxx86_64/HDB_2.00.040.00.1553674765_c8210ee40a82860643f1874a2bf4ffb67a7b2add\"" >> /home/azacsnap/.profile
#
# add any shared objects to the $LD_LIBRARY_PATH
export SHARED_OBJECTS='*.so'
NEW_LIB_PATH=`find -L /hana/shared/[A-z0-9][A-z0-9][A-z0-9]/HDB*/exe /usr/sap/hdbclient -name "*.so" -exec dirname {} + 2> /dev/null | sort | uniq | tr '\n' ':'`
#
# add the output to the user's profile
echo "export LD_LIBRARY_PATH=\"\$LD_LIBRARY_PATH:$NEW_LIB_PATH\"" >> /home/azacsnap/.profile

Windows

使用 Windows 特定工具查找命令的位置并将其目录添加到用户配置文件中。

根据存储后端执行以下操作：
- Azure NetApp 文件（带有 VM）
- Azure 大型实例（裸机）
无需对 Azure NetApp 文件执行特殊操作。
1. 确保 PKCS12 证书文件可供 AzAcSnap 用户读取。此步骤假定已配置与存储的连接。有关详细信息，请参阅前面的部分启用与存储的通信。

卸载快照工具

如果使用默认设置安装了快照工具，则卸载只需要删除安装命令的用户并删除 AzAcSnap 二进制文件。

完成快照工具的设置

可以按照以下步骤配置和测试快照工具。

登录到 AzAcSnap 用户帐户。 a. 对于 Linux，su - azacsnap。 a. 对于 Windows，以 AzAcSnap 用户身份登录。
如果已将 AzAcSnap 二进制文件添加到用户的 $PATH (Linux) 或 %PATH% (Windows)，则使用 azacsnap 运行 AzAcSnap，或者需要添加 AzAcSnap 二进制文件的完整路径（例如 /home/azacsnap/bin/azacsnap (Linux) 或 C:\Users\AzAcSnap\azacsnap.exe (Windows)）。
配置客户详细信息文件。 azacsnap -c configure --configuration new
测试与存储的连接。 azacsnap -c test --test storage
测试与数据库的连接。 a. SAP HANAazacsnap -c test --test hana a. Oracle DBazacsnap -c test --test oracle a. IBM Db2 azacsnap -c test --test db2

如果测试命令运行正确，则测试成功。然后，可以执行第一个数据库一致的存储快照。

azacsnap -c backup --volume data --prefix adhoc_test --retention 1

后续步骤

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

通过