Avamar: avtar ha esito negativo quando lo script run-at-start restituisce codice di uscita diverso da zero
Summary: I backup hanno esito negativo quando viene utilizzato uno script run-at-start definito dall'utente perché lo script restituisce il codice di uscita 1; avtar tratta qualsiasi codice diverso da zero come un errore (ad esempio, "avtar Info: Di ritorno dalla corsa all'avvio, codice di uscita 1"). Correggere lo script per uscire da 0 per risolvere il problema. ...
Symptoms
Errori di backup quando si utilizza uno script run-at-start
I backup non vengono completati quando uno script Run-at-start personalizzato è configurato per avtar.
- I registri Avtar indicano che è stato restituito dallo script run-at-start con un codice di uscita diverso da zero.
- I processi di backup vengono contrassegnati come non riusciti.
- La disabilitazione dello script run-at-start consente al backup di avere esito positivo.
avtar Info : Back from run-at-start, exit code 1 avtar Error : Exiting avtar with run-at-start script failure 1
Cause
Codice di uscita non corretto dallo script Run-at-Start
Il backup ha esito negativo perché lo script run-at-start personalizzato restituisce un codice di uscita diverso da 0 . Negli ambienti Linux/UNIX, 0 è l'unico valore che indica l'esito positivo. Avtar interpreta qualsiasi valore diverso da zero come un errore di script, causando l'interruzione del processo di backup.
- Lo script ha restituito il codice di uscita
1cheavtarregistrato come errore. - Avamar considera questo codice di uscita diverso da zero come un errore e interrompe l'operazione di backup.
Voce di registro pertinente:
avtar Info : Back from run-at-start, exit code 1 avtar Error : Exiting avtar with run-at-start script failure 1
Resolution
Correzione degli errori dello script avtar run-at-start
Risoluzione dettagliata
Quando uno script run-at-start personalizzato restituisce un codice di uscita diverso da zero, avtar considera il backup come non riuscito. Seguire la procedura riportata di seguito per garantire la restituzione dello script 0 sul successo.
- Individuare lo script configurato per la fase avtar run-at-start (ad esempio,
/opt/avamar/etc/run_at_start.d/custom_script.sh). - Aprire lo script in un editor e verificare la logica che determina l'esito positivo o negativo.
- Al termine dello script, aggiungere o modificare l'istruzione exit in modo che un'esecuzione corretta termini con
exit 0. - Assicurarsi che tutti i percorsi di errore utilizzino anche codici diversi da zero appropriati solo quando si verifica un errore effettivo.
- Salvare le modifiche e impostare le autorizzazioni eseguibili se non sono già impostate.
Esempio di terminazione corretta dello script:
#!/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
Convalidare lo script in locale
Eseguire manualmente lo script e confermare che si chiude con 0 .
$ /opt/avamar/etc/run_at_start.d/custom_script.sh Custom script completed successfully $ echo $? 0
Riavviare avtar e attivare un backup.
Dopo la conferma, lo script restituisce 0, riavviare il servizio avtar e avviare un processo di backup per verificarne il normale funzionamento.
# Restart avtar service $ systemctl restart avtar # Initiate a test backup (replace and as needed) $ avtar -c -p -b
Confermare la risoluzione.
Controllare il registro avtar per verificare l'assenza del messaggio di errore "Exiting avtar with run‑at‑start script failure 1." Una voce di registro corretta presenta quanto segue:
[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