Для перемещения по дереву справки используйте строки заголовка.

Справка по NSG Linux 2.1.6
Дерево команд: services.netping.NAME.failure-script

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

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

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

Чтобы выполнить некоторые действия, если retry попыток подряд оказываются неудачными.

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

Написать скрипт, который следует выполнить в этом случае. Скрипт исполняется в контексте командной оболочки 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.

Если netping используется для отслеживания каких-либо аномальных ситуаций (действительных или предполагаемых) и рестарта устройства, чтобы привести его в работоспособное состояние, то рекомендуется вместо стандартной команды reboot использовать встроенный скрипт nsgreboot. Он сохраняет текущую информацию о состоянии устройства в файле /etc/postmortem.dump и затем рестартует устройство. Полученная информация может быть полезна для анализа и поиска проблем.

ПРИМЕЧАНИЕ. Практика устранения любых неисправностей методом рестарта всего устройства ни в коей мере не может считаться рекомендуемой, и применять её следует только в исключительных случаях. Отрубать голову по малейшему подозрению, как это принято в цивилизованных демократиях Востока — это не наш метод. В устройствах NSG предусмотрен рестарт компонент устройства по отдельности, и рестартовать следует минимально требуемую компоненту, чтобы не прерывать работу системы в целом и сохранять максимум полезной отладочной информации.

© Network Systems Group 2015–2024 Отдел документации