Авамар: 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