Configurer l’outil Azure Application Consistent Snapshot

Article
10/24/2023

Cet article vous montre comment exécuter la azacsnap -c configure commande de l’outil Azure Application Consistent Snapshot Tool (AzAcSnap) que vous pouvez utiliser avec Azure NetApp Files.

Commandes pour le fichier de configuration

Vous pouvez créer ou modifier le fichier de configuration pour AzAcSnap à l’aide de la azacsnap -c configure commande. La commande comporte les options suivantes :

--configuration new pour créer un fichier de configuration
--configuration edit pour modifier un fichier de configuration existant
[--configfile <config filename>] (paramètre facultatif) pour autoriser les noms de fichiers de configuration personnalisés

Par défaut, le nom du fichier de configuration est azacsnap.json. Vous pouvez utiliser un nom de fichier personnalisé avec le --configfile= paramètre (par exemple, --configfile=<customname>.json).

L’exemple suivant crée un fichier de configuration pour une configuration Azure Large Instances :

azacsnap -c configure --configuration new

Building new config file
Add comment to config file (blank entry to exit adding comments): This is a new config file for AzAcSnap 6
Add comment to config file (blank entry to exit adding comments):
Enter the database type to add, 'hana', 'oracle', or 'exit' (for no database): hana

=== Add SAP HANA Database details ===
HANA SID (e.g. H80): H80
HANA Instance Number (e.g. 00): 00
HANA HDB User Store Key (e.g. `hdbuserstore List`): AZACSNAP
HANA Server's Address (hostname or IP address): testing01
Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n]:

=== Azure NetApp Files Storage details ===
Are you using Azure NetApp Files for the database? (y/n) [n]:

=== Azure Managed Disk details ===
Are you using Azure Managed Disks for the database? (y/n) [n]:

=== Azure Large Instance (Bare Metal) Storage details ===
Are you using Azure Large Instance (Bare Metal) for the database? (y/n) [n]: y
--- DATA Volumes have the Application put into a consistent state before they are snapshot ---
Add Azure Large Instance (Bare Metal) resource to DATA Volume section of Database configuration? (y/n) [n]: y
Storage User Name (e.g. clbackup25): clt1h80backup
Storage IP Address (e.g. 192.168.1.30): 172.18.18.11
Storage Volume Name (e.g. hana_data_soldub41_t250_vol): hana_data_h80_testing01_mnt00001_t020_vol
Add Azure Large Instance (Bare Metal) resource to DATA Volume section of Database configuration? (y/n) [n]: n
--- OTHER Volumes are snapshot immediately without preparing any application for snapshot ---
Add Azure Large Instance (Bare Metal) resource to OTHER Volume section of Database configuration? (y/n) [n]: n

Enter the database type to add, 'hana', 'oracle', or 'exit' (for no database): exit


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

Valeurs requises pour le fichier de configuration

Les sections suivantes fournissent des instructions détaillées sur les valeurs requises pour la section base de données du fichier de configuration.

Lorsque vous ajoutez une base de données SAP HANA à la configuration, les valeurs suivantes sont requises :

HANA Server's Address: nom d’hôte ou adresse IP du serveur SAP HANA.
HANA SID: ID système SAP HANA (SID).
HANA Instance Number: numéro d’instance SAP HANA.
HANA HDB User Store Key: utilisateur SAP HANA configuré avec des autorisations pour exécuter des sauvegardes de base de données.
Do you need AzAcSnap to automatically disable/enable backint during snapshot: valeur par défaut n (non). Vous pouvez le définir y sur (oui) pour autoriser AzAcSnap à désactiver ou réactiver l’interface Backint. La section de coexistence Backint de cet article explique cette option plus en détail.
Single node: nom d’hôte et adresse IP du nœud.
HSR with STONITH: nom d’hôte et adresse IP du nœud.
Scale-out (N+N, N+M): nom d’hôte actuel et adresse IP du nœud maître.
HSR without STONITH: nom d’hôte et adresse IP du nœud.
Multi SID on Single node: nom d’hôte et adresse IP du nœud qui héberge ces SID.

Coexistence de backint

Le service Sauvegarde Azure fournit un autre outil de sauvegarde pour SAP HANA. Vous pouvez diffuser en continu des sauvegardes de base de données et de journal dans Sauvegarde Azure.

Certains clients souhaitent combiner les sauvegardes backint en continu avec des sauvegardes régulières basées sur des instantané. Toutefois, les sauvegardes basées sur Backint bloquent d’autres méthodes de sauvegarde, telles que l’utilisation d’une sauvegarde basée sur des fichiers ou d’une sauvegarde basée sur des instantané de stockage (par exemple, AzAcSnap). Pour plus d’informations, consultez Exécuter la sauvegarde de clients natifs SAP HANA sur une base de données avec Sauvegarde Azure.

Le processus décrit par la documentation Sauvegarde Azure a été implémenté avec AzAcSnap pour effectuer automatiquement les étapes suivantes :

Forcez un vidage de sauvegarde de journal sur Backint.
Attendez que les sauvegardes en cours d’exécution se terminent.
Désactivez la sauvegarde backint.
Placez SAP HANA dans un état cohérent pour la sauvegarde.
Effectuez une sauvegarde basée sur le stockage instantané.
Publiez SAP HANA.
Réactivez la sauvegarde backint.

Par défaut, cette option est désactivée. Vous pouvez l’activer en exécutant azacsnap -c configure –configuration edit et en y répondant (oui) à la question Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n].

La modification de la configuration comme décrit définit la autoDisableEnableBackint valeur true dans le fichier de configuration JSON (par exemple, azacsnap.json). Il est également possible de modifier cette valeur en modifiant directement le fichier de configuration.

Lorsque vous ajoutez une base de données Db2 à la configuration, les valeurs suivantes sont requises :

Db2 Server's Address: nom d’hôte ou adresse IP du serveur de base de données.

Si Db2 Server Address (serverAddress) correspond 127.0.0.1 ou localhost, l’outil instantané exécute toutes les db2 commandes localement. Sinon, l’outil instantané utilise serverAddress comme hôte pour se connecter via Secure Shell (SSH), en utilisant la Instance User valeur comme nom de connexion SSH.

Vous pouvez valider l’accès à distance via SSH à l’aide de ssh <instanceUser>@<serverAddress>. Remplacez et <serverAddress> par <instanceUser> les valeurs respectives.
Instance User: utilisateur d’instance pour le système de base de données.
SID: ID système de base de données.

Important

Le paramètre Db2 Server Address (serverAddress) s’aligne directement sur la méthode utilisée pour communiquer avec Db2. Vérifiez que vous le définissez correctement, comme décrit.

Grandes instances Azure (nue)
Azure NetApp Files (avec une machine virtuelle)

Lorsque vous ajoutez le stockage Azure Large Instances à une section de base de données, les valeurs suivantes sont requises :

Storage User Name: nom d’utilisateur pour l’établissement de la connexion SSH au stockage.
Storage IP Address: adresse IP du système de stockage.

Storage Volume Name: nom du volume à instantané. Vous pouvez déterminer cette valeur de plusieurs façons. Une méthode simple consiste à utiliser la commande shell suivante :

grep nfs /etc/fstab | cut -f2 -d"/" | sort | uniq

hana_data_p40_soldub41_mnt00001_t020_vol
hana_log_backups_p40_soldub41_t020_vol
hana_log_p40_soldub41_mnt00001_t020_vol
hana_shared_p40_soldub41_t020_vol

Lorsque vous ajoutez le stockage Azure NetApp Files à une section de base de données, les valeurs suivantes sont requises :

Service Principal Authentication filename(Champ JSON : ) : authFile
- Pour utiliser une identité managée par le système, laissez ce champ vide sans valeur, puis sélectionnez la clé Entrée pour accéder au champ suivant.
  
  Pour obtenir un exemple de configuration d’une identité managée par le système Azure, consultez Installer l’outil Azure Application Consistent Snapshot.
- Pour utiliser un principal de service, utilisez le nom du fichier d’authentification (par exemple, authfile.json) généré dans Azure Cloud Shell lorsque vous configurez la communication avec le stockage Azure NetApp Files.
  
  Pour obtenir un exemple de configuration d’un principal de service, consultez l’outil Installer l’outil Azure Application Consistent Snapshot.
Full ANF Storage Volume Resource ID(Champ JSON : resourceId: ID de ressource complet du volume instantané. Vous pouvez récupérer cette chaîne en accédant au Portail Azure, puis en sélectionnant Le volume> Azure NetApp Files>Paramètres ou l’ID de ressource propriétés.>

Exemple de fichier de configuration

Dans l’exemple suivant, azacsnap.json est configuré avec le même SID.

Vous devez définir les valeurs des paramètres sur votre environnement SAP HANA spécifique. Pour un système Azure Large Instances, Microsoft Service Management fournit ces informations sous forme de fichier Excel pendant l’appel à l’intégration et au transfert. Ouvrez une demande de service si vous avez besoin de Microsoft Service Management pour renvoyer les informations.

La sortie suivante est un exemple de fichier de configuration uniquement. Il s’agit du contenu du fichier généré par l’exemple de configuration. Mettez à jour toutes les valeurs en conséquence.

cat azacsnap.json

{
  "version": "6",
  "logPath": "./logs",
  "securityPath": "./security",
  "comments": [
    "This is a new config file for AzAcSnap 6"
  ],
  "database": [
    {
      "hana": {
        "serverAddress": "testing01",
        "sid": "H80",
        "instanceNumber": "00",
        "hdbUserStoreName": "AZACSNAP",
        "savePointAbortWaitSeconds": 600,
        "autoDisableEnableBackint": false,
        "hliStorage": [
          {
            "dataVolume": [
              {
                "backupName": "clt1h80backup",
                "ipAddress": "172.18.18.11",
                "volume": "hana_data_h80_testing01_mnt00001_t020_vol"
              }
            ],
            "otherVolume": []
          }
        ],
        "anfStorage": [],
        "amdStorage": []
      },
      "oracle": null
    }
  ]
}

Remarque

Pour un scénario de récupération d’urgence dans lequel vous allez exécuter des sauvegardes sur le site de récupération d’urgence, le nom du serveur HANA configuré dans le fichier de configuration de récupération d’urgence (par exemple) DR.jsonsur le site de récupération d’urgence doit être identique au nom du serveur de production.

Pour les grandes instances Azure, votre adresse IP de stockage doit se trouver dans le même sous-réseau que votre pool de serveurs. Par exemple, dans ce cas, le sous-réseau du pool de serveurs est 172.18.18.0/24 et l’adresse IP de stockage affectée est 172.18.18.11.

Étapes suivantes

Tester l’outil Azure Application Consistent Snapshot