Azure アプリケーション整合性スナップショットツールのリリースノート

[アーティクル]
07/02/2024

このページでは、新しい機能を提供したり欠陥を解決したりするために、AzAcSnap に加えられた主な変更を示します。

インストーラーの最新リリースをダウンロードし、作業の開始方法を確認してください。

プレビュー機能に関する特定の情報については、AzAcSnap のプレビューに関するページを参照してください。

2024 年 7 月

AzAcSnap 10 (ビルド: 1B55F1*)

AzAcSnap 10 は、次の修正と機能強化を備えてリリースされています。

プレビューに追加された機能:
- Microsoft SQL Server では、アプリケーション整合性のある方法で Microsoft SQL Server に対して構成、テスト、スナップショットバックアップを行うためのオプションの追加がサポートされています。
GA (一般提供) に移行される機能:
- AzAcSnap での Windows のサポートは、サポートされている Linux ディストリビューションと Windows 上で実行できるようになりました。
- 新しい構成ファイルのレイアウト。
  - AzAcSnap 10 より前の構成をアップグレードするには、azacsnap -c configure --configuration new コマンドを使用して新しい構成ファイルを作成し、既存の構成ファイルの値を使用します。
- HTTPS 経由の REST API を使用した Azure Large Instance ストレージ管理。
  - これにより、サポートされている Azure Large Instance ストレージで整合性グループスナップショットを使用できます。
修正と機能強化:
- ローカルストレージ用のメモリファイルバッファーにフラッシュする新しい --flush オプション。ブロックストレージとして接続されている場合には、Azure Large Instance と Azure マネージドディスクに役立ちます。
- ログの機能強化。
削除された機能:
- Linux 用 AzAcSnap インストーラー。
  - AzAcSnap は、サポートされているバージョンの Linux と Windows ではバイナリとしてダウンロードできるようになりました。これにより、AzAcSnap プログラムへのアクセスが簡素化され、すぐに開始できます。
- SSH 経由の CLI を使用した Azure Large Instance ストレージ管理。
  - SSH 経由の CLI は HTTPS 経由の REST API に置き換えられました。

Linux 用 AzAcSnap 10 または Windows 用 AzAcSnap 10 のバイナリをダウンロード。

2024 年 4 月

AzAcSnap 9a (ビルド: 1B3B458)

AzAcSnap 9a は、次の修正と機能強化を備えてリリースされています:

修正と機能強化:
- Azure ソブリンクラウドで動作できるように、AzAcSnap に Azure 管理エンドポイントを手動で構成できるようなりました。
  - .azacsnaprc ファイル内で使用する、または適切な Azure 管理エンドポイントに設定された環境変数として使用するグローバルオーバーライド変数 AZURE_MANAGEMENT_ENDPOINT を追加しました。構成の詳細については、AzAcSnap の動作を制御するためのグローバルオーバーライド設定を参照してください。

AzAcSnap 9a インストーラーをダウンロードします。

2023 年 8 月

AzAcSnap 9 (Build: 1AE5640)

AzAcSnap 9 は、次の修正と機能強化を使用してリリースされています:

GA (一般提供) に移行される機能:
- IBM Db2 Database のサポート。
- システムマネージド ID のサポートにより、セキュリティ体制を改善しながらセットアップが容易になります。
修正と機能強化:
- 構成 (-c configure) の変更:
  - システムマネージド ID を使用する場合は、構成ファイル内の authFile に空白の値を指定できます。
プレビューに追加された機能:
- ありません。
削除された機能:
- Azure Key Vault のサポートがプレビューから削除されました。これは、AzAcSnap でシステムマネージド ID が直接サポートされるようになったため不要になりました。

AzAcSnap 9 インストーラーをダウンロードします。

2023 年 6 月

AzAcSnap 8b (ビルド: 1AD3679)

AzAcSnap 8b は、次の修正と機能強化を加えてリリースされています:

修正と機能強化:
- azacsnap コマンド終了コードの一般的な改善。
  - azacsnap は、予期したとおりに実行されたときに 0 (ゼロ) の終了コードを返し、それ以外の場合は、0 以外の終了コードを返します。たとえば、azacsnap を実行すると、何も行っていないため 0 以外の値が返され、使用状況情報が表示されますが、azacsnap -h は、使用情報を返すことで期待どおりに実行されているため 0 の終了コードを返します。
  - --runbefore のエラーは、すべてバックアップアクティビティの前に終了し、 --runbefore 終了コードを返します。
  - --runafter でエラーが発生すると、 --runafter 終了コードが返されます。
- バックアップ (-c backup) の変更:
  - 回復性を向上させるために、保護パスクエリを WRITE SUSPEND、Storage Snapshot、WRITE RESUME ワークフローの外部に移動するように Db2 ワークフローを変更します。 (プレビュー)
  - --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 から --restore revertvolume を Azure NetApp Files に使用する新しい機能。
- バックアップ (-c backup) の変更:
  - -c backup を使用していて、データベースに ‘backint’ が構成されている場合の誤ったエラー出力を修正しました。
  - スナップショット名でボリューム名の大文字と小文字が維持されるように、 -c backup を使用して anfBackup の名前変更専用オプションの小文字変換を削除します。
  - SAP HANA がバックアップモードに設定されていない場合でも、スナップショットが作成されるときの修正。 SAP HANA をバックアップモードにできない場合、AzAcSnap はすぐにエラーで終了します。
- 詳細 (-c details) の変更:
  - Azure Large Instance ストレージを使用する場合の -c details でスナップショットの詳細を一覧表示する問題を修正しました。
- ログ記録の機能強化:
  - 障害が発生した場合の syslog (たとえば、/var/log/messages) への追加のログ出力。
  - 実行されたコマンドの成功または失敗の結果をより解析可能な高レベルのコマンドログを提供する新しい "mainlog" (azacsnap.log)
- "mainlog" ファイルの場所を含む azacsnap の動作を制御する新しいグローバル設定ファイル (.azacsnaprc)。

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) の変更:
  - スナップショット名に追加されるサフィックスが短くなりました。以前の "YYYY-MM-DDThhhhss-nnnnnnnnnZ" の接尾辞 26 文字が長すぎました。サフィックスは、たとえば、F2D212540D5 などの名前の競合を回避するために、Unix エポック以降の 10,000 分の 1 秒数に基づく 11 文字の 16 進数になりました。
  - スナップショット作成の再試行時にエラーが発生しないように、スナップショット作成時の検証を強化しました。
  - AzAcSnap メカニズムを実行して backint を無効/有効にする (autoDisableEnableBackint=true) ときのタイムアウトが、他の SAP HANA 関連の操作タイムアウト値と一致するようになりました。
  - Azure Backup では、ストリーミングバックアップ ("backint" とも呼ばれます) に影響を与えることなく、サードパーティのスナップショットベースのバックアップが許可されるようになりました。そのため、AzAcSnap 'backint' 検出ロジックは、今後この機能が非推奨になることを考慮して並べ替えられました。既定では、この設定は無効になっています (autoDisableEnableBackint=false)。この機能に依存して AzAcSnap でスナップショットを作成し、Azure Backup を使用しているお客様にとって、この値を true に保つことは、AzAcSnap 7 が引き続き backint を無効/有効にすることを意味します。この設定は Azure Backup では不要になったため、autoDisableEnableBackint=false の値を使用して AzAcSnap バックアップをテストし、成功した場合は運用環境のデプロイで同じ変更を行うことをお勧めします。
- 復元 (-c restore) の変更:
  - 次のいずれかで -c restore --restore snaptovol を使用して作成されたボリュームクローンのカスタムサフィックスを作成する機能:
    - コマンドラインで --clonesuffix <custom suffix> を使用する。
    - コマンドを実行する時に --force オプションを使用せずに対話的に行う。
  - ANF で --restore snaptovol を実行すると、ボリュームクローンはソースボリュームから新しい "NetworkFeatures" 設定を継承します。
  - データボリュームが構成されていない場合に復元を実行できるようになりました。他のボリュームの最新のスナップショットを使用して他のボリュームのみを復元します (--snapshotfilter オプションはデータボリュームにのみ適用されます)。
  - ユーザーのデバッグに役立つ -c restore コマンドの追加のログ。
- テスト (-c test) の変更:
  - すべての otherVolume とすべての dataVolume のスナップショットの管理がテストされるようになりました。
GA (一般提供) に移行される機能:
- ありません。
プレビューに追加された機能:
- Azure NetApp Files バックアップの暫定サポート。
- Db2 データベースでは、アプリケーションの一貫した方法で IBM Db2 のバックアップを構成、テスト、スナップショットを作成するためのオプションの追加がサポートされています。

AzAcSnap 7 インストーラーをダウンロードします。

2022 年 7 月

AzAcSnap 6 (ビルド: 1A5F0B8)

重要

AzAcSnap 6 では、AzAcSnap の新しいリリースモデルが提供され、完全サポートされる GA 機能とプレビュー機能が 1 つのリリースに含まれます。

AzAcSnap v5.0 が 2021 年 4 月に GA としてリリースされて以来、2 つのブランチで AzAcSnap のリリースが 8 回行われました。新しいリリースモデルの目標は、Azure コンポーネントのリリース方法に合わせることです。この変更により、機能をプレビューから GA に移行でき (ブランチ全体を移行する必要はありません)、新しいプレビュー機能を導入できます (新しいブランチを作成する必要はありません)。 AzAcSnap 6 からは、完全サポートされる GA 機能とプレビュー機能 (Microsoft の Preview Ts&Cs の対象) を持つ単一のブランチが提供されます。重要なのは、お客様が誤ってプレビュー機能を使用できないこと、--preview コマンドラインオプションを使用してそれらを有効にする必要があることに注目することです。したがって、次のリリースは AzAcSnap 7 となり、これには次のものが含まれる可能性があります。GA 機能、GA に移行する現在のプレビュー機能、または新しいプレビュー機能のパッチ (必要な場合)。

AzAcSnap 6 は、次の修正と機能強化が行われリリースされる予定です。

GA (一般提供) に移行される機能:
- Oracle Database のサポート。
- Azure Backup と Backint の連動のための統合。
- ストレージのスナップショット作成の前後に、カスタムシェルスクリプトとコマンドを実行するための RunBefore/RunAfter コマンドラインオプション。
プレビュー段階の機能:
- サービスプリンシパルのコンテンツを格納するための Azure Key Vault。
- 代替ストレージバックエンドとしての Azure マネージドディスク。
ANF クライアント API のバージョンが 2021-10-01 に更新されました。
Backint を処理するためのワークフローが変更され、スナップショットのために SAP HANA を一貫性のある状態にするときにエラーが発生した場合には、Backint 構成が再び有効になります。

AzAcSnap 6 インストーラーをダウンロードします。

2022 年 5 月

AzAcSnap v5.0.3 (Build: 20220524.14204) - v5.0.2 に更新プログラムを適用

AzAcSnap v5.0.3 (Build: 20220524.14204) は、次の修正により、v5.0 ブランチに修正プログラムとして提供されています:

SAP HANA のクエリ時に区切られた識別子を処理する問題を修正しました。この問題は、"logreplay_readaccss" で構成されたセカンダリノードがある場合にのみ、HSR-HA ノードの SAP HANA に影響を与えました。これは解決されました。

AzAcSnap v5.1 プレビュー (ビルド: 20220524.15550)

AzAcSnap v5.1 Preview (ビルド: 20220524.15550) は、プレビューの有効期限を 90 日間延長するための更新されたビルドです。この更新プログラムには、v5.0.3 で提供されている SAP HANA に対してクエリを実行するときに区切られた識別子を処理するための修正プログラムが含まれています。

2022 年 3 月

AzAcSnap v5.1 Preview (ビルド: 20220302.81795)

次の新機能がある AzAcSnap v5.1 プレビュー (ビルド: 20220302.81795) がリリースされました。

サービスプリンシパルを安全に格納するための Azure Key Vault サポート。
all パラメーター値を持つ、-c backup --volume の新しいオプション。

2022 年 2 月

AzAcSnap v5.1 Preview (Build: 20220220.55340)

AzAcSnap v5.1 プレビュー (ビルド: 20220220.55340) がリリースされ、次の修正と機能強化が行われました。

-c restore コマンドを使用して、--dbsid コマンドラインオプションと Oracle データベースの JSON 構成ファイルの sid エントリを照合するときのエラーを解決しました。

AzAcSnap v5.1 Preview (Build: 20220203.77807)

AzAcSnap v5.1 プレビュー (ビルド: 20220203.77807) がリリースされ、次の修正と機能強化が行われました。

STDOUT バッファーの制限を解決するためのマイナーアップデート。アーカイブモードになった Oracle テーブルファイルの一覧が、メインの AzAcSnap ログファイルに出力される代わりに、外部ファイルに送信されるようになりました。外部ファイルは、ログファイルと同じ場所にあり、同じベース名です。ただし、拡張子は「.protected-tables」となります (出力ファイル名は AzAcSnap ログファイルに詳しく記載されています)。このファイルは、azacsnap が実行するたびに上書きされます。

2022 年 1 月

AzAcSnap v5.1 Preview (Build: 20220125.85030)

次の新機能がある AzAcSnap v5.1 プレビュー (ビルド: 20220125.85030) がリリースされました。

Oracle Database のサポート
Backint との共存
Azure マネージドディスク
RunBefore および RunAfter 機能

2021 年 8 月

AzAcSnap v5.0.2 (ビルド: 20210827.19086) - v5.0.1 に更新プログラムを適用

v5.0 ブランチに更新プログラムが適用され、次の修正と機能強化を含む AzAcSnap v5.0.2 (ビルド: 20210827.19086) が提供されました。

ssh 255 終了コードを無視します。場合によって、Azure Large Instances 上のストレージとの通信に使用される ssh コマンドによって、エラーまたは実行エラーが発生しなかったときに、255 という終了コードが生成されることがあります (man ssh "EXIT STATUS" を参照)。その後、AzAcSnap はこの終了コードを失敗としてトラップし、中止します。この更新プログラムでは、正しい実行を検証するために追加の検証が行われます。この検証には、従来の終了コードチェックに加えて、エラーの ssh STDOUT と STDERR の解析が含まれます。
インストーラーによる hdbuserstore の場所のチェックが修正されました。インストーラーは、インストールを実行しているユーザーの hdbuserstore の場所を示す誤ったソースディレクトリのファイルシステムを検索します - インストーラーは、 ~/.hdbを検索するようになりました。この修正プログラムは、 azacsnap をインストールする前に、 root ユーザーに対して hdbuserstore が事前構成されたシステム (例えば、Azure Large Instance など) に適用されます。
インストーラーによってインストールまたは抽出されるバージョンが、表示されるようになりました (インストーラーが引数なしで実行されている場合)。

2021年5月

AzAcSnap v 5.0.1 (ビルド: 20210524.14837) ‐ バージョン 5.0 に更新プログラムを適用

AzAcSnap v 5.0.1 (ビルド: 20210524.14837) は、次の修正と機能強化により、v5.0 ブランチに修正プログラムとして提供されています。

終了コードの処理が改善されました。これまでは、実行エラーの後、終了コードが 0 以外であるべきときであっても、AzAcSnap から終了コード 0 (ゼロ) が生成されるケースがありました。終了コードは、azacsnap が正常に実行された場合は 0 になり、エラーが発生した場合は 0 以外になる必要があります。
AzAcSnap の内部エラー処理が拡張され、AzAcSnap によって実行された外部コマンドの終了コードがキャプチャされ、出力されるようになりました。

2021 年 4 月

AzAcSnap v5.0 (ビルド: 20210421.6349) - GA リリース (2021 年 4 月 21 日)

AzAcSnap v5.0 (ビルド: 20210421.6349) が一般公開され、このビルドで次の修正と改善が加えられました。

(SAP HANA からの応答を待機するための) hdbsql の再試行タイムアウトは、競合状態を避けるために、"savePointAbortWaitSeconds" の半分に自動的に設定されます。 "savePointAbortWaitSeconds" の設定は、JSON 構成ファイル内で直接変更できます。この値は 600 秒以上にする必要があります。

2021 年 3 月

AzAcSnap v5.0 Preview (ビルド: 20210318.30771)

AzAcSnap v5.0 Preview (ビルド: 20210318.30771) がリリースされ、次の修正と機能強化が行われました。

SAP HANA テナント DB に AZACSNAP ユーザーを追加する必要がなくなりました。「データベースとの通信を有効にする」セクションを参照してください。
手動による QOS で構成されたボリュームを使用した復元を許可するように修正しました。
Azure Large Instances の SSH 接続を抑えるためのミューテックス制御を追加しました。
スペースを含むパス名およびその他の関連する問題を処理するためにインストーラーを修正しました。
他のデータベースサーバーをサポートする準備のために、省略可能なパラメーター "--hanasid" を "--dbsid" に変更しました。

次の方法で共有

Azure アプリケーション整合性スナップショット ツールのリリース ノート