Avamar. avtar завершается сбоем, когда сценарий запуска при запуске возвращает ненулевой код выхода

Сбои резервного копирования при использовании сценария запуска при запуске

Резервное копирование не завершается, если для avtar настроен пользовательский сценарий запуска при запуске.

• Журналы avtar указывают на то, что он возвращен из сценария запуска при запуске с ненулевым кодом выхода.
• Задания резервного копирования помечаются как сбойные.
• Отключение сценария запуска при запуске позволяет успешно выполнить резервное копирование.

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

Неправильный код выхода из сценария запуска при запуске

Резервное копирование завершается сбоем, так как пользовательский сценарий запуска при запуске возвращает код завершения, отличный от 0 . В средах Linux/UNIX 0 является единственным значением, указывающим на успешное выполнение. Avtar интерпретирует любое ненулевое значение как сбой скрипта, что приводит к прерыванию процесса резервного копирования.

• Сценарий вернул код завершения 1 который avtar Зарегистрировано как ошибка.
• Avamar рассматривает этот ненулевой код выхода как сбой и останавливает операцию резервного копирования.

Соответствующая запись в журнале:

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

Исправление сбоев сценария avtar при запуске

Пошаговое решение

Когда настроенный сценарий запуска при запуске возвращает ненулевой код выхода, avtar считает резервное копирование неудачным. Чтобы убедиться, что сценарий возвращает 0 на успех.

• Найдите сценарий, настроенный для этапа запуска avtar (например, /opt/avamar/etc/run_at_start.d/custom_script.sh ).
• Откройте сценарий в редакторе и проверьте логику, определяющую успех или неудачу.
• В конце сценария добавьте или измените инструкцию exit так, чтобы успешное выполнение заканчивалось exit 0 .
• Проследите, чтобы во всех путях ошибки также использовались соответствующие ненулевые коды только при наличии подлинного сбоя.
• Сохраните изменения и задайте разрешения для исполняемых файлов, если они еще не заданы.

Пример правильного завершения сценария:

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

Проверьте сценарий локально

Запустите сценарий вручную и убедитесь, что он завершается с помощью команды 0 .

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

Перезапустите avtar и запустите резервное копирование.

После подтверждения сценарий возвращает 0, перезапустите службу avtar и запустите задание резервного копирования, чтобы убедиться в нормальной работе.

# Restart avtar service
$ systemctl restart avtar

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

Подтвердите решение.

Проверьте журнал avtar на отсутствие сообщения об ошибке "Exiting avtar with run‑at‑start script failure 1." Успешная запись журнала выглядит следующим образом:

[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