Notes de publication pour l'outil Azure Application Consistent Snapshot

Cette page répertorie les principales modifications apportées à AzAcSnap pour fournir de nouvelles fonctionnalités ou résoudre les défauts.

Téléchargez la version la plus récente du programme d’installation et consultez la procédure de démarrage.

Pour des informations spécifiques sur les fonctionnalités de la préversion, consultez la page AzAcSnap Preview.

Avril-2024

AzAcSnap 9a (Build : 1B3B458)

AzAcSnap 9a est mise en production avec les correctifs et améliorations suivants :

  • Correctifs et améliorations :
    • AzAcSnap autorisé à avoir des points de terminaison de gestion Azure configurés manuellement pour qu’elle fonctionne dans des clouds souverains Azure.

Téléchargez le programme d’installation AzAcSnap 9a.

Août-2023

AzAcSnap 9 (Build : 1AE5640)

AzAcSnap 9 est mise en production avec les correctifs et améliorations suivants :

  • Fonctionnalités passées en disponibilité générale :
    • Prise en charge de Base de données IBM Db2.
    • Prise en charge des Identités managées par le système pour bénéficier d’une configuration simplifiée tout en améliorant la posture de sécurité.
  • Correctifs et améliorations :
    • Configuration des modifications (-c configure) :
      • Autorise une valeur vide pour authFile dans le fichier config lors de l’utilisation d’identités managées par le système.
  • Fonctionnalités ajoutées à la préversion :
    • Aucune.
  • Fonctionnalités supprimées :
    • Suppression de la prise en charge d’Azure Key Vault de la Préversion. Elle n’est pas nécessaire dès lors qu’AzAcSnap prend en charge une identité managée par le système directement.

Téléchargez le programme d’installation AzAcSnap 9.

Juin-2023

AzAcSnap 8b (Build : 1AD3679)

AzAcSnap 8b est mise en production avec les correctifs et améliorations suivants :

  • Correctifs et améliorations :
    • Amélioration générale des codes de sortie de commande azacsnap.
      • azacsnap doit retourner un code de sortie de 0 (zéro) lors d’une exécution attendue, doit retourner un code de sortie différent de zéro dans le cas contraire. Par exemple, l’exécution de azacsnap retourne une valeur différente de zéro, car aucune action n’est à effectuer, et affiche des informations sur l’utilisation. Quant à azacsnap -h, il retourne un code de sortie de zéro, car il fonctionne comme prévu en retournant des informations sur l’utilisation.
      • Toute défaillance dans --runbefore provoque une sortie avant toute activité de sauvegarde et retourne le code de sortie --runbefore.
      • Toute défaillance dans --runafter retourne le code de sortie --runafter.
    • Modifications de la sauvegarde (-c backup) :
      • Modification apportée dans le workflow Db2 pour déplacer la requête des chemin d’accès protégés en dehors de WRITE SUSPEND, Capture instantané de stockage et du workflow RESUME pour améliorer la résilience. (Préversion)
      • Correctif du nom de capture instantanée manquant (azSnapshotName) dans l’environnement de commande --runafter.

Téléchargez le programme d’installation AzAcSnap 8b.

Mai-2023

AzAcSnap 8a (Build : 1AC55A6)

AzAcSnap 8a est mise en production avec les correctifs et améliorations suivants :

  • Correctifs et améliorations :
    • Configuration des modifications (-c configure) :
      • Correctif pour les modifications liées à -c configure dans AzAcSnap 8.
      • Aide améliorée sur le workflow pour une meilleure expérience client.

Téléchargez le programme d’installation AzAcSnap 8a.

AzAcSnap 8 (Build : 1AC279E)

AzAcSnap 8 est mise en production avec les correctifs et améliorations suivants :

  • Correctifs et améliorations :
    • Modifications de la restauration (-c restore) :
      • Nouvelle possibilité d’utiliser -c restore dans --restore revertvolume pour Azure NetApp Files.
    • Modifications de la sauvegarde (-c backup) :
      • Correctif de sortie d’erreur incorrecte lors de l’utilisation de -c backup et que la base de données a été configurée « backint ».
      • Suppression de la conversion en minuscules pour l’option de changement de nom anfBackup uniquement en utilisant -c backup pour que le nom de capture instantanée conserve le cas de nom de volume.
      • Correctif lors de la création d’une capture instantanée, même si SAP HANA n’a pas été placé en mode de sauvegarde. Maintenant, même si SAP HANA ne peut pas être placé en mode de sauvegarde, AzAcSnap effectue une sortie immédiate avec une erreur.
    • Modifications détaillées (-c details) :
      • Correctif des détails de capture instantanée de liste avec -c details lors de l’utilisation du stockage Azure Large Instance.
    • Améliorations des journalisations :
      • Sortie de journalisation supplémentaire dans syslog (par exemple, /var/log/messages) en cas de défaillance.
      • Nouveau « mainlog » (azacsnap.log) pour fournir un journal de haut niveau plus analysable des commandes exécutées avec un résultat d’échec ou de réussite.
    • Nouveau fichier de paramètres global (.azacsnaprc) pour contrôler le comportement d’AzAcSnap, notamment l’emplacement du fichier « mainlog ».

Téléchargez le programme d’installation AzAcSnap 8.

Fév-2023

AzAcSnap 7a (Build : 1AA8343)

AzAcSnap 7 est mise en production avec les correctifs et améliorations suivants :

  • Correctifs pour les commandes -c restore :
    • Activation des volumes de montage sur HLI (BareMetal) quand les volumes sont reviennent à l’état précédent lors de l’utilisation de -c restore --restore revertvolume.
    • Définition correcte de ThroughputMiBps sur des clones de volumes pour des volumes Azure NetApp Files dans un pool de capacités QoS automatique lors de l’utilisation de -c restore --restore snaptovol.

Téléchargez le programme d’installation AzAcSnap 7a.

Décembre 2022

AzAcSnap 7 (Build : 1A8FDFF)

AzAcSnap 7 est publié avec les correctifs et améliorations suivants :

  • Correctifs et améliorations :
    • Modifications de la sauvegarde (-c backup) :
      • Suffixe raccourci ajouté au nom de l’instantané. Le précédent suffixe de 26 caractères de « YYYY-MM-DDThhhhss-nnnnnnnZ » était trop long. Le suffixe dispose désormais de 11 caractères hexadécimaux basés sur les millièmes d’une seconde depuis l’époque Unix pour éviter les collisions d’affectation de noms, F2D212540D5 par exemple.
      • Validation améliorée lors de la création d’instantanés afin d’éviter qu’elle échoue.
      • Le délai d’expiration lors de l’exécution du mécanisme AzAcSnap pour désactiver/activer backint (autoDisableEnableBackint=true) s’aligne désormais sur d’autres valeurs de délai d’expiration des opérations liées à SAP HANA.
      • Sauvegarde Azure autorise désormais les sauvegardes basées sur des captures instantanées tierces, sans impact sur les sauvegardes en streaming (également appelées « backint »). Par conséquent, la logique de détection « backint » AzAcSnap est réordonnée pour permettre la dépréciation future de cette fonctionnalité. Par défaut, ce paramètre est désactivé (autoDisableEnableBackint=false). Pour les clients qui se sont appuyés sur cette fonctionnalité pour prendre des captures instantanées avec AzAcSnap et qui utilisent Sauvegarde Azure, le fait de conserver cette valeur définie sur true signifie qu’AzAcSnap 7 continue à désactiver/activer backint. Comme ce paramètre n’est plus nécessaire pour Sauvegarde Azure, nous vous recommandons de tester les sauvegardes AzAcSnap avec la valeur autoDisableEnableBackint=false puis, si le test réussit, d’apporter la même modification dans votre déploiement de production.
    • Modifications de la restauration (-c restore) :
      • Possibilité de créer un suffixe personnalisé pour les clones de volume créés lors de l’utilisation de -c restore --restore snaptovol :
        • soit via la ligne de commande avec --clonesuffix <custom suffix>.
        • soit de façon interactive lors de l’exécution de la commande sans l’option --force.
      • Quand vous effectuez une opération --restore snaptovol sur ANF, le clone de volume hérite du nouveau paramètre « NetworkFeatures » du volume source.
      • Vous pouvez désormais effectuer une restauration s’il n’y a pas de volumes de données configurés. Seule une restauration des autres volumes est effectuée en utilisant la dernière capture instantanée des autres volumes (l’option --snapshotfilter s’applique seulement aux volumes de données).
      • Journalisation supplémentaire pour la commande -c restore afin de faciliter le débogage utilisateur.
    • Modifications des tests (-c test) :
      • Teste maintenant la gestion des instantanés pour tous les autres volumes et tous les volumes de données.
  • Fonctionnalités passées en disponibilité générale :
    • Aucune.
  • Fonctionnalités ajoutées à la préversion :
    • Prise en charge préliminaire de Sauvegarde Azure NetApp Files.
    • La base de données DB2 prend en charge l’ajout d’options pour configurer, tester et sauvegarder des instantanés IBM DB2 de façon cohérente dans une application.

Téléchargez le programme d’installation AzAcSnap 7.

Juillet 2022

AzAcSnap 6 (build : 1A5F0B8)

Important

AzAcSnap 6 apporte un nouveau modèle de publication pour AzAcSnap, en incluant dans une seule version des fonctionnalités en disponibilité générale entièrement prises en charge, et des fonctionnalités en préversion.

Depuis la mise en production d’AzAcSnap v5.0 en disponibilité générale en avril 2021, il y a eu huit versions d’AzAcSnap dans deux branches. Notre objectif avec le nouveau modèle de publication est de nous aligner sur la façon dont les composants Azure sont publiés. Cette modification permet de faire passer des fonctionnalités de la préversion à la disponibilité générale (sans avoir à déplacer une branche entière), et d’introduire de nouvelles fonctionnalités en préversion (sans avoir à créer une nouvelle branche). À partir d’AzAcSnap 6, nous aurons une branche unique avec des fonctionnalités en disponibilité générale entièrement prises en charge, et des fonctionnalités en préversion (soumises aux conditions générales de Microsoft pour les préversions). Il est important de noter que les clients ne peuvent pas utiliser accidentellement des fonctionnalités en préversion, mais qu’ils doivent les activer avec l’option de ligne de commande --preview. Par conséquent, la prochaine version, AzAcSnap 7, pourrait inclure des correctifs (si nécessaire) pour des fonctionnalités en disponibilité générale, des fonctionnalités actuellement en préversion qui passeront en disponibilité générale, ou de nouvelles fonctionnalités en préversion.

AzAcSnap 6 est publié avec les correctifs et améliorations suivants :

  • Fonctionnalités passées en disponibilité générale :
    • Prise en charge d’Oracle Database.
    • Intégration Backint pour travailler avec Sauvegarde Azure.
    • Options de ligne de commande RunBefore/RunAfter pour exécuter des scripts et commandes d’interpréteur de commandes personnalisés avant ou après avoir pris des instantanés de stockage.
  • Fonctionnalités en préversion :
    • Azure Key Vault pour stocker le contenu du principal de service.
    • Disque managé Azure en tant que backend de stockage alternatif.
  • API client ANF mise à jour vers la version 2021-10-01.
  • Modification du flux de travail de gestion de Backint afin de réactiver la configuration de Backint en cas d’échec lors de la mise de SAP HANA dans un état cohérent pour l’instantané.

Téléchargez le programme d’installation AzAcSnap 6.

mai 2022

AzAcSnap v5.0.3 (Build : 20220524.14204) – mise à jour corrective vers v5.0.2

AzAcSnap v5.0.3 (Build: 20220524.14204) est fourni en tant que mise à jour corrective de la branche v5.0 avec le correctif suivant :

  • Correctif de la gestion des identificateurs délimités lors de l’interrogation de SAP HANA. Ce problème a uniquement affecté SAP HANA dans le nœud HSR-HA quand il existe un nœud secondaire configuré avec « logreplay_readaccss ». Il est résolu.

AzAcSnap v5.1 en préversion (Build : 20220524.15550)

AzAcSnap v5.1 en préversion (Build : 20220524.15550) est une build mise à jour pour étendre la date d’expiration de la préversion de 90 jours. Cette mise à jour contient le correctif pour gérer les identificateurs délimités lors de l’interrogation de SAP HANA comme indiqué dans v5.0.3.

Mar-2022

AzAcSnap v5.1 Preview (Build : 20220302.81795)

AzAcSnap v5.1 Preview (Build : 20220302.81795) est mise en production avec les nouvelles fonctionnalités suivantes :

  • Prise en charge Azure Key Vault pour le stockage sécurisé du principal de service.
  • Nouvelle option pour -c backup --volume qui a all comme valeur de paramètre.

Févr. 2022

AzAcSnap v5.1 en préversion (Build : 20220220.55340)

AzAcSnap v5.1 Preview (Build : 20220220.55340) est mise en production avec les améliorations et correctifs suivants :

  • Résolution de l’échec de mise en correspondance de l’option de ligne de commande --dbsid avec l’entrée sid dans le fichier de configuration JSON pour les bases de données Oracle lors de l’utilisation de la commande -c restore.

AzAcSnap v5.1 Préversion (Build : 20220203.77807)

AzAcSnap v5.1 Preview (Build : 20220203.77807) est mise en production avec les améliorations et correctifs suivants :

  • Mise à jour mineure pour résoudre les limitations de tampon STDOUT. À présent, la liste des fichiers de table Oracle placés en mode archive est envoyée à un fichier externe au lieu d’être générée dans le fichier journal AzAcSnap principal. Le fichier externe est dans les mêmes emplacement et nom de base que le fichier journal, mais avec une extension « .protected-tables » (nom de fichier de sortie détaillé dans le fichier journal AzAcSnap). Il est remplacé à chaque exécution de azacsnap.

Janvier 2022

AzAcSnap v5.1 Préversion (Build : 20220125.85030)

AzAcSnap v5.1 Preview (Build : 20220125.85030) est mise en production avec les nouvelles fonctionnalités suivantes :

  • Prise en charge d’Oracle Database
  • Coexistence de Backint
  • Disque managé Azure
  • Capacité RunBefore et RunAfter

Août 2021

AzAcSnap v5.0.2 (Build : 20210827.19086) - Mise à jour corrective vers v5.0.1

AzAcSnap v5.0.2 (Build : 20210827.19086) est fourni en tant que mise à jour corrective de la branche v5.0 avec les correctifs et améliorations suivants :

  • Ignorez les codes de sortie 255 ssh. Dans certains cas, la commande ssh, qui permet de communiquer avec le stockage sur une grande instance Azure, émet un code de sortie de 255 lorsqu’il n’y a pas d’erreurs ou d’échecs d’exécution (voir « État de sortie » man ssh). Par la suite, AzAcSnap intercepte ce code de sortie comme un échec et abandonne. Avec cette mise à jour, une vérification supplémentaire est effectuée pour valider l’exécution correcte. Cette validation inclut la recherche d’erreurs dans STDOUT et STDERR ssh, en plus des contrôles de code de sortie traditionnels.
  • Corrigez la vérification de l’emplacement du hdbuserstore par le programme d’installation. Le programme d’installation recherchera un répertoire source incorrect dans le filesystem pour l’emplacement hdbuserstore de l’utilisateur exécutant l’installation. Le programme d’installation recherche maintenant ~/.hdb. Ce correctif s’applique aux systèmes (par exemple, Azure Large Instance) où la commande hdbuserstore a été préconfigurée pour l’utilisateur root avant l’installation de azacsnap.
  • Le programme d’installation affiche maintenant la version qu’il installe/extrait (si le programme d’installation est exécuté sans argument).

Mai-2021

AzAcSnap v 5.0.1 (Build : 20210524,14837) - Mise à jour corrective de v5.0

AzAcSnap v 5.0.1 (Build : 20210524,14837) est fournie en tant que mise à jour corrective de la branche v5.0 avec les correctifs et améliorations suivants :

  • Amélioration de la gestion du code de sortie. Dans certains cas, AzAcSnap émet un code de sortie égal à 0 (zéro), même après un échec d’exécution quand le code de sortie doit avoir une valeur différente de zéro. Les codes de sortie doivent désormais avoir la valeur zéro seulement si l’exécution de azacsnap s’est terminée avec succès, et une valeur différente de zéro en cas d’échec.
  • La gestion des erreurs interne d’AzAcSnap est étendue pour capturer et émettre le code de sortie des commandes externes exécutées par AzAcSnap.

Avril 2021

AzAcSnap v5.0 (Build : 20210421.6349) - Version GA (21 avril 2021)

AzAcSnap v5.0 (Build : 20210421.6349) a été mis en disposition générale. Cette build a bénéficié des correctifs et améliorations suivants :

  • Le délai de nouvelle tentative hdbsql (pour attendre une réponse de SAP HANA) est automatiquement défini sur la moitié du paramètre « savePointAbortWaitSeconds » pour éviter les situations de concurrence. Le paramètre « savePointAbortWaitSeconds » peut être modifié directement dans le fichier de configuration JSON et doit être au minimum de 600 secondes.

Mars 2021

AzAcSnap v5.0 Preview (Build : 20210318.30771)

AzAcSnap v5.0 Preview (Build : 20210318.30771) est mise en production avec les améliorations et correctifs suivants :

  • Suppression de la nécessité d’ajouter l’utilisateur AZACSNAP dans les bases de données des locataires SAP HANA ; voir la section Activer la communication avec la base de données.
  • Correctif pour autoriser une restauration avec des volumes configurés avec la QoS manuelle.
  • Ajout du contrôle mutex pour limiter les connexions SSH pour Azure Large Instance.
  • Correction du programme d’installation pour gérer les noms de chemin d’accès avec des espaces et d’autres problèmes connexes.
  • En vue de la prise en charge d’autres serveurs de base de données, le paramètre facultatif « --hanasid » a été remplacé par « --dbsid ».

Étapes suivantes