Инструкция по работе с SNMP на Carbon Billing.
SNMP-клиент, который позволяет посылать SNMP-команды удаленным устройствам по определенным событиям в системе, к которым относятся: достижение пользователем нулевого баланса, достижение пользователем положительного баланса, подключение пользователя к системе, отключение пользователя от системы, изменение данных клиента и закрытие финансового периода.
Включение поддержки SNMP-клиента (только в Carbon Billing)
- Зайти в локальное меню системы "Конфигурирование сервера" -> "Дополнительные настройки..."
- Поставить галочку "Запускать скрипт обработки событий"
- Сохранить конфигурацию и произвести мягкую перезагрузку
Работа со скриптами вызываемыми по событиям в системе
Для выполнения действий по событию в режиме SNMP-клиента необходимо внести требуемые команды в скрипт event_inc.sh, расположенный в директории /var/lib/event
Параметры для event_inc.sh
Каждый раз при вызове скрипта event_inc.sh, вместе с названием события ему передаются следующие параметры пользователя (в скобках указаны названия переменных в скрипте):
- идентификатор (id) - принимает значение равное порядковому номеру пользователя. Посмотреть значение можно в поле пользователя "№" в Carbon Manager
- IP-адрес (ip)
- MAC-адрес (mac)
- электронный почтовый адрес (email)
- NAT IP-адрес (snat)
- флаг финансового пользователя (finance)
- флаг состояния пользователя включен/выключен (enabled)
- флаг удаленного пользователя (deleted)
- флаг залогиненого пользователя (logged)
- тип авторизации пользователя (auth_type) - принимает значение от 0 до 6. См. [Типы авторизации]
- идентификатор тарифа (tariff_id) - принимает значение равное порядковому номеру тарифа. Посмотреть значение можно в cписке тарифов в Carbon Manager
- номер договора (contract_number)
- остальные доступные переменные можно посмотреть в этой [статье]
Параметры "флаг" принимают значение 0 или 1.
Из скрипта к переменным пользователя можно обращаться через запись $name, где name это название одной из перечисленных выше переменных. Например, "echo $ip" (без кавычек) запишет в лог IP-адрес пользователя.
Программы для работы с SNMP
- snmpwalk - получить список параметров доступных по SNMP
- snmpset - для установки значений параметров по SNMP
- snmpget - для получения значений параметров по SNMP
Примеры использования:
snmpwalk -v 2c -c private 10.0.0.2 snmpset -v 2c -c private 10.0.0.2 ifOperStatus.1 i 0 snmpget -v 2c -c private 10.0.0.2 ifOperStatus.1
Ссылки
Для получения более подробной информацией по SNMP и использованию вышеуказанных программ вы можете ознакомиться со следующими справочными материалами:
[1] http://ru.wikipedia.org/wiki/SNMP
[2] http://net-snmp.sourceforge.net/docs/man/