Avamar : Avtar échoue lorsque le script Run-at-Start renvoie un code de sortie autre que zéro

Échecs de sauvegarde lors de l’utilisation d’un script d’exécution au démarrage

Les sauvegardes ne se terminent pas lorsqu’un script d’exécution au démarrage personnalisé est configuré pour avtar.

• Les logs Avtar indiquent qu’il est renvoyé à partir du script run-at-start avec un code de sortie différent de zéro.
• Les procédures de sauvegarde sont marquées comme étant en échec.
• La désactivation du script d’exécution au démarrage permet à la sauvegarde de réussir.

avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Code de sortie incorrect du script Run-at-Start

La sauvegarde échoue car le script d’exécution au démarrage personnalisé renvoie un code de sortie autre que 0 . Dans les environnements Linux/UNIX, 0 est la seule valeur qui indique la réussite. Avtar interprète toute valeur différente de zéro comme une défaillance de script, ce qui entraîne l’abandon du processus de sauvegarde.

• Le script a renvoyé un code de sortie 1 quel avtar consignée en tant qu’erreur.
• Avamar traite ce code de sortie différent de zéro comme une défaillance et arrête l’opération de sauvegarde.

Entrée de journal pertinente :

avtar Info : Back from run-at-start, exit code 1
avtar Error : Exiting avtar with run-at-start script failure 1

Correction des échecs du script d’exécution au démarrage avtar

Résolution étape par étape

Lorsqu’un script d’exécution au démarrage personnalisé renvoie un code de sortie différent de zéro, avtar traite la sauvegarde comme un échec. Suivez ces étapes pour vous assurer que le script renvoie 0 sur le succès.

• Localisez le script configuré pour la phase d’exécution au démarrage avtar (par exemple, /opt/avamar/etc/run_at_start.d/custom_script.sh ).
• Ouvrez le script dans un éditeur et vérifiez la logique qui détermine la réussite ou l’échec.
• À la fin du script, ajoutez ou modifiez l’instruction exit afin que la réussite de l’exécution se termine par exit 0 .
• Assurez-vous que tous les chemins d’erreur utilisent également des codes différents de zéro appropriés uniquement lorsqu’une véritable défaillance se produit.
• Enregistrez les modifications et définissez les autorisations exécutables si elles ne sont pas déjà définies.

Exemple de terminaison de script correcte :

#!/bin/bash
# Your custom logic here

if [ $? -eq 0 ]; then
    echo "Custom script completed successfully"
    exit 0
else
    echo "Custom script encountered an error"
    exit 1
fi

Valider le script localement

Exécutez le script manuellement et vérifiez qu’il se ferme avec 0 .

$ /opt/avamar/etc/run_at_start.d/custom_script.sh
Custom script completed successfully
$ echo $?
0

Redémarrez avtar et déclenchez une sauvegarde.

Après confirmation du retour du script 0, redémarrez le service avtar et lancez une procédure de sauvegarde pour vérifier le fonctionnement normal.

# Restart avtar service
$ systemctl restart avtar

# Initiate a test backup (replace and as needed)
$ avtar -c -p -b

Confirmez la résolution.

Vérifiez l’absence du message d’erreur dans le journal avtar "Exiting avtar with run‑at‑start script failure 1." Une entrée de journal réussie ressemble à ce qui suit :

[2025-10-09 12:34:56] INFO avtar Info : Back from run-at-start, exit code 0
[2025-10-09 12:35:10] INFO Backup completed successfully