Konfigurera verktyget Konsekvent ögonblicksbild för Azure-program

2025-04-23

Den här artikeln visar hur du kör azacsnap -c configure kommandot för verktyget Azure Application Consistent Snapshot (AzAcSnap) som du kan använda med Azure NetApp Files.

Kommandon för konfigurationsfilen

Du kan skapa eller redigera konfigurationsfilen för AzAcSnap med hjälp azacsnap -c configure av kommandot . Kommandot har följande alternativ:

--configuration new för att skapa en ny konfigurationsfil
--configuration edit för att redigera en befintlig konfigurationsfil
[--configfile <config filename>] (valfri parameter) för att tillåta anpassade filnamn för konfiguration

Som standard är namnet på konfigurationsfilen azacsnap.json. Du kan använda ett anpassat filnamn med parametern --configfile= (till exempel --configfile=<customname>.json).

I följande exempel skapas en konfigurationsfil för en Konfiguration av stora Azure-instanser:

azacsnap -c configure --configuration new

Exempel för SAP HANA med Azure NetApp Files-lagring

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

Exempel för SAP HANA med 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'.

Nödvändiga värden för konfigurationsfilen

Följande avsnitt innehåller detaljerad vägledning om nödvändiga värden för databasavsnittet i konfigurationsfilen.

När du lägger till en SAP HANA-databas i konfigurationen krävs följande värden:

HANA SID (JSON-nyckel: sid): SAP HANA-system-ID (SID).
HANA Instance Number (JSON-nyckel: instanceNumber): SAP HANA-instansnumret.
HANA HDB User Store Key (JSON-nyckel: hdbUserStoreName): SAP HANA-nyckeln enligt hdbuserstore List kommandot som använder nyckeln för att länka ANVÄNDAREN med behörighet att köra databassäkerhetskopior till ENV (värdnamn och port). Avsnittet Aktivera kommunikation med databas innehåller ytterligare information och exempel.
HANA Server's Address (JSON-nyckel: serverAddress): SAP HANA-serverns värdnamn eller IP-adress.
Do you need AzAcSnap to automatically disable/enable backint during snapshot: Standardvärdet är n (nej). Du kan ställa in den på y (ja) så att AzAcSnap kan inaktivera eller återaktivera Backint-gränssnittet. I avsnittet Om samexistens i Backint i den här artikeln beskrivs det här alternativet mer detaljerat.
HANA Server's Address Bör vara något av följande:
- Enskild nod : Nodens värdnamn och IP-adress.
- HSR med STONITH : Värdnamn och IP-adress för noden.
- Utskalning (N+N, N+M) : Huvudnodens aktuella värdnamn och IP-adress.
- HSR utan STONITH : Värdnamn och IP-adress för noden.
- Multi-SID på enskild nod : Värdnamn och IP-adress för noden som är värd för dessa SID:er.

Samexistens i backint

Azure Backup-tjänsten tillhandahåller ett alternativt säkerhetskopieringsverktyg för SAP HANA. Du kan strömma databas- och loggsäkerhetskopior till Azure Backup.

Vissa kunder vill kombinera strömmande Backint-baserade säkerhetskopior med regelbundna ögonblicksbildsbaserade säkerhetskopior. Backint-baserade säkerhetskopior blockerar dock andra säkerhetskopieringsmetoder, till exempel att använda en filbaserad säkerhetskopia eller en ögonblicksbildsbaserad säkerhetskopia för lagring (till exempel AzAcSnap). Mer information finns i Köra sap hana-inbyggda klienter säkerhetskopiering på en databas med Azure Backup.

Processen som beskrivs i Azure Backup-dokumentationen har implementerats med AzAcSnap för att automatiskt göra följande steg:

Framtvinga en loggsäkerhetskopia till Backint.
Vänta tills säkerhetskopieringarna har körts.
Inaktivera den Backint-baserade säkerhetskopieringen.
Placera SAP HANA i ett konsekvent tillstånd för säkerhetskopiering.
Ta en ögonblicksbildsbaserad säkerhetskopia för lagring.
Släpp SAP HANA.
Återaktivera den Backint-baserade säkerhetskopieringen.

Det här alternativet är inaktiverat som standard. Du kan aktivera det genom att azacsnap -c configure –configuration edit köra y och svara (ja) på frågan Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n].

När du redigerar konfigurationen enligt beskrivningen autoDisableEnableBackint anges värdet till true i JSON-konfigurationsfilen (till exempel azacsnap.json). Det går också att ändra det här värdet genom att redigera konfigurationsfilen direkt.

När du lägger till en Oracle-databas i konfigurationen krävs följande värden:

Oracle DB Server's Address (JSON-nyckel: serverAddress): Databasserverns värdnamn eller IP-adress.
SID (JSON-nyckel: sid): Databassystem-ID.
Oracle Connect String (JSON-nyckel: connectString): Strängen som sqlplus använder för att ansluta till Oracle och aktivera eller inaktivera säkerhetskopieringsläge.

När du lägger till en Db2-databas i konfigurationen krävs följande värden:

Db2 Server's Address (JSON-nyckel: serverAddress): Databasserverns värdnamn eller IP-adress.

Om Db2 Server Address (serverAddress) matchar 127.0.0.1 eller localhostkör ögonblicksbildsverktyget alla db2 kommandon lokalt. Annars använder serverAddress ögonblicksbildsverktyget som värd för att ansluta till via Secure Shell (SSH) med hjälp Instance User av värdet som SSH-inloggningsnamn.

Du kan verifiera fjärråtkomst via SSH med hjälp ssh <instanceUser>@<serverAddress>av . Ersätt <instanceUser> och <serverAddress> med respektive värden.
Instance User (JSON-nyckel: instanceUser): Instansanvändaren för databassystemet.
SID (JSON-nyckel: sid): Databassystem-ID.

Viktigt!

Inställningen Db2 Server Address (serverAddress) justeras direkt med den metod som används för att kommunicera med Db2. Se till att du ställer in den korrekt, enligt beskrivningen.

När du lägger till en Microsoft SQL Server-databas i konfigurationen krävs följande värden:

connectionString (JSON-nyckel: connectionString) = Anslutningssträngen som används för att ansluta till databasen. För en typisk AzAcSnap-installation på det system som kör Microsoft SQL Server där databasinstansen MSSQL2022 anslutningssträng = "Trusted_Connection=True; Spara säkerhetsinformation=Sant; Datakälla=MSSQL2022; TrustServerCertificate=true".
instanceName (JSON-nyckel: instanceName) = Namnet på databasinstansen.
metaDataFileLocation (JSON-nyckel: metaDataFileLocation) = Platsen där Microsoft SQL Server ska skriva ut filen med metadata för säkerhetskopiering (till exempel "C:\MSSQL_BKP\").

Stora Azure-instanser (utan operativsystem)
Azure NetApp Files (med en virtuell dator)

När du lägger till Azure Large Instances-lagring i ett databasavsnitt krävs följande värden:

Storage Certificate File (JSON-nyckel: certificateFile): Certifikatfilen som används för att autentisera till lagringsserverdelen.
Storage ResourceId (JSON-nyckel: resourceUri): Den fullständiga URI:n för resursen, som börjar med värdnamnet (till exempel <hostname>/api/storage/volumes/<UUID>)
Storage Resource Name (JSON-nyckel: resourceName): Resursens "egna" namn (till exempel vol01)
Storage Resource Type (JSON-nyckel: resourceType): Resurstypen, "volymer" eller "konsekvensgrupper".

När du lägger till Azure NetApp Files-lagring i ett databasavsnitt krävs följande värden:

Service Principal Authentication filename (JSON-nyckel: authFile):
- Om du vill använda en systemhanterad identitet lämnar du fältet tomt utan värde och väljer sedan returnyckeln för att gå till nästa fält.
  
  Ett exempel på hur du konfigurerar en systemhanterad Azure-identitet finns i Installera verktyget Azure Application Consistent Snapshot.
- Om du vill använda tjänstens huvudnamn använder du namnet på autentiseringsfilen (till exempel authfile.json) som genereras i Azure Cloud Shell när du konfigurerar kommunikation med Azure NetApp Files Storage.
  
  Ett exempel på hur du konfigurerar tjänstens huvudnamn finns i Installera verktyget Konsekvent ögonblicksbild för Azure-program.
Full ANF Storage Volume Resource ID (JSON-nyckel: resourceId): Det fullständiga resurs-ID:t för volymen som är ögonblicksbild. Du kan hämta den här strängen genom att gå till Azure-portalen och sedan väljaVolyminställningar> för Azure NetApp Files> ellerResurs-IDför egenskaper>.

Exempelkonfigurationsfil

Följande utdata är endast en exempelkonfigurationsfil. Det här exemplet är resultatet av SAP HANA med Azure NetApp Files-lagringsexemplet.

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

Kommentar

För ett haveriberedskapsscenario (DR) där du kör säkerhetskopior på DR-platsen bör HANA-servernamnet som har konfigurerats i DR-konfigurationsfilen (till exempel DR.json) på DR-platsen vara samma som namnet på produktionsservern.

Nästa steg

Testa verktyget Azure Application Consistent Snapshot

Feedback

Var den här sidan till hjälp?