Модули

Материал из WiKi - UserSide

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

us_agent - 1.0.40, версия сервера: 3.4.8
us_abills - 3.14.93
us_asteriskcall - 1.4.78
us_ideco - 3.7.53
us_lanbilling - 3.12.111
us_mikbill - 3.3.18
us_nodeny - 3.15.145
us_peleng - 3.14.80
us_ping - 3.10.44
us_stat - 3.7.14
us_stg - 3.1.10
us_ti - 3.11.220
us_utm5 - 3.19.318
База оборудования - 3.20.371