Konfigurieren des Tools für Azure-App lizenzierungskonsensige Momentaufnahme

2025-04-23

In diesem Artikel wird erläutert, wie Sie den azacsnap -c configure Befehl des Tools Azure-App lication Consistent Snapshot (AzAcSnap) ausführen, das Sie mit Azure NetApp Files verwenden können.

Befehle für die Konfigurationsdatei

Sie können die Konfigurationsdatei für AzAcSnap mithilfe des azacsnap -c configure Befehls erstellen oder bearbeiten. Der Befehl verfügt über folgende Optionen:

--configuration new so erstellen Sie eine neue Konfigurationsdatei
--configuration edit so bearbeiten Sie eine vorhandene Konfigurationsdatei
[--configfile <config filename>] (optionaler Parameter) für benutzerdefinierte Konfigurationsdateinamen zulassen

Standardmäßig ist der Name der Konfigurationsdatei azacsnap.json. Sie können einen benutzerdefinierten Dateinamen mit dem --configfile= Parameter verwenden (z. B --configfile=<customname>.json. ).

Im folgenden Beispiel wird eine Konfigurationsdatei für eine Azure Large Instances-Konfiguration erstellt:

azacsnap -c configure --configuration new

Beispiel für SAP HANA mit Azure NetApp Files Storage

+----------------------------------------------------------+
+  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'.

Beispiel für SAP HANA mit Azure Large Instance Storage

+----------------------------------------------------------+
+  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'.

Erforderliche Werte für die Konfigurationsdatei

In den folgenden Abschnitten finden Sie detaillierte Anleitungen zu den erforderlichen Werten für den Datenbankabschnitt der Konfigurationsdatei.

Wenn Sie der Konfiguration eine SAP HANA-Datenbank hinzufügen, sind die folgenden Werte erforderlich:

HANA SID (JSON-Schlüssel: sid): Die SAP HANA-System-ID (SID).
HANA Instance Number (JSON-Schlüssel: instanceNumber): Die SAP HANA-Instanznummer.
HANA HDB User Store Key (JSON-Schlüssel: hdbUserStoreName): Der SAP HANA KEY wie durch den hdbuserstore List Befehl dargestellt, der den KEY verwendet, um den BENUTZER mit Berechtigungen zum Ausführen von Datenbanksicherungen mit dem ENV (Hostname und Port) zu verknüpfen. Im Abschnitt "Kommunikation mit Datenbank aktivieren " finden Sie weitere Details und Beispiele.
HANA Server's Address (JSON-Schlüssel: serverAddress): Hostname oder IP-Adresse des SAP HANA-Servers.
Do you need AzAcSnap to automatically disable/enable backint during snapshot: Standardwert ist n (Nein). Sie können es auf y (ja) festlegen, damit AzAcSnap die Backint-Schnittstelle deaktivieren oder erneut aktivieren kann. Im Abschnitt "Koexistenz von Backint " in diesem Artikel wird diese Option ausführlicher erläutert.
Dies HANA Server's Address sollte eine der folgenden Sein:
- Einzelner Knoten : Hostname und IP-Adresse des Knotens.
- HSR mit STONITH : Hostname und IP-Adresse des Knotens.
- Skalieren (N+N, N+M): Aktueller Hostname und IP-Adresse des Masterknotens.
- HSR ohne STONITH : Hostname und IP-Adresse des Knotens.
- Mehrere SID auf einem einzelnen Knoten : Hostname und IP-Adresse des Knotens, der diese SIDs hosten.

Koexistenz mit Backint

Der Azure Backup-Dienst bietet ein alternatives Sicherungstool für SAP HANA. Sie können Datenbank streamen und Sicherungen bei Azure Backup protokollieren.

Einige Kunden möchten die backint-basierten Streamingsicherungen mit regulären snapshotbasierten Sicherungen kombinieren. Backint-basierte Sicherungen blockieren jedoch andere Sicherungsmethoden, z. B. die Verwendung einer dateienbasierten Sicherung oder einer auf Momentaufnahmen basierenden Speichersicherung (z. B. AzAcSnap). Weitere Informationen finden Sie unter Ausführen der sap HANA nativen Clients-Sicherung auf einer Datenbank mit Azure Backup.

Der Prozess, den die Azure Backup-Dokumentation beschreibt, wurde mit AzAcSnap implementiert, um die folgenden Schritte automatisch auszuführen:

Erzwingen sie das Löschen einer Protokollsicherung auf "Backint".
Warten Sie, bis Sicherungen ausgeführt werden.
Deaktivieren Sie die backint-basierte Sicherung.
Setzen Sie SAP HANA in einen konsistenten Zustand für die Sicherung.
Erstellen Sie eine snapshotbasierte Speichersicherung.
Veröffentlichen Sie SAP HANA.
Aktivieren Sie die backint-basierte Sicherung erneut.

Diese Option ist standardmäßig deaktiviert. Sie können es aktivieren, indem Sie die Frage azacsnap -c configure –configuration editausführen y und Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n] beantworten (ja).

Wenn Sie die Konfiguration wie beschrieben bearbeiten, wird der autoDisableEnableBackint Wert true in der JSON-Konfigurationsdatei festgelegt (z. B. azacsnap.json). Es ist auch möglich, diesen Wert durch direktes Bearbeiten der Konfigurationsdatei zu ändern.

Wenn Sie der Konfiguration eine Oracle-Datenbank hinzufügen, sind die folgenden Werte erforderlich:

Oracle DB Server's Address (JSON-Schlüssel: serverAddress): Hostname oder IP-Adresse des Datenbankservers.
SID (JSON-Schlüssel: sid): Die Datenbanksystem-ID.
Oracle Connect String (JSON-Schlüssel: connectString): Die Zeichenfolge, die verwendet, sqlplus um eine Verbindung mit Oracle herzustellen und den Sicherungsmodus zu aktivieren oder zu deaktivieren.

Wenn Sie der Konfiguration eine Db2-Datenbank hinzufügen, sind die folgenden Werte erforderlich:

Db2 Server's Address (JSON-Schlüssel: serverAddress): Hostname oder IP-Adresse des Datenbankservers.

Wenn Db2 Server Address (serverAddress) mit dem Momentaufnahmetool übereinstimmt 127.0.0.1 oder localhost, werden alle db2 Befehle lokal ausgeführt. Andernfalls verwendet serverAddress das Snapshot-Tool als Host, um eine Verbindung über Secure Shell (SSH) herzustellen, indem der Instance User Wert als SSH-Anmeldename verwendet wird.

Sie können den Remotezugriff über SSH mithilfe von ssh <instanceUser>@<serverAddress>SSH überprüfen. Ersetzen und <instanceUser><serverAddress> durch die entsprechenden Werte.
Instance User (JSON-Schlüssel: instanceUser): Der Instanzbenutzer für das Datenbanksystem.
SID (JSON-Schlüssel: sid): Die Datenbanksystem-ID.

Wichtig

Die Einstellung Db2 Server Address (serverAddress) wird direkt an der Methode ausgerichtet, die für die Kommunikation mit Db2 verwendet wird. Stellen Sie sicher, dass Sie sie wie beschrieben richtig festgelegt haben.

Beim Hinzufügen einer Microsoft SQL Server-Datenbank zur Konfiguration sind die folgenden Werte erforderlich:

connectionString (JSON-Schlüssel: connectionString) = Die Verbindungszeichenfolge, die zum Herstellen einer Verbindung mit der Datenbank verwendet wird. Für eine typische AzAcSnap-Installation auf dem System, auf dem Microsoft SQL Server ausgeführt wird, wobei die Datenbankinstanz MSSQL2022 die Verbindungszeichenfolge = "Trusted_Connection=True; Persist Security Info=True; Datenquelle=MSSQL2022; TrustServerCertificate=true".
instanceName (JSON-Schlüssel: instanceName) = Der Name der Datenbankinstanz.
metaDataFileLocation (JSON-Schlüssel: metaDataFileLocation) = Der Speicherort, an dem Microsoft SQL Server die Sicherungsmetadatendatei ausschreiben soll (z. B. "C:\MSSQL_BKP\").

Azure Large Instances (Bare Metal)
Azure NetApp Files (mit einem virtuellen Computer)

Wenn Sie azure Large Instances Storage zu einem Datenbankabschnitt hinzufügen, sind die folgenden Werte erforderlich:

Storage Certificate File (JSON-Schlüssel: certificateFile): Die Zertifikatdatei, die für die Authentifizierung beim Speicher-Back-End verwendet wird.
Storage ResourceId (JSON-Schlüssel: resourceUri): Der vollständige URI für die Ressource, beginnend mit dem Hostnamen (z. B <hostname>/api/storage/volumes/<UUID>. )
Storage Resource Name (JSON-Schlüssel: resourceName): Der Name der Ressource "friendly" (z. B vol01. )
Storage Resource Type (JSON-Schlüssel: resourceType): Der Ressourcentyp, "Volumes" oder "Konsistenzgruppen".

Wenn Sie azure NetApp Files-Speicher zu einem Datenbankabschnitt hinzufügen, sind die folgenden Werte erforderlich:

Service Principal Authentication filename (JSON-Schlüssel: authFile):
- Um eine vom System verwaltete Identität zu verwenden, lassen Sie dieses Feld ohne Wert leer, und wählen Sie dann die EINGABETASTE aus, um zum nächsten Feld zu wechseln.
  
  Ein Beispiel zum Einrichten einer vom System verwalteten Azure-Identität finden Sie unter Installieren des Azure Application Consistent Snapshot-Tools.
- Um einen Dienstprinzipal zu verwenden, verwenden Sie den Namen der Authentifizierungsdatei (z. B. authfile.json), die in Azure Cloud Shell generiert wird, wenn Sie die Kommunikation mit azure NetApp Files-Speicher konfigurieren.
  
  Ein Beispiel zum Einrichten eines Dienstprinzipals finden Sie unter Installieren des Azure Application Consistent Snapshot-Tools.
Full ANF Storage Volume Resource ID (JSON-Schlüssel: resourceId): Die vollständige Ressourcen-ID des Volumes, das Momentaufnahme ist. Sie können diese Zeichenfolge abrufen, indem Sie zum Azure-Portal wechseln und dann Azure NetApp Files>Volume>Settings or Properties>Resource ID auswählen.

Beispiel der Konfigurationsdatei

Die folgende Ausgabe ist nur eine Beispielkonfigurationsdatei, dieses Beispiel ist das Ergebnis des SAP HANA mit Azure NetApp Files-Speicherbeispiel.

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"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

Hinweis

Bei einem Notfallwiederherstellungsszenario, in dem Sie Sicherungen am DR-Standort ausführen, sollte der HANA-Servername, der in der DR-Konfigurationsdatei (z DR.json. B. ) am DR-Standort konfiguriert ist, mit dem Namen des Produktionsservers übereinstimmen.

Nächste Schritte

Testen des Azure Application Consistent Snapshot-Tools

Feedback

War diese Seite hilfreich?