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

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

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 . Negli ambienti Linux/UNIX, è 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 che avtar registrato 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 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 .

$ /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

 

ATTENZIONE: Non ignorare i codici di uscita diversi da zero; Indicano errori autentici che devono essere corretti prima di procedere.
ATTENZIONE: La modifica errata dello script run-at-start può causare errori di backup per tutti i client che utilizzano tale policy. Testare prima le modifiche in un ambiente non di produzione.
NOTA: Se non si è in grado di modificare lo script o il problema persiste dopo l'applicazione dei passaggi precedenti, contattare il supporto Dell per ulteriore assistenza.

Affected Products

Avamar

Products

Avamar Client, Avamar Client for Linux, UNIX, MacOSX
Article Properties
Article Number: 000210566
Article Type: Solution
Last Modified: 23 Oct 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.