Azure 應用程式一致快照集工具版本資訊

發行項
08/15/2024

此頁面列出 AzAcSnap 為提供新功能或解決缺失所做出的重大變更。

下載適用於 Linux 或 Windows 的最新版本二進位檔，並檢閱如何開始使用。

如需預覽版功能的特定資訊，請參閱 AzAcSnap 預覽頁面。

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 的二進位檔。

2024 年 4 月

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 Files 進行 --restore revertvolume 的新功能。
- 備份 (-c backup) 變更：
  - 修正使用 -c backup 時不正確的錯誤輸出，而且資料庫已設定 'backint'。
  - 使用 -c backup 來移除僅限 anfBackup 重新命名選項的小寫轉換，讓快照集名稱維持磁碟區名稱的大小寫。
  - 修正即使 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 Files 磁碟區，在磁碟區複製上正確地設定 ThroughputMiBps。

下載 AzAcSnap 7a 安裝程式。

2022 年 12 月

AzAcSnap 7 (組建：1A8FDFF)

AzAcSnap 7 發行時將會包含下列修正程式和改善：

修正程式和改善：
- 備份 (-c backup) 變更：
  - 縮短新增至快照集名稱的尾碼。先前的 26 個字元尾碼 "YYYY-MM-DDThhhhss-nnnnnnnZ" 太長。尾碼現在是根據自 Unix epoch 以來的十萬分之一秒的 11 個字元十六進位-十進位，以避免命名衝突，例如，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 Files 備份的初步支援。
- Db2 資料庫支援新增選項，以使用應用程式一致的方式來設定、測試和快照備份 IBM Db2。

下載 AzAcSnap 7 安裝程式。

2022 年 7 月

AzAcSnap 6 (組建：1A5F0B8)

重要

AzAcSnap 6 為 AzAcSnap 帶來全新的版本模型，同時在單一版本中納入完全支援的正式發行功能和預覽功能。

自 AzAcSnap v5.0 在 2021 年 4 月正式發行以來，AzAcSnap 的兩個分支共發行八個版本。我們對於新版本模型的目標，在於統一 Azure 元件的發行方式。此變更允許將功能從預覽版移至正式發行版 (不需要移動整個分支)，同時引進新的預覽版功能 (不需要建立新的分支)。自 AzAcSnap 6 起，我們會在單一分支中使用完全支援的 GA 功能和預覽功能 (需遵守 Microsoft 的預覽版 Ts&C)。請務必留意，客戶不可意外使用預覽版功能，而且必須使用 --preview 命令列選項將其啟用。因此，下一個版本將會是 AzAcSnap 7，並可能包括正式發行版功能的修補檔 (如有必要)、將目前的預覽版功能移至正式發行版，或新的預覽版功能。

AzAcSnap 6 發行時將包含下列修正和改善：

移至正式發行版的功能 (正式推出)：
- Oracle Database 支援。
- 與 Backint 整合以搭配 Azure 備份。
- RunBefore/RunAfter 命令列選項，用以在拍攝儲存體快照集前後執行自訂殼層指令碼和命令。
預覽版中的功能：
- 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 天。這項更新包含修正查詢 SAP Hana 時處理分隔識別碼的問題，與 v5.0.3 提供的一致。

2022 年 3 月

AzAcSnap v5.1 預覽版 (組建：20220302.81795)

AzAcSnap v5.1 預覽版 (組建：20220302.81795) 已發行，包括下列全新功能：

Azure Key Vault 支援安全儲存服務主體。
具有 all 參數值的 -c backup --volume 全新選項。

2022 年 2 月

AzAcSnap v5.1 預覽版 (組建：20220220.55340)

AzAcSnap v5.1 預覽版 (組建：20220220.55340) 已發行，包括下列修正和改善：

解決使用 -c restore 命令在 Oracle 資料庫 JSON 設定檔配對 --dbsid 命令列選項與 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 大型執行個體)。
現在安裝程式會顯示即將安裝/擷取的版本 (如果安裝程式執行時未有任何引數)。

2021 年 5 月

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) - 已正式發行 (2021 年 4 月 21 日)

AzAcSnap v5.0 (組建：20210421.6349) 現已正式推出，此組建包括下列修正和改善：

hdbsql retry 逾時 (等候 SAP Hana 回應) 會自動設定為 "savePointAbortWaitSeconds" 的一半，以避免競爭條件。 "savePointAbortWaitSeconds" 的設定可直接在 JSON 設定檔中修改，且至少必須為 600 秒。

2021 年 3 月

AzAcSnap v5.0 預覽版 (組建：20210318.30771)

AzAcSnap v5.0 預覽版 (組建：20210318.30771) 已發行，包括下列修正和改善：

已移除將 AZACSNAP 使用者新增至 SAP Hana 租用戶 DB 中的需求，請參閱啟用與資料庫的溝通一節。
修正以允許透過手動 QOS 磁碟區設定進行還原。
已新增 Mutex 控制項，針對 Azure 大型執行個體節流 SSH 連線。
修正安裝程式來處理帶有空格和其他相關問題的路徑名稱。
為準備支援其他資料庫伺服器，將選擇性參數 "--hanasid" 變更為 "--dbsid"。

共用方式為