Azure アプリケーション整合性スナップショット ツールのリリース ノート
このページでは、新しい機能を提供したり欠陥を解決したりするために、AzAcSnap に加えられた主な変更を示します。
Linux または Windows 用のバイナリの最新リリースをダウンロードし、作業の開始方法を確認してください。
プレビュー機能に関する特定の情報については、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
コマンドを使用して新しい構成ファイルを作成し、既存の構成ファイルの値を使用します。
- AzAcSnap 10 より前の構成をアップグレードするには、
- 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 インストーラー。
Linux 用 AzAcSnap 10 または Windows 用 AzAcSnap 10 のバイナリをダウンロード。
2024 年 4 月
AzAcSnap 9a (ビルド: 1B3B458)
AzAcSnap 9a は、次の修正と機能強化を備えてリリースされています:
- 修正と機能強化:
- Azure ソブリン クラウドで動作できるように、AzAcSnap に Azure 管理エンドポイントを手動で構成できるようなりました。
.azacsnaprc
ファイル内で使用する、または適切な Azure 管理エンドポイントに設定された環境変数として使用するグローバルオーバーライド変数AZURE_MANAGEMENT_ENDPOINT
を追加しました。 構成の詳細については、AzAcSnap の動作を制御するためのグローバル オーバーライド設定を参照してください。
- Azure ソブリン クラウドで動作できるように、AzAcSnap に Azure 管理エンドポイントを手動で構成できるようなりました。
AzAcSnap 9a インストーラーをダウンロードします。
2023 年 8 月
AzAcSnap 9 (Build: 1AE5640)
AzAcSnap 9 は、次の修正と機能強化を使用してリリースされています:
- GA (一般提供) に移行される機能:
- IBM Db2 Database のサポート。
- システム マネージド ID のサポートにより、セキュリティ体制を改善しながらセットアップが容易になります。
- 修正と機能強化:
- 構成 (
-c configure
) の変更:- システム マネージド ID を使用する場合は、構成ファイル内の
authFile
に空白の値を指定できます。
- システム マネージド ID を使用する場合は、構成ファイル内の
- 構成 (
- プレビューに追加された機能:
- ありません。
- 削除された機能:
- 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 8 で
- 構成 (
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
でスナップショットの詳細を一覧表示する問題を修正しました。
- Azure Large Instance ストレージを使用する場合の
- ログ記録の機能強化:
- 障害が発生した場合の syslog (たとえば、
/var/log/messages
) への追加のログ出力。 - 実行されたコマンドの成功または失敗の結果をより解析可能な高レベルのコマンド ログを提供する新しい "mainlog" (
azacsnap.log
)
- 障害が発生した場合の syslog (たとえば、
- "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" に変更しました。