Avamar: O Avtar falha quando o script run-at-start retorna um código de saída diferente de zero

Falhas de backup ao usar um script run-at-start

Os backups não são concluídos quando um script personalizado de execução ao iniciar é configurado para avtar.

• Os logs do Avtar indicam que ele retornou do script run-at-start com um código de saída diferente de zero.
• Os trabalhos de backup são marcados como estando com falha.
• Desabilitar o script run-at-start permite que o backup seja bem-sucedido.

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

Código de saída inadequado do script de execução

O backup falha porque o script de execução personalizada retorna um código de saída diferente de 0 . Em ambientes Linux/UNIX, 0 é o único valor que indica sucesso. O Avtar interpreta qualquer valor diferente de zero como uma falha de script, fazendo com que o processo de backup seja abortado.

• O script retornou o código de saída 1 qual avtar registrado como um erro.
• O Avamar trata esse código de saída diferente de zero como uma falha e interrompe a operação de backup.

Entrada de log relevante:

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

Corrigindo falhas de script run-at-start do avtar

Resolução passo a passo

Quando um script personalizado de execução ao iniciar retorna um código de saída diferente de zero, o avtar trata o backup como com falha. Siga estas etapas para garantir que o script retorne 0 no sucesso.

• Localize o script configurado para a fase de execução no início do avtar (como, por exemplo, /opt/avamar/etc/run_at_start.d/custom_script.sh ).
• Abra o script em um editor e verifique a lógica que determina o sucesso ou a falha.
• No final do script, adicione ou modifique a instrução exit para que uma execução bem-sucedida termine com exit 0 .
• Certifique-se de que todos os caminhos de erro também usem códigos apropriados diferentes de zero somente quando ocorrer uma falha genuína.
• Salve as alterações e defina permissões executáveis se ainda não estiverem definidas.

Exemplo de um encerramento de script adequado:

#!/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 o script localmente

Execute o script manualmente e confirme sua saída com 0 .

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

Reinicie o avtar e acione um backup.

Depois de confirmar o script retorna 0, reinicie o serviço avtar e inicie um trabalho de backup para verificar a operação normal.

# Restart avtar service
$ systemctl restart avtar

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

Confirme a resolução.

Verifique se há a ausência da mensagem de erro no log avtar "Exiting avtar with run‑at‑start script failure 1." Uma entrada de log bem-sucedida se assemelha à seguinte:

[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