Что это такое?

Это cкрипт, выполняемый при восстановлении связи с указанным узлом.

Зачем это нужно?

Чтобы выполнить некоторые действия при первой успешной попытке после состояния failure.

Как это настроить?

Написать скрипт, который следует выполнить в этом случае. Скрипт исполняется в контексте командной оболочки bash и может содержать, в частности, вызов вложенной командной оболочки nsgsh в пакетном режиме.

ПРИМЕЧАНИЕ. Скрипты failure-script и restore-script реагируют на изменение состояния netping из ON в OFF и обратно и исполняются только один раз при каждом таком изменении. Если интересует факт нахождения netping в том или ином состоянии при каждом очередном срабатывании, то следует использовать механизм обработчика событий, в котором можно использовать этот же netping в качестве виртуального датчика.

Говоря ещё более строго, нетпинг имеет не 2, а 3 состояния: "да", "нет" и "хрен знает". Начальное состояние netping считается неопределённым (nil), поэтому при первом исполнении netping обязательно выполняется один из двух этих скриптов.

При вызове скрипта в него передаются следующие переменные окружения:

$NSG_LAST_STATE	Текущее состояние теста, возможные значения: START, UP либо DOWN
$NET_PING_EVENT	Событие (переход из одного состояния в другое), вызвавшее исполнение скрипта; возможные значения: FAILURE либо RESTORE
$NET_PING_DESTINATION_IP
$NET_PING_SOURCE_IP

Если из скрипта вызывается оболочка nsgsh, то настоятельно рекомендуется вызывать её с ключом --readonly во всех случаях, когда это возможно. Чаще всего она вызывается для рестарта порта или туннеля — именно эти действия доступны в режиме read-only, поскольку не изменяют конфигурации. Если по существу необходимо вызвать nsgsh именно с правами администратора, то следует использовать ключ --force.