Настройка событий

Система событий — механизм АСР «Гидра», посредством которого управляющие воздействия ядра системы передаются на сетевые службы и оборудование. С помощью событий выполняется множество задач, в том числе следующие:

• приостановление и возобновление доступа абонентов к услугам;
• установка параметров оказания услуг абонентам на оборудовании;
• рассылка абонентам уведомлений и напоминаний о платежах.
• управление портами оборудования.

Общая схема

Управление объектами (ОУ) и субъектами (СУ) учета построено на основе событий (events), возникающих при переходе ОУ/СУ из одного состояния в другое. Здесь состояние понимается в широком смысле: изменение атрибутов (в том числе дополнительных параметров, задаваемых пользователем), адресов, связей и привязок ОУ или СУ.

Событие вызывает набор связанных с ним действий (actions), которое преобразует эти действия в набор команд. В свою очередь, команды с помощью протокола удалённого управления передаются на выполнение агенту hamd — специальному внешнему приложению, непосредственно взаимодействующему с сетевыми службами или оборудованием.

Настройки событий

Соответствие друг другу событий, действий и команд задаётся в АСР «Гидра» в настройках событий (Справочники -> События). На рисунке показаны основные взаимосвязи между настройками события.

События

События генерируются системой в момент, определяемый их типом. Как правило, они происходят при переводе СУ, ОУ или связанного с СУ документа (инвойса, платежного поручения) в то или иное состояние.

События добавляются в очередь, которая затем обрабатывается заданиями по агентам. Такой подход позволяет работать с произвольными событиями, которые могут возникать в любом модуле системы, а вызовы процедуры добавления нового события в очередь являются асинхронными, то есть не блокируют выполнение пакета. Кроме того, можно применять события не только для управления устройствами, но и в любых других целях, например, для рассылки Email-сообщений, SMS-уведомлений, факсов и т. д.

В настройках событий указываются:

• Тип события.
• Тип (позиция номенклатуры) управляемого ОУ.
• Тип привязки управляемого ОУ к управляющей службе.
• Набор прямых действий.
• Набор обратных действий.
• Менеджер (агент) который будет выполнять связанные с данным событием действия.
• Настройки, зависящие от конкретного типа события.

Действия и команды

Действие для АСР «Гидра» представляет собой набор шаблонов команд в текстовом виде. Для использования в шаблонах предусмотрены специальные подстановки, которые при обработке команды агентом заменяются на конкретные значения атрибутов, идентификаторов и других параметров ОУ и СУ (например, подстановок $TERM_PHYS_ADDR может быть заменён на значение 00-1A-B1-DF-24-A4). При этом в АСР «Гидра» существует как жёстко запрограммированный набор подстановок, так и набор, задаваемый пользователем с помощью параметризованных подстановок. Например, дополнительные параметры ОУ могут представляться подстановкой ($TERM_OBJ_ADD_PARAMadd_param_id, где add_param_id — идентификатор дополнительного параметра).

Действия при настройке события добавляются двумя группами — прямой и обратной. Для каждого действия может быть задано действие, ему противоположное. Это позволяет системе управления при необходимости с помощью обратного действия корректно отменять изменения, сделанные на оборудовании прямым действием.

Команда имеет свой тип взаимодействия (SNMP, RSH, SSH, локальный и т.д.), определяющий протокол, по которому эта команда будет передаваться на управляемое устройство.

Менеджер активного оборудования hamd (агент управления)

Менеджер hamd (Hydra Active Management Daemon) — это специализированное приложение, являющееся внешним по отношению к ядру АСР и предназначенное для приёма от него команд и их дальнейшего выполнения. Данный агент, как и другие агенты АСР «Гидра» разработан на языке Python и поставляется в исходных кодах.

Менеджер принимает сообщения от ядра АСР по протоколу XML-RPC аналогично агенту hcd. В сообщении передаётся как сам пакет команд, так и дополнительные параметры, необходимые для его выполнения (данные для аутентификации на оборудовании и т.д.). Связь ядра с менеджером инициируется заданием по этому менеджеру.

Подстановки передаются отдельно от шаблона, что позволяет проводить их дополнительную обработку на стороне агента.

После того, как пакет команд выполнен, агент передаёт в систему отчёт о выполнении, в котором содержится результат выполнения каждой команды. Всего возможны четыре варианта: успех, предупреждение, ошибка и неизвестно. Пользователь сам задает то, какой результат вернуть в систему в каждом конкретном случае. Кроме того, вместе с результатом можно передавать и сообщение с расшифровкой проблемы. Подробная и качественная обработка ошибок позволяет легче обнаруживать и устранять проблемы, возникающие при работе системы, что в конечном счёте приводит к экономии рабочего времени и средств.

Задания

Задания приводят механизм управления СУ/ОУ в действие. Основная сущность, с которой работают задания — очередь событий.

Суть очереди событий ясна из названия. Событие вместе с набором связанных с ним действий добавляется в хвост очереди, а выполнение действий менеджером идёт с её начала. При этом действия группируются в разрезе каждого устройства, на котором они выполняются. Это даёт следующие возможности:

1. Пакетное выполнение команд в рамках одного сеанса связи — во многих случаях повышает производительность за счёт снижения накладных расходов на открытие нового сеанса связи с устройством.
2. Использование взаимозависимости команд — в зависимости от результата выполнения очередной команды может прерываться выполнение следующих команд на этом же устройстве.

На каждый менеджер создается одно задание АСР «Гидра» в момент перевода менеджера в активное состояние. После создания задание автоматически запускается с определенной периодичностью.

Взаимодействие при управлении ОУ

Взаимодействие сущностей АСР «Гидра» при срабатывании события по ОУ показано на примере управления доступом оконечного оборудования абонента к услугам оператора.

Оконечное оборудование абонента привязано к управляющим устройствам (файрвол, коммутатор).

Примеры

При работе оператора связи возникают типовые задачи по управлению оборудованием и службами. Все нижеперечисленные задачи решаются с помощью событий:

1. Задание и изменение привязки MAC-порт (IP-MAC-порт).
2. Задание и изменение скорости доступа на шейпере (iptables, ipfw, Cisco...).
3. Включение и отключение доступа абонента к услугам связи (управлением файрволом, разрыв PPP-сессий и т.д.).
4. Включение и отключение абонентского порта при блокировке абонента.
5. Перепривязка оконечного оборудования абонента к другому устройству (переезд).
6. Уведомление абонента о поступлении платежа на его лицевой счет.
7. Уведомление абонента о рекомендуемом платеже за несколько дней до предполагаемого отключения.
8. Уведомление абонента о выставленном ему счете на оплату услуг.