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

2025-04-23

この記事では、Azure NetApp Files で使用できる Azure アプリケーション整合性スナップショットツール (AzAcSnap) の azacsnap -c configure コマンドを実行する方法について説明します。

構成ファイルのコマンド

azacsnap -c configure コマンドを使用して、AzAcSnap の構成ファイルを作成または編集できます。コマンドには、次のオプションがあります。

--configuration new で新しい設定ファイルを作成する
--configuration edit で既存の構成ファイルを編集する
[--configfile <config filename>] (省略可能なパラメーター) でカスタム構成ファイル名を許可する

既定では、構成ファイルの名前は azacsnap.jsonです。カスタムファイル名は、--configfile= パラメーター (たとえば、--configfile=<customname>.json) と共に使用できます。

次の例では、Azure Large Instances 構成の構成ファイルを作成します。

azacsnap -c configure --configuration new

Azure NetApp Files ストレージを使用した SAP HANA の例

+----------------------------------------------------------+
+  For details on configuring AzAcSnap please visit        +
+          https://aka.ms/azacsnap-configure               +
+----------------------------------------------------------+
Building new config file

Q. Add comment #1 to config file (blank entry to exit adding comments)?
A. This is a new config file for AzAcSnap 11 with SAP HANA and Azure NetApp Files

Q. Add comment #2 to config file (blank entry to exit adding comments)?
A.

Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. hana

Checking for SAP HANA external program dependency 'hdbsql'
External dependency 'hdbsql' found.

=== Add SAP HANA details ===

Q. What is the SAP HANA SID (e.g. H80)?
A. H81

Q. What is the SAP HANA Instance Number (e.g. 00)?
A. 00

Q. What is the SAP HANA HDB User Store Key (e.g. `hdbuserstore List`)?
A. AZACSNAP

Q. What is the SAP HANA Server's Address (hostname or IP address)?
A. saphana1

Q. Do you need AzAcSnap to automatically disable/enable backint during snapshot?
   ('y' for yes, 'n' for no) [default='n']
A.

=== Add Hana Storage section ===

Q. Do you want to add Hana database Storage?
   ('y' for yes, 'n' for no)
A. y

--- DATA Volumes are specially prepared before they are snapshot ---

Q. Do you want to add Hana storage + DataVolume #1?
   ('y' for yes, 'n' for no)
A. y

Q. Do you want to add Hana storage + DataVolume #1 + Azure NetApp Files entry #1?
   ('y' for yes, 'n' for no)
A. y

Q. What is the Hana storage + DataVolume #1 + Azure NetApp Files entry #1 + ResourceId?
  (e.g. /subscriptions/.../resourceGroups/.../providers/Microsoft.NetApp/netAppAccounts/.../capacityPools/Premium/volumes/...)?
A. /subscriptions/99999999-9zz9-9z99-z9z9-z999z999zzz9/resourceGroups/saphanasystems/providers/Microsoft.NetApp/netAppAccounts/saphanaanf/capacityPools/Premium/volumes/HANADATA01

Q. What is the Hana storage + DataVolume #1 + Azure NetApp Files entry #1 + Service Principal AuthenticationFile
   (e.g. auth-file.json or <blank> if using Azure Managed ID)?
A.
Hana storage + DataVolume #1 + Azure NetApp Files entry #1 (added)


Q. Do you want to add Hana storage + DataVolume #1 + Azure NetApp Files entry #2?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Large Instance entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Managed Disk entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #2?
   ('y' for yes, 'n' for no)
A. n

--- OTHER Volumes are snapshot immediately (no special preparation) ---

Q. Do you want to add Hana storage + OtherVolume #1?
   ('y' for yes, 'n' for no)
A. n


Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. save


Editing configuration complete, writing output to 'azacsnap.json'.

Azure L インスタンスストレージを使用した SAP HANA の例

+----------------------------------------------------------+
+  For details on configuring AzAcSnap please visit        +
+          https://aka.ms/azacsnap-configure               +
+----------------------------------------------------------+
Building new config file

Q. Add comment #1 to config file (blank entry to exit adding comments)?
A. This is a new config file for AzAcSnap 11

Q. Add comment #2 to config file (blank entry to exit adding comments)?
A.

Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. hana

Checking for SAP HANA external program dependency 'hdbsql'
External dependency 'hdbsql' found.

=== Add SAP HANA details ===

Q. What is the SAP HANA SID (e.g. H80)?
A. H80

Q. What is the SAP HANA Instance Number (e.g. 00)?
A. 00

Q. What is the SAP HANA HDB User Store Key (e.g. `hdbuserstore List`)?
A. AZACSNAP

Q. What is the SAP HANA Server's Address (hostname or IP address)?
A. testing01

Q. Do you need AzAcSnap to automatically disable/enable backint during snapshot?
   ('y' for yes, 'n' for no) [default='n']
A.

=== Add Hana Storage section ===

Q. Do you want to add Hana database Storage?
   ('y' for yes, 'n' for no)
A. y

--- DATA Volumes are specially prepared before they are snapshot ---

Q. Do you want to add Hana storage + DataVolume #1?
   ('y' for yes, 'n' for no)
A. y

Q. Do you want to add Hana storage + DataVolume #1 + Azure NetApp Files entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Large Instance entry #1?
   ('y' for yes, 'n' for no)
A. y

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage Certificate File
   (e.g. svmadm_cert.p12)?
A. svm01.p12

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage ResourceId
   (e.g. <hostname>/api/storage/volumes/<UUID>)?
A. svm01/api/storage/volumes/0892dcdc-f760-11ee-a301-000c2989d71e

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage Resource Name
   (e.g. volume01)?
A. hana_data_01

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage Resource Type
   (e.g. volumes or consistency-groups)?
A. volumes
Hana storage + DataVolume #1 + Azure Large Instance entry #1 (added)


Q. Do you want to add Hana storage + DataVolume #1 + Azure Large Instance entry #2?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Managed Disk entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #2?
   ('y' for yes, 'n' for no)
A. n

--- OTHER Volumes are snapshot immediately (no special preparation) ---

Q. Do you want to add Hana storage + OtherVolume #1?
   ('y' for yes, 'n' for no)
A. n


Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. save


Editing configuration complete, writing output to 'azacsnap.json'.

構成ファイルに必要な値

次のセクションでは、構成ファイルのデータベースセクションに必要な値に関する詳細なガイダンスを提供します。

構成に "SAP HANA データベース" を追加する場合は、次の値が必要です。

HANA SID (JSON キー: sid): SAP HANA システム ID (SID)。
HANA Instance Number (JSON キー: instanceNumber): SAP HANA インスタンス番号。
HANA HDB User Store Key(JSON キー: hdbUserStoreName): コマンドで示されているように、SAP HANA KEY。このコマンドでは、データベースバックアップを ENV (ホスト名とポート) に実行するためのアクセス許可を持つユーザーをリンクします。「データベースとの通信を有効にする」セクションでは、詳細と例を示します。
HANA Server's Address (JSON キー: serverAddress): SAP HANA サーバーのホスト名または IP アドレス。
Do you need AzAcSnap to automatically disable/enable backint during snapshot: 既定値は n (いいえ) です。これを y (はい) に設定すると、AzAcSnap で Backint インターフェイスを無効にしたり、再度有効にしたりできます。この記事の Backint 共存セクションでは、このオプションについて詳しく説明します。
HANA Server's Addressは、次のいずれかである必要があります。
- 単一ノード: ノード のホスト名と IP アドレス。
- HSR と STONITH : ノードのホスト名と IP アドレス。
- スケールアウト (N+ N、N+M): マスターノードの現在のホスト名と IP アドレス。
- STONITH なしの HSR : ノードのホスト名と IP アドレス。
- 単一ノード上のマルチ SID : それらの SID をホストするノードのホスト名と IP アドレス。

Backint との共存

Azure Backup サービスには、SAP HANA 用の代替バックアップツールが用意されています。データベースバックアップとログバックアップを Azure Backup にストリーミングできます。

一部のお客様は、ストリーミングによる Backint ベースのバックアップと通常のスナップショットベースのバックアップを組み合わせることを希望します。ただし、Backint ベースのバックアップでは、ファイルベースのバックアップやストレージスナップショットベースのバックアップの使用 (例: AzAcSnap) など、他のバックアップ方法がブロックされます。詳細については、「Azure Backup を使用したデータベースでの SAP HANA ネイティブクライアントバックアップの実行」を参照してください。

Azure Backup のドキュメントで説明されているプロセスが、以下の手順を自動的に実行するために AzAcSnap で実装されています。

Backint へのログバックアップフラッシュを強制します。
実行中のバックアップが完了するまで待機します。
Backint ベースのバックアップを無効にします。
SAP HANA をバックアップのために一貫性のある状態にします。
ストレージスナップショットベースのバックアップを作成します。
SAP HANA をリリースします。
Backint ベースのバックアップを再度有効にします。

既定では、このオプションは無効になっています。これを有効にするには、azacsnap -c configure –configuration edit を実行し、質問 y に Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n] (はい) と回答します。

説明に従って構成を編集すると、JSON 構成ファイル (autoDisableEnableBackint など) 内の true 値がに設定されます。また、構成ファイルを直接編集することによって、この値を変更することもできます。

構成に "Oracle データベース" を追加する場合は、次の値が必要です。

Oracle DB Server's Address (JSON キー: serverAddress): データベースサーバーのホスト名または IP アドレス。
SID (JSON キー: sid): データベースシステム ID。
Oracle Connect String (JSON キー: connectString): sqlplus Oracle に接続し、バックアップモードを有効または無効にするために使用する文字列。

Db2 データベースを構成に追加する場合は、次の値が必要です。

Db2 Server's Address (JSON キー: serverAddress): データベースサーバーのホスト名または IP アドレス。

Db2 Server Address (serverAddress) が 127.0.0.1 または localhost と一致する場合、スナップショットツールはすべての db2 コマンドをローカルで実行します。それ以外の場合、スナップショットツールは、SSH ログイン名として serverAddress 値を使用して、Secure Shell (SSH) 経由で接続するホストとして Instance User を使用します。

ssh <instanceUser>@<serverAddress> を使用して、SSH 経由でリモートアクセスを検証できます。 <instanceUser> と <serverAddress> をそれぞれの値に置き換えます。
Instance User (JSON キー: instanceUser): データベースシステムのインスタンスユーザー。
SID (JSON キー: sid): データベースシステム ID。

重要

Db2 Server Address (serverAddress) の設定は、Db2 との通信に使用されるメソッドに直接合わせて調整されます。説明に従って正しく設定していることを確認してください。

構成に Microsoft SQL Server データベースを追加する場合は、次の値が必要です。

connectionString (JSON キー: connectionString)= データベースへの接続に使用される接続文字列。データベースインスタンスがMSSQL2022されている Microsoft SQL Server を実行しているシステムへの一般的な AzAcSnap インストールの場合、接続文字列 = "Trusted_Connection=True;Persist Security Info=True;Data Source=MSSQL2022;TrustServerCertificate=true"。
instanceName (JSON キー: instanceName)= データベースインスタンス名。
metaDataFileLocation (JSON キー: metaDataFileLocation)= Microsoft SQL Server がバックアップメタデータファイル ("C:\MSSQL_BKP\" など) を書き出す場所。

Azure L インスタンス (ベアメタル)
Azure NetApp Files (仮想マシンを使用)

Azure Large Instances ストレージをデータベースセクションに追加する場合は、次の値が必要です。

Storage Certificate File (JSON キー: certificateFile): ストレージバックエンドに対する認証に使用される証明書ファイル。
Storage ResourceId (JSON キー: resourceUri): ホスト名で始まるリソースの完全な URI (たとえば、 <hostname>/api/storage/volumes/<UUID>)
Storage Resource Name (JSON キー: resourceName): リソースの "フレンドリ" 名 (たとえば、 vol01)
Storage Resource Type (JSON キー: resourceType): リソースの種類、'volumes' または 'consistency-groups'。

Azure NetApp Files ストレージをデータベースセクションに追加する場合は、次の値が必要です。

Service Principal Authentication filename (JSON キー: authFile):
- システムマネージド ID を使用するには、このフィールドを値なしで空のままにし、Enter キーを選択して次のフィールドに移動します。
  
  Azure システムマネージド ID を設定する例については、「Azure アプリケーション整合性スナップショットツールのインストール」を参照してください。
- サービスプリンシパルを使用するには、Azure NetApp Files ストレージとの通信を構成するときに Azure Cloud Shell で生成される認証ファイル ( authfile.jsonなど) の名前を使用します。
  
  サービスプリンシパルを設定する例については、「 Azure アプリケーション整合性スナップショットツールのインストール」を参照してください。
Full ANF Storage Volume Resource ID (JSON キー: resourceId): スナップショットであるボリュームの完全なリソース ID。この文字列を取得するには、Azure portal に移動し、 Azure NetApp Files>Volume>Settings または Properties>Resource ID を選択します。

構成ファイルの例

次の出力は構成ファイルの例のみです。この例は、SAP HANA with Azure NetApp Files ストレージの例の結果です。

cat azacsnap.json

{
  "version": "11",
  "logPath": "./logs",
  "securityPath": "./security",
  "comments": [
    "This is a new config file for AzAcSnap 11 with SAP HANA and Azure NetApp Files"
  ],
  "database": [
    {
      "hana": {
        "serverAddress": "saphana1",
        "sid": "H81",
        "instanceNumber": "00",
        "hdbUserStoreName": "AZACSNAP",
        "savePointAbortWaitSeconds": 600,
        "autoDisableEnableBackint": false,
        "storage": [
          {
            "dataVolumes": [
              {
                "anfStorageVolumes": [
                  {
                    "resourceId": "/subscriptions/99999999-9zz9-9z99-z9z9-z999z999zzz9/resourceGroups/saphanasystems/providers/Microsoft.NetApp/netAppAccounts/saphanaanf/capacityPools/Premium/volumes/HANADATA01",
                    "authFile": "",
                    "subscription": "99999999-9zz9-9z99-z9z9-z999z999zzz9",
                    "resourceGroupName": "saphanasystems",
                    "accountName": "saphanaanf",
                    "poolName": "Premium",
                    "volume": "HANADATA01"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

注

DR サイトでバックアップを実行するディザスターリカバリー (DR) シナリオの場合、DR サイトの DR 構成ファイル (たとえば、DR.json) で構成されている HANA サーバー名は、運用サーバー名と同じである必要があります。

次のステップ

Azure アプリケーション整合性スナップショットツールをテストする

次の方法で共有

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

構成ファイルのコマンド

Azure NetApp Files ストレージを使用した SAP HANA の例

Azure L インスタンス ストレージを使用した SAP HANA の例

構成ファイルに必要な値

Backint との共存

構成 ファイルの例

次のステップ

フィードバック

その他のリソース

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

Azure L インスタンスストレージを使用した SAP HANA の例

構成ファイルの例