Модули

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

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

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

1. Для каждого модуля - выделите отдельный каталог. Абсолютно произвольный. САП "UserSide" напрямую не взаимодействует с модулями. Они полностью автономны и могут работать также на отдельных компьютерах в других подсетях.

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

Распространенные названия файлов логов:

rep_alllog.txt - запуск и окончание всех циклов работы модуля с фиксацией времени
rep_logupd.txt - текущий цикл работы модуля
rep_mysql.txt -  все mysql команды, исполняемые модулем. Полезно при поиске ошибок.
pid.txt - файл-флаг по которому модуль ориентируется о том, что он уже запущен, для предотвращения повторного одновременного запуска

3. Для некоторых модулей требуется наличие дополнительных perl-пакетов (DBI, Socket, Encode и т.д.) Если у вас они не установлены - модуль выдаст ошибку при запуске и perl-пакет необходимо будет установить (с помощью CPAN или PPM).

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

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

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

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

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

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

5. Некоторые модули могут импортировать из биллинга пароль на авторизатор/вход в личный кабинет биллинга или пароль доступа в интернет. В этом случае такой пароль можно использовать как пароль входа в личный кабинет абонента в САП "UserSide". Это модули: us_nodeny, us_utm5

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

us_abills - 3.19.142
us_agent - 3.1.46, версия сервера: 3.5.9
us_asteriskcall - 1.4.101
us_bgbilling - 1.3.10
us_control - 1.0.8
us_gps - 1.0.11
us_ideco - 3.11.66
us_lanbilling - 3.17.152
us_mikbill - 3.6.23
us_nodeny - 3.20.188
us_nodeny_plus - 3.4.9
us_peleng - 3.19.106
us_ping - 3.15.60
us_pon - 1.3.13
us_radio - 1.0.1
us_stat - 3.7.14
us_stg - 3.1.10
us_utm5 - 3.24.428
База оборудования - 3.25.657