h1. Инструкция по работе с SNMP на Carbon Billing.
SNMP-клиент, который позволяет посылать SNMP-команды удаленным устройствам по определенным событиям в системе, к которым относятся: достижение пользователем нулевого баланса, достижение пользователем положительного баланса, подключение пользователя к системе, отключение пользователя от системы, изменение данных клиента и закрытие финансового периода.
h2. Включение поддержки SNMP-клиента (только в Carbon Billing)
# Зайти в локальное меню системы "Конфигурирование сервера" \-> "Дополнительные настройки..."
# Поставить галочку "Запускать скрипт обработки событий"
# Сохранить конфигурацию и произвести мягкую перезагрузку
Работа со скриптами вызываемыми по событиям в системе
Для выполнения действий по событию в режиме SNMP-клиента необходимо внести требуемые команды в скрипт event_inc.sh, расположенный в директории /var/lib/event
h2. Параметры для 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. См. [Типы авторизации|asrdocnew:4. Вариант 1. Старая схема. Через event_inc.sh - скрипт обработки событий]
# идентификатор тарифа (tariff_id) - принимает значение равное порядковому номеру тарифа. Посмотреть значение можно в cписке тарифов в Carbon Manager
# номер договора (contract_number)
# остальные доступные переменные можно посмотреть в этой [статье|asrdocnew:4. Вариант 1. Старая схема. Через event_inc.sh - скрипт обработки событий]
Параметры "флаг" принимают значение 0 или 1.
Из скрипта к переменным пользователя можно обращаться через запись $name, где name это название одной из перечисленных выше переменных. Например, "echo $ip" (без кавычек) запишет в лог IP-адрес пользователя.
h2. Программы для работы с SNMP
# snmpwalk - получить список параметров доступных по SNMP
# snmpset - для установки значений параметров по SNMP
# snmpget - для получения значений параметров по SNMP
Примеры использования:
{code}
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
{code}
h2. Ссылки
Для получения более подробной информацией по SNMP и использованию вышеуказанных программ вы можете ознакомиться со следующими справочными материалами:
\[1\] [http://ru.wikipedia.org/wiki/SNMP|http://ru.wikipedia.org/wiki/SNMP]
\[2\] [http://net-snmp.sourceforge.net/docs/man/|http://net-snmp.sourceforge.net/docs/man/]
SNMP-клиент, который позволяет посылать SNMP-команды удаленным устройствам по определенным событиям в системе, к которым относятся: достижение пользователем нулевого баланса, достижение пользователем положительного баланса, подключение пользователя к системе, отключение пользователя от системы, изменение данных клиента и закрытие финансового периода.
h2. Включение поддержки SNMP-клиента (только в Carbon Billing)
# Зайти в локальное меню системы "Конфигурирование сервера" \-> "Дополнительные настройки..."
# Поставить галочку "Запускать скрипт обработки событий"
# Сохранить конфигурацию и произвести мягкую перезагрузку
Работа со скриптами вызываемыми по событиям в системе
Для выполнения действий по событию в режиме SNMP-клиента необходимо внести требуемые команды в скрипт event_inc.sh, расположенный в директории /var/lib/event
h2. Параметры для 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. См. [Типы авторизации|asrdocnew:4. Вариант 1. Старая схема. Через event_inc.sh - скрипт обработки событий]
# идентификатор тарифа (tariff_id) - принимает значение равное порядковому номеру тарифа. Посмотреть значение можно в cписке тарифов в Carbon Manager
# номер договора (contract_number)
# остальные доступные переменные можно посмотреть в этой [статье|asrdocnew:4. Вариант 1. Старая схема. Через event_inc.sh - скрипт обработки событий]
Параметры "флаг" принимают значение 0 или 1.
Из скрипта к переменным пользователя можно обращаться через запись $name, где name это название одной из перечисленных выше переменных. Например, "echo $ip" (без кавычек) запишет в лог IP-адрес пользователя.
h2. Программы для работы с SNMP
# snmpwalk - получить список параметров доступных по SNMP
# snmpset - для установки значений параметров по SNMP
# snmpget - для получения значений параметров по SNMP
Примеры использования:
{code}
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
{code}
h2. Ссылки
Для получения более подробной информацией по SNMP и использованию вышеуказанных программ вы можете ознакомиться со следующими справочными материалами:
\[1\] [http://ru.wikipedia.org/wiki/SNMP|http://ru.wikipedia.org/wiki/SNMP]
\[2\] [http://net-snmp.sourceforge.net/docs/man/|http://net-snmp.sourceforge.net/docs/man/]