Usm ping: различия между версиями
Admin (обсуждение | вклад) Нет описания правки |
Admin (обсуждение | вклад) Нет описания правки |
||
Строка 1: | Строка 1: | ||
{{activ}} | {{activ}} | ||
'''USM_PING''' - ''это модуль для выявления абонентов/устройств в сети | '''USM_PING''' - ''это модуль для выявления активности абонентов/устройств в сети'' | ||
'''Данный модуль является заменой устаревшему модулю [[us_ping]]''' | '''Данный модуль является заменой устаревшему модулю [[us_ping]]''' | ||
Строка 11: | Строка 10: | ||
'''Текущая версия:''' см. на странице: [[Модули]] | '''Текущая версия:''' см. на странице: [[Модули]] | ||
'''Статус модуля:''' [http://userside. | '''Статус модуля:''' [http://userside.eu/price.php Платный] | ||
Необходимые модули Perl: | Необходимые модули Perl: | ||
Time::Local | Time::Local | ||
Socket | |||
threads | threads | ||
Thread::Queue | Thread::Queue | ||
Строка 21: | Строка 20: | ||
Socket | Socket | ||
FindBin | FindBin | ||
URI | |||
URI::Escape | |||
LWP::UserAgent | |||
JSON | |||
Data::Dumper | |||
Общую информацию для всех модулей см. на странице: [[Модули]] | |||
== Основные функции == | |||
* Модуль пингует все IP-адреса из базы данных ERP "UserSide" и обновляет дату активности откликнувшихся устройств/абонентов в системе | |||
* После выполнения пинга - идёт анализ arp-таблицы и обновляется активность у тех адресов, которые найдены в arp-таблице, но не откликнулись на пинг. Такие ситуации возможны когда у абонента включен firewall/брандмауэр | |||
== Установка и настройка модуля == | |||
# Выделите отдельный каталог. Абсолютно произвольный. Лучше его не размещать в каталоге, доступном через web. Взаимодействие с ERP "UserSide" осуществляется средствами API по http/s-протоколу. Таким образом модуль полностью автономен и может работать на любом отдельном компьютере в любой подсети. Также создайте отдельный каталог для логов модуля. Не забудьте указать для него права на запись. | |||
# Перенесите туда файлы их архива модуля. Пример файла конфигурации "usm_ping.conf-example" переименуйте в "usm_ping.conf". В нём выполните настройку параметров. Перечень возможных параметров указан ниже. | |||
# Проверьте наличие дополнительных perl-пакетов, которые требуются для запуска модуля. Их список приведён выше. Если у вас они не установлены - модуль выдаст ошибку при запуске и perl-пакет необходимо будет установить ''(с помощью CPAN или PPM)''. | |||
# В разделе "[[Настройка - Модули]]" включите работу с модулем usm_ping | |||
# Запустите модуль руками | |||
perl usm_ping.pl | |||
Он должен запуститься и отработать без ошибок. | |||
== Параметры == | == Параметры == | ||
Настройка модуля осуществляется в файле '''usm_ping.conf''' | |||
$ | $usUrl - URL к ERP "UserSide" | ||
$ | $usApiKey - [[API]]-ключ к ERP "UserSide" | ||
$logsPath - Путь к каталогу для логов модуля | |||
$ | |||
$ | $isSilence - Флаг - скрывать уведомления в консоль при работе модуля | ||
$ | $citiesList - Перечень идентификаторов населенных пунктов ''(через запятую)'' IP-адреса которых опрашивать. 0 - объекты без адреса | ||
$ | $arpPath - Путь к ARP | ||
$ | $pingType - Тип пинга | ||
$ | $isOnlyDevice - Флаг - пинговать только устройства | ||
$ | $threadCount - Количество потоков для пинга | ||
$ | $ipRangeStart - Начальный IP-адрес для пинга | ||
$ | $ipRangeFinish - Конечный IP-адрес для пинга | ||
$ | $isChangeMac - Флаг - если модуль находит для IP-адреса MAC адрес, который неизвестен ERP "UserSide" ''(в базе другой MAC-адрес)'', то старый MAC затирается новым | ||
$isAlternativePing - Флаг - альтернативный пинг ''(с помощью командной строки сервера)'' | |||
$alternativePingPath - Параметры для альтернативного пинга в командной строке | |||
== Рекомендации == | == Рекомендации == |
Версия от 18:09, 28 ноября 2015
Эта функция является одной из возможностью |
USM_PING - это модуль для выявления активности абонентов/устройств в сети
Данный модуль является заменой устаревшему модулю us_ping
Язык модуля: Perl
Текущая версия: см. на странице: Модули
Статус модуля: Платный
Необходимые модули Perl:
Time::Local Socket threads Thread::Queue Net::Ping Socket FindBin URI URI::Escape LWP::UserAgent JSON Data::Dumper
Общую информацию для всех модулей см. на странице: Модули
Основные функции
- Модуль пингует все IP-адреса из базы данных ERP "UserSide" и обновляет дату активности откликнувшихся устройств/абонентов в системе
- После выполнения пинга - идёт анализ arp-таблицы и обновляется активность у тех адресов, которые найдены в arp-таблице, но не откликнулись на пинг. Такие ситуации возможны когда у абонента включен firewall/брандмауэр
Установка и настройка модуля
- Выделите отдельный каталог. Абсолютно произвольный. Лучше его не размещать в каталоге, доступном через web. Взаимодействие с ERP "UserSide" осуществляется средствами API по http/s-протоколу. Таким образом модуль полностью автономен и может работать на любом отдельном компьютере в любой подсети. Также создайте отдельный каталог для логов модуля. Не забудьте указать для него права на запись.
- Перенесите туда файлы их архива модуля. Пример файла конфигурации "usm_ping.conf-example" переименуйте в "usm_ping.conf". В нём выполните настройку параметров. Перечень возможных параметров указан ниже.
- Проверьте наличие дополнительных perl-пакетов, которые требуются для запуска модуля. Их список приведён выше. Если у вас они не установлены - модуль выдаст ошибку при запуске и perl-пакет необходимо будет установить (с помощью CPAN или PPM).
- В разделе "Настройка - Модули" включите работу с модулем usm_ping
- Запустите модуль руками
perl usm_ping.pl
Он должен запуститься и отработать без ошибок.
Параметры
Настройка модуля осуществляется в файле usm_ping.conf
$usUrl - URL к ERP "UserSide" $usApiKey - API-ключ к ERP "UserSide" $logsPath - Путь к каталогу для логов модуля
$isSilence - Флаг - скрывать уведомления в консоль при работе модуля $citiesList - Перечень идентификаторов населенных пунктов (через запятую) IP-адреса которых опрашивать. 0 - объекты без адреса $arpPath - Путь к ARP $pingType - Тип пинга $isOnlyDevice - Флаг - пинговать только устройства $threadCount - Количество потоков для пинга $ipRangeStart - Начальный IP-адрес для пинга $ipRangeFinish - Конечный IP-адрес для пинга $isChangeMac - Флаг - если модуль находит для IP-адреса MAC адрес, который неизвестен ERP "UserSide" (в базе другой MAC-адрес), то старый MAC затирается новым $isAlternativePing - Флаг - альтернативный пинг (с помощью командной строки сервера) $alternativePingPath - Параметры для альтернативного пинга в командной строке
Рекомендации
Лучше всего себя зарекомендовала следующая схема:
- Создайте два отдельных каталога и положите туда два модуля us_ping со своими файлами конфигурации us_config.tmp. Также создайте два отдельных каталога для их логов
Модуль №1 - в файле конфигурации укажите параметры $ps_onlydevice = 1; $ps_threadcount = 25; Пропишите в системный cron запуск этого модуля с частотой запуска - ежеминутно
Модуль №2 - в файле конфигурации укажите параметры $ps_onlydevice = 0; $ps_threadcount = 50; Пропишите в системный cron запуск этого модуля с частотой запуска - раз в 10 минут
- Таким образом первый модуль будет опрашивать ежеминутно только оборудование, которого во-первых немного (меньше чем абонентов), а во-вторых практически всё оборудование постоянно активно, в отличии от абонентов. Следовательно практически постоянно будет мониторится активность оборудования, а абоненты будут опрашиваться раз в 10 минут, что менее критично.
Замечания
- Если ping опрашивает не все действительно рабочие устройства, то рекомендуется попробовать менять значение параметра $ps_pingtype (см. выше)
- Также в зависимости от загрузки сервера и сетевой подсистемы возможны ситуации, когда операционная система "захлёбывается" от быстрого опроса множества устройств. Особенно, когда большое количество опрашиваемых устройств недоступно и не отвечает. В этой ситуации рекомендуется уменьшить значение параметра $ps_threadcount