Avamar: Avtar falla cuando el script de ejecución al inicio devuelve un código de salida distinto de cero

Fallas de respaldo cuando se utiliza un script de ejecución al inicio

Los respaldos no se completan cuando se configura un script personalizado de ejecución al inicio para avtar.

• Los registros de Avtar indican que se devolvió desde el script de ejecución al inicio con un código de salida distinto de cero.
• Los trabajos de respaldo se marcan como fallidos.
• La deshabilitación del script de ejecución al inicio permite que el respaldo se realice correctamente.

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

Código de salida incorrecto del script de ejecución al inicio

El respaldo falla porque el script de ejecución al inicio personalizado devuelve un código de salida distinto de 0 . En entornos Linux/UNIX, 0 es el único valor que indica éxito. Avtar interpreta cualquier valor distinto de cero como una falla de script, lo que hace que se aborte el proceso de respaldo.

• El script devolvió un código de salida 1 cuál avtar registrado como un error.
• Avamar trata este código de salida distinto de cero como una falla y detiene la operación de respaldo.

Entrada de registro pertinente:

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

Corrección de fallas del script de ejecución al inicio de avtar

Resolución paso a paso

Cuando un script de ejecución al inicio personalizado devuelve un código de salida distinto de cero, avtar trata el respaldo como fallido. Siga estos pasos para asegurarse de que el script regrese 0 sobre el éxito.

• Busque el script configurado para la fase de ejecución al inicio de avtar (por ejemplo, /opt/avamar/etc/run_at_start.d/custom_script.sh ).
• Abra el script en un editor y verifique la lógica que determina el éxito o el fracaso.
• Al final del script, agregue o modifique la exit statement para que una ejecución correcta termine con exit 0 .
• Asegúrese de que las rutas de error también utilicen códigos distintos de cero adecuados solo cuando se produzca una falla genuina.
• Guarde los cambios y establezca permisos ejecutables si aún no están configurados.

Ejemplo de una terminación de script adecuada:

#!/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

Valide el script localmente

Ejecute el script manualmente y confirme que finalice con 0 .

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

Reinicie avtar y active un respaldo.

Después de confirmar, el script regresa 0, reinicie el servicio avtar e inicie un trabajo de respaldo para verificar el funcionamiento normal.

# Restart avtar service
$ systemctl restart avtar

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

Confirme la resolución.

Compruebe la ausencia del mensaje de error en el registro de avtar "Exiting avtar with run‑at‑start script failure 1." Una entrada de registro correcta se asemeja a lo siguiente:

[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