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

Azure 应用程序一致性快照工具（预览版）的发行说明

项目
10/31/2024

此页列出了对 AzAcSnap 所做的重大更改，这些更改的目的是提供新功能或解决缺陷问题。

下载最新版本的 Linux 或 Windows 二进制文件，并查看如何开始使用。

有关预览功能的特定信息，请参阅 AzAcSnap 预览页。

2024 年 10 月

AzAcSnap 10a（内部版本：1B79BA*）

AzAcSnap 10a 正在发布以下修补和改进程序：

修复和改进：
- 允许 Microsoft SQL Server 的可配置等待超时。这有助于为响应缓慢的系统增加超时（默认的最小值为 30 秒）。
  - 添加了一个全局重写变量 MSSQL_CMD_TIMEOUT_SECS，用于 .azacsnaprc 文件或设为所需的等待超时 (以秒为单位) 的环境变量。有关配置的详细信息，请参阅全局替代设置来控制 AzAcSnap 行为。

下载 AzAcSnap 10a for Linux (签名文件) 或 AzAcSnap 10a for Windows 的二进制文件。

2024 年 7 月

AzAcSnap 10（内部版本：1B55F1*）

AzAcSnap 10 正在发布以下修补程序和改进：

添加到预览版的功能：
- Microsoft SQL Server 支持添加选项，以应用程序一致的方式配置和测试备份 Microsoft SQL Server 并拍摄它的快照。
迁移到正式版的功能（正式发布）：
- 支持 AzAcSnap 的 Windows 现在能够在受支持的 Linux 分发版和 Windows 上运行。
- 新配置文件布局。
  - 若要升级 AzAcSnap 10 预配置，请使用 azacsnap -c configure --configuration new 命令创建新的配置文件并使用现有配置文件中的值。
- 通过基于 HTTPS 的 REST API 的 Azure 大型实例存储管理。
  - 这允许在受支持的 Azure 大型实例存储上使用一致性组快照。
修复和改进：
- 新增 --flush 选项，将为本地存储刷新内存中的文件缓冲区，在连接为块存储时对 Azure 大型实例和 Azure 托管磁盘非常有用。
- 日志记录改进。
移除的功能：
- 适用于 Linux 的 AzAcSnap 安装程序。
  - AzAcSnap 现在可作为二进制文件下载，适用于受支持的 Linux 和 Windows 版本。这简化了对 AzAcSnap 程序的访问，使你能够快速开始。
- 通过基于 SSH 的 CLI 的 Azure 大型实例存储管理。
  - 基于 SSH 的 CLI 替换为基于 HTTPS 的 REST API。

下载适用于 Linux 的 AzAcSnap 10 或适用于 Windows 的 AzAcSnap 10 的二进制文件。

Apr-2024

AzAcSnap 9a（内部版本：1B3B458）

AzAcSnap 9a 正在发布以下修补程序和改进：

修复和改进：
- 允许 AzAcSnap 手动配置 Azure 管理终结点，以允许它在 Azure 主权云中工作。
  - 添加了一个全局重写变量 AZURE_MANAGEMENT_ENDPOINT，用于 .azacsnaprc 文件或作为环境变量设置为适当的 Azure 管理终结点。有关配置的详细信息，请参阅全局替代设置来控制 AzAcSnap 行为。

下载 AzAcSnap 9a 安装程序。

2023 年 8 月

AzAcSnap 9 （内部版本：1AE5640）

AzAcSnap 9 正在发布以下修补程序和改进：

迁移到正式版的功能（正式发布）：
- IBM Db2 数据库支持。
- 系统托管标识支持，以便更轻松地设置，同时改善安全状况。
修复和改进：
- 配置 (-c configure) 更改：
  - 使用系统托管标识时，允许配置文件中 authFile 的空白值。
添加到预览版的功能：
- 无。
移除的功能：
- 从预览版中移除了 Azure Key Vault 支持。现在不需要 AzAcSnap 直接支持系统托管标识。

下载 AzAcSnap 9 安装程序。

2023 年 6 月

AzAcSnap 8b（内部版本：1AD3679）

AzAcSnap 8b 随以下修补程序和改进一起发布：

修复和改进：
- azacsnap 命令退出代码的一般改进。
  - azacsnap 在按预期运行时应返回 0（零）的退出代码，否则它应返回非零的退出代码。例如，运行 azacsnap 返回非零，因为没有任何操作，并显示使用情况信息，而 azacsnap -h 返回零的退出代码，因为它通过返回使用情况信息按预期方式执行。
  - --runbefore 的任何失败都退出任何备份活动，并返回 --runbefore 退出代码。
  - --runafter 中的任何失败都返回 --runafter 退出代码。
- 备份 (-c backup) 更改：
  - 在 Db2 工作流中进行更改，以将受保护的路径查询移到 WRITE SUSPEND、存储快照、WRITE RESUME 工作流之外以提高复原能力。（预览版）
  - 修复了 --runafter 命令环境中缺少快照名称 (azSnapshotName)。

下载 AzAcSnap 8b 安装程序。

2023 年 5 月

AzAcSnap 8a（内部版本：1AC55A6）

AzAcSnap 8a 正在发布以下修补程序和改进：

修复和改进：
- 配置 (-c configure) 更改：
  - 修复了 AzAcSnap 8 中 -c configure 相关更改。
  - 改进了用于改善客户体验的工作流指南。

下载 AzAcSnap 8a 安装程序。

AzAcSnap 8（内部版本：1AC279E）

AzAcSnap 8 正在发布以下修补程序和改进：

修复和改进：
- 还原 (-c restore) 更改：
  - 使用 -c restore 为 Azure NetApp 文件 --restore revertvolume 的新功能。
- 备份 (-c backup) 更改：
  - 修复了在使用 -c backup 和数据库已‘配置 backint’时的错误输出错误。
  - 使用 -c backup 移除仅限 afBackup 重命名选项的小写转换，以便快照名称保留卷名称大小写。
  - 修复了创建快照时的问题，即使 SAP HANA 未放入备份模式。现在，如果 SAP HANA 无法放入备份模式，AzAcSnap 会立即退出并显示错误。
- 详细信息 (-c details) 更改：
  - 修复了在使用 Azure 大型实例存储时使用 -c details 列出快照详细信息的修复。
- 日志记录增强功能：
  - 失败时，向 syslog 的额外日志记录输出（例如，/var/log/messages）。
  - 新的“mainlog”(azacsnap.log) 提供可分析的命令的更高级别日志，并生成成功或失败结果。
- 新的全局设置文件 (.azacsnaprc)，用于控制 azacsnap 的行为，包括“mainlog”文件的位置。

下载 AzAcSnap 8 安装程序。

2023 年 2 月

AzAcSnap 7a （内部版本：1AA8343）

AzAcSnap 7a 正在发布以下修补程序：

-c restore 命令的修复：
- 在使用 -c restore --restore revertvolume 时，当卷还原为以前的状态时，在 HLI (BareMetal) 上启用装载卷。
- 使用 -c restore --restore snaptovol 时，在自动 QoS 容量池中的 Azure NetApp 文件卷克隆上正确设置 ThroughputMiBps。

下载 AzAcSnap 7a 安装程序。

2022 年 12 月

AzAcSnap 7（内部版本：1A8FDFF）

AzAcSnap 7 正在发布中，包含以下修复和改进：

修复和改进：
- 备份 (-c backup) 更改：
  - 缩短了添加到快照名称的后缀。之前的 26 个字符后缀“YYYY-MM-DDThhhss-nnnnnnnz”太长。后缀现在是一个 11 个字符十六进制的小数点，基于自 Unix 纪元以来的十万分之一，以避免命名冲突，例如，F2D212540D5。
  - 在创建快照时增加了验证，以避免快照创建重试失败。
  - 执行 AzAcSnap 机制以禁用/启用 backint (autoDisableEnableBackint=true) 时的超时现在与其他 SAP HANA 相关的操作超时值一致。
  - Azure 备份现在允许基于第三方快照的备份，而不会影响流式处理备份（也称为“backint”）。因此，AzAcSnap“backint”检测逻辑已重新排序，以便将来弃用此功能。此设置默认已禁用 (autoDisableEnableBackint=false)。对于依赖此功能通过 AzAcSnap 拍摄快照并使用 Azure 备份的客户，将此值保留为 true 意味着 AzAcSnap 7 将继续禁用/启用 backint。由于 Azure 备份不再需要此设置，因此建议使用 autoDisableEnableBackint=false 值测试 AzAcSnap 备份，如果成功，请在生产部署中执行相同的更改。
- 还原 (-c restore) 更改：
  - 能够通过以下任一方式在使用 -c restore --restore snaptovol 时为创建的卷克隆创建自定义后缀：
    - 通过命令行使用 --clonesuffix <custom suffix>。
    - 在没有 --force 选项的情况下运行命令时以交互方式运行。
  - 在 ANF 上执行 --restore snaptovol 时，卷克隆还将从源卷继承新的“NetworkFeatures”设置。
  - 现在可以在未配置数据卷的情况下执行还原。它只会使用其他卷最新快照来还原其他卷（选项 --snapshotfilter 仅适用于数据卷）。
  - 命令 -c restore 的额外日志记录，帮助用户调试。
- 测试 (-c test) 更改：
  - 现在测试管理所有 otherVolume 和所有 dataVolume 的快照。
迁移到正式版的功能（正式发布）：
- 无。
添加到预览版的功能：
- 对 Azure NetApp 文件备份的初步支持。
- Db2 数据库支持添加选项，以应用程序一致的方式配置和测试备份 IBM Db2 并拍摄它的快照。

下载 AzAcSnap 7 安装程序。

2022 年 7 月

AzAcSnap 6 (Build: 1A5F0B8)

重要

AzAcSnap 6 为 AzAcSnap 带来了新的发布模型，并在单个版本中包括完全支持的 GA 功能和预览功能。

自 AzAcSnap v5.0 于 2021 年 4 月正式发布以来，两个分支中已有 8 个 AzAcSnap 版本。使用新版本模型的目标是与 Azure 组件发布方式保持一致。此更改允许将功能从预览版移动到 GA（而无需移动整个分支），并引入新的预览功能（而无需创建新的分支）。从 AzAcSnap 6 起，我们将有一个分支，其中包含完全支持的 GA 功能和预览功能（受 Microsoft 预览条款和条件的约束）。请务必注意，客户不能意外使用预览功能，必须使用 --preview 命令行选项启用它们。因此，下一个版本将是 AzAcSnap 7，其中包括：（如果需要）正式版功能的补丁、迁移到 GA 的当前预览版功能或新的预览功能。

AzAcSnap 6 正在发布以下修补程序和改进：

迁移到正式版的功能（正式发布）：
- Oracle Database 支持。
- 使用 Azure 备份的 Backint 集成。
- RunBefore/RunAfter 命令行选项，用于在创建存储快照之前或之后执行自定义 shell 脚本和命令。
预览版功能：
- Azure Key Vault 存储服务主体内容。
- Azure 托管磁盘作为备用存储后端。
ANF 客户端 API 版本已更新为 2021-10-01。
如果 SAP HANA 处于快照的一致状态时出现故障，更改用于处理 Backint 以重新启用 backint 配置的工作流。

下载 AzAcSnap 6 安装程序。

2022 年 5 月

AzAcSnap v5.0.3（内部版本：20220524.14204）- v5.0.2 的补丁更新

AzAcSnap v5.0.3（内部版本：20220524.14204）作为 v5.0 分支的补丁更新提供，包含以下修复：

修复了在查询 SAP HANA 时处理带分隔符的标识符的问题。此问题只在存在配置了“logreplay_readaccss”的辅助节点时才会影响 HSR-HA 节点中的 SAP HANA，并且已经解决。

AzAcSnap v5.1 预览版（内部版本：20220524.15550）

AzAcSnap v5.1 预览版（内部版本：20220524.15550）是更新的内部版本，用于将预览版有效期延长 90 天。此更新包含了 v5.0.3 中提供的修补程序，用于修补在查询 SAP HANA 时处理带分隔符的标识符的问题。

2022 年 3 月

AzAcSnap v5.1 预览版（内部版本：20220302.81795）

AzAcSnap v5.1 预览版（内部版本：20220302.81795）已发布，包括以下新功能：

Azure Key Vault 支持安全存储服务主体。
-c backup --volume 的新选项，其中包含 all 参数值。

2022 年 2 月

AzAcSnap v5.1 预览版（内部版本：20220220.55340）

AzAcSnap v5.1 预览版（内部版本：20220220.55340）已发布，并包括以下修复和改进内容：

解决了使用 -c restore 命令时将 --dbsid 命令行选项与 Oracle 数据库的 JSON 配置文件中的 sid 条目匹配失败的问题。

AzAcSnap v5.1 预览版（内部版本：20220203.77807）

AzAcSnap v5.1 预览版（内部版本：20220203.77807）已发布，并包括以下修复和改进内容：

解决 STDOUT 缓冲区限制的小更新。现在，放入存档模式的 Oracle 表文件列表将发送到外部文件，而不是输出到主 AzAcSnap 日志文件中。外部文件与日志文件拥有相同的位置和基名，但带有“.protected-tables”扩展名（输入文件名详见 AzAcSnap 日志文件）。每次 azacsnap 运行时都将覆盖它。

2022 年 1 月

AzAcSnap v5.1 预览版（内部版本：20220125.85030）

AzAcSnap v5.1 预览版（内部版本：20220125.85030）已发布，包括以下新功能：

Oracle Database 支持
Backint 共存
Azure 托管磁盘
RunBefore 和 RunAfter 功能

2021 年 8 月

AzAcSnap v5.0.2（内部版本：20210827.19086）- 对 v5.0.1 的补丁更新

AzAcSnap v5.0.2（内部版本：20210827.19086）作为 v5.0 分支的补丁更新提供，具有以下修复和改进：

忽略 ssh 255 退出代码。在某些情况下，当未发生错误或执行失败时，用于与 Azure 大型实例上的存储通信的 ssh 命令将发出退出代码 255（请参阅 man ssh“退出状态”）- 然后 AzAcSnap 会将此退出代码捕获为错误并中止。在此更新中，除了执行传统的退出代码检查外，还会执行额外验证来验证执行是否正常，此验证包括分析 ssh STDOUT 和 STDERR 中的错误。
修复安装程序对 hdbuserstore 位置的检查功能。安装程序将在文件系统中搜索运行安装的用户的 hdbuserstore 位置的源目录不正确 - 安装程序现在搜索 ~/.hdb。此修补程序适用于在安装 azacsnap 之前为 root 用户预配置 hdbuserstore 的系统（例如 Azure 大型实例）。
安装程序现在会显示它安装/提取的版本（如果不结合任何参数运行安装程序）。

May-2021

AzAcSnap v5.0.1（内部版本：20210524.14837）- 对 v5.0 的补丁更新

AzAcSnap v5.0.1（内部版本：20210524.14837）作为 v5.0 分支的补丁更新提供，具有以下修复和改进：

改进了退出代码处理。在某些情况下，即使执行失败，AzAcSnap 也会发出退出代码 0（零），而退出代码本应为非零值。退出代码现在只会在成功运行 azacsnap 到结束的情况下为零，如果有任何失败，退出代码就会变为非零值。
AzAcSnap 的内部错误处理已扩展为捕获和发出由 AzAcSnap 运行的外部命令的退出代码。

2021 年 4 月

AzAcSnap v5.0（版本编号：20210421.6349) - GA 发布版本（2021 年 4 月 21 日）

AzAcSnap v5.0（版本编号：20210421.6349）已公开发布，此版本包含以下修复和改进：

Hdbsql 重试超时（等待 SAP HANA 的响应）自动设置为“savePointAbortWaitSeconds”的一半，以避免争用条件。可以直接在 JSON 配置文件中修改“savePointAbortWaitSeconds”的设置，并且该设置的最小值必须为 600 秒。

2021 年 3 月

AzAcSnap v5.0 预览版（内部版本：20210318.30771）

AzAcSnap v5.0 预览版（内部版本：20210318.30771）随以下修补程序和改进一起发布：

无需将 AZACSNAP 用户添加到 SAP HANA 租户 DB，详见启用与数据库的通信部分。
让用户能使用已配置手动 QOS 的卷进行还原的修补程序。
添加了互斥控制来限制 Azure 大型实例的 SSH 连接。
修复安装程序以处理带有空格和其他相关问题的路径名。
为了准备支持其他数据库服务器，将可选参数“--hanasid”更改为“--dbsid”。

通过