Инструкция по работе с SNMP на Carbon Billing.

SNMP-клиент, который позволяет посылать SNMP-команды удаленным устройствам по определенным событиям в системе, к которым относятся: достижение пользователем нулевого баланса, достижение пользователем положительного баланса, подключение пользователя к системе, отключение пользователя от системы, изменение данных клиента и закрытие финансового периода.

Включение поддержки SNMP-клиента (только в Carbon Billing)

1. Зайти в локальное меню системы "Конфигурирование сервера" -> "Дополнительные настройки..."
2. Поставить галочку "Запускать скрипт обработки событий"
3. Сохранить конфигурацию и произвести мягкую перезагрузку

Работа со скриптами вызываемыми по событиям в системе

Для выполнения действий по событию в режиме SNMP-клиента необходимо внести требуемые команды в скрипт event_inc.sh, расположенный в директории /var/lib/event

Параметры для event_inc.sh

Каждый раз при вызове скрипта event_inc.sh, вместе с названием события ему передаются следующие параметры пользователя (в скобках указаны названия переменных в скрипте):

1. идентификатор (id)
2. IP-адрес (ip)
3. MAC-адрес (mac)
4. электронный почтовый адрес (email)
5. NAT IP-адрес (snat)
6. флаг финансового пользователя (finance)
7. флаг состояния пользователя включен/выключен (enabled)
8. флаг удаленного пользователя (deleted)
9. флаг залогиненого пользователя (logged)
10. тип авторизации пользователя (auth_type)
11. идентификатор тарифа (tariff_id)
12. номер договора (contract_number)

Из скрипта к переменным пользователя можно обращаться через запись $name, где name это название одной из перечисленных выше переменных. Например, "echo $ip" (без кавычек) выведет на экран IP-адрес пользователя.

Программы для работы с SNMP

1. snmpwalk - получить список параметров доступных по SNMP
2. snmpset - для установки значений параметров по SNMP
3. 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/