Модули

Материал из WiKi - UserSide
Перейти к навигации Перейти к поиску

Модули к ERP "UserSide" делятся на внутренние и внешние. Внешние модули представляют собой - отдельные скрипты или программы, которые могут в т.ч. работать удаленно от основной системы (имея при этом соединение с базой данных системы), а внутренние уже заложены в систему и могут включаться/выключаться в разделе "Настройка - Основная - Модули"

Частые вопросы по модулям собраны в соответствующем разделе "Частые вопросы"

Установка модулей. Общая информация для всех модулей

1. Для каждого модуля - выделите отдельный каталог.

2. В процессе работы все модули ведут логи работы. Путь для каталога с логами указывается в файле конфигурации. Крайне рекомендуется для каждого из модулей создавать отдельный каталог для логов. Не забудьте указать права на запись для этого каталога.

3. Модули служат, как правило, для постоянной работы. Их необходимо записать в системный cron с частотой запуска 5-15 минут (в зависимости от нагрузки). При первом запуске рекомендуется запустить модуль вручную из системной консоли и убедиться, что ошибок не возникает и данные импортируются/обрабатываются корректно.

Общая информация для модулей взаимосвязи с биллингами

1. Адрес абонента обрабатывается и фиксируется во встроенную в ERP "UserSide" систему учёта адресов. В случае если необходимого дома нет в ERP "UserSide" он будет создан. В случае если дом уже есть и добавлен в систему не средствами модуля, то он все-равно будет корректно обработан и прописан абонентам.

2. Если абонент есть в ERP "UserSide", но не найден в биллинге, то он не удаляется из ERP "UserSide", а помечается статусом "нет в биллинге". Так сделано в целях безопасности - в противном случае при сбое в обновлении - все абоненты могут быть удалены, т.к. не будут найдены в биллинге.

3. Если у абонента дата активности в интернете позже даты активности в сети, то дата активности в сети приравнивается к дате активности в интернете.

4. При обновлении данных из биллинга - не все данные абонента обновляются - например ФИО, адрес, телефон могут оставаться без изменений. Загрузку таких данных можно включить в разделе "Настройка - Биллинги" для необходимого биллинга.

Краткое описание модулей

Подробное описание указано на странице каждого из модулей


usm_billing - обеспечивает импорт информации об абонентах, адресах, тарифных планах и т.п. из биллинга в USERSIDE. Возможна поддержка собственного самописного биллинга. На базе этого модуля созданы отдельные модули для стандартных биллингов: usm_abills, usm_bgbilling, usm_hydra, usm_lanbilling, usm_nodeny, usm_nodeny_plus, usm_utm5


usm_asterisk - взаимодействует с телефонией Asterisk. При поступлении звонка - моментально (ещё до поднятия трубки) отображает на экране у оператора номер телефона звонящего и если этот номер телефона принадлежит абоненту - информацию об абоненте (ФИО, баланс, адрес, тарифный план, дата последней активности и т.п.). Если этот номер телефона принадлежит сотруднику - это будет указано. Если это неизвестный номер телефона - будет предложено создать карточку потенциального абонента.


usm_cabletest - периодически опрашивает коммутаторы и получает с них информацию кабельного тестера о длина включённых медных кабелей. Перечень поддерживаемых моделей коммутаторов указан на странице модуля.


usm_checker - периодически опрашивает (многопоточно пингует) активное сетевое оборудование или абонентские устройства с целью выявления какое оборудование активно, а какое упало (или какие абоненты перестали быть активными).


usm_gps - принимает информацию от железных и софтовых gps-треккеров с целью отображения местоположения автотранспорта и сотрудников на карте покрытия. Позволяет понять кто ближе всего к аварии. Видно кто в какое время и где двигался. Видны нарушения скоростного режима автотранспорта и т.п. Список поддерживаемых протоколов треккеров указан на странице модуля.


usm_observer - периодически опрашивает (по SNMP) любое оборудование по любым параметрам и уведомляет (почта, sms и т.п.) об изменении параметров или выхода параметров за пределы. Позволяет гибко настроить любой мониторинг любых устройств: потух порт номер такой-то, сработал датчик сигнализации, начата работа от батарей, кончилась бумага в принтере и т.п.


usm_peleng - периодически опрашивает коммутаторы, получает с них FDB-таблицу и накапливает информацию по MAC-адресам в разрезе оборудования и его портов. Позволяет выявлять факты колец, флуда на портах, вирусов. Помогает находить подмены MAC-адресов. Возможно исключение из отображения uplink/downlink-портов и т.п. По MAC-адресу из USERSIDE подтягивается информация об абоненте или устройстве.


usm_pon - периодически опрашивает OLT, получает и накапливает информацию о включённых ONT/ONU. Уровень сигнала, дистанция до OLT, модель, вендор, описание, MAC, ID и т.д. Историей изменения уровня сигнала в разрезе ONU/ONT. По MAC-адресу/ID ONU/ONT из USERSIDE подтягивается информация об абоненте.


usm_radio - периодически опрашивает радиооборудование и получает список подключенных радиоабонентов. Уровень сигнала, MAC-адрес, скорость соединения и т.п. Перечень поддерживаемых вендоров указан на странице модуля. По MAC-адресу из USERSIDE подтягивается информация об абоненте или устройстве.


usm_stat - периодически запускается и фиксирует в базу факт активности абонентов на момент запуска. Это позволяет в дальнейшем видеть по каждому из абонентов в какие дни и часы он был активным в сети. Также фиксируется и общее количество активных абонентов на момент запуска модуля.

Текущие версии модулей

usm_abills - 3.167.216
usm_asterisk - 1.0.19
usm_bgbilling - 3.167.72
usm_billing - 1.6.167
usm_cabletest - 1.1.4
usm_checker - 2.0.0
usm_gps - 2.0.0
usm_hydra - 3.167.70
usm_lanbilling - 3.167.253
usm_nodeny - 3.167.223
usm_nodeny_plus - 3.167.52
usm_observer - 1.0.0
usm_peleng - 3.25.119
usm_pon - 1.9.28
usm_radio - 3.12.13
usm_stat - 3.9.24
usm_utm5 - 3.167.575