Модули: различия между версиями

Версия от 11:32, 1 июля 2017

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

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

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

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

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

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

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

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

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

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

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

5. Некоторые модули могут импортировать из биллинга пароль на авторизатор/вход в личный кабинет биллинга или пароль доступа в интернет. В этом случае такой пароль можно использовать как пароль входа в личный кабинет абонента в ERP "UserSide".

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

usm_bgbilling - 3.102.18
us_control - 1.3.13
us_gps - 1.5.22
us_hydra - 3.5.29
us_lanbilling - 3.21.162
us_nodeny - 3.24.192
us_nodeny_plus - 3.6.12
us_radio - 1.3.5
usm_abills - 3.102.183
usm_asterisk - 1.0.19
usm_billing - 1.4.102
usm_cabletest - 1.1.4
usm_peleng - 3.24.117
usm_ping - 3.20.78
usm_pon - 1.8.26
usm_stat - 3.9.24
usm_utm5 - 3.102.511

@@ Строка 5: / Строка 5: @@
 == Установка модулей. Общая информация для всех модулей ==
-. Для каждого модуля - выделите отдельный каталог. '''Абсолютно произвольный.''' САП "UserSide" напрямую не взаимодействует с модулями. Они полностью автономны и могут работать также на отдельных компьютерах в других подсетях.
+. Для каждого модуля - выделите отдельный каталог.
-. В процессе работы все модули ведут логи работы. Путь для каталога с логами указывается в файле конфигурации '''us_config.tmp'''. Крайне рекомендуется для каждого из модулей создавать отдельный каталог для логов, т.к. почти у всех модулей названия файлов-логов совпадают, что приведет к неразберихе. Не забудьте указать права на запись для этого каталога.
+. В процессе работы все модули ведут логи работы. Путь для каталога с логами указывается в файле конфигурации. Крайне рекомендуется для каждого из модулей создавать отдельный каталог для логов. Не забудьте указать права на запись для этого каталога.
-Распространенные названия файлов логов:
+. Модули служат, как правило, для постоянной работы. Их необходимо записать в системный cron с частотой запуска 5-15 минут ''(в зависимости от нагрузки)''. При первом запуске рекомендуется запустить модуль вручную из системной консоли и убедиться, что ошибок не возникает и данные импортируются/обрабатываются корректно.
- rep_alllog.txt - запуск и окончание всех циклов работы модуля с фиксацией времени
- rep_logupd.txt - текущий цикл работы модуля
- rep_mysql.txt -  все mysql команды, исполняемые модулем. Полезно при поиске ошибок.
- pid.txt - файл-флаг по которому модуль ориентируется о том, что он уже запущен, для предотвращения повторного одновременного запуска
-. Для некоторых модулей требуется наличие дополнительных perl-пакетов ''(DBI, Socket, Encode и т.д.)'' Если у вас они не установлены - модуль выдаст ошибку при запуске и perl-пакет необходимо будет установить ''(с помощью CPAN или PPM)''.
-. Модули служат, как правило, для постоянной работы. Их необходимо записать в системный cron/планировщик с частотой запуска 5-15 минут ''(в зависимости от нагрузки)''. При первом запуске рекомендуется запустить модуль вручную из системной консоли и убедиться, что ошибок не возникает и данные импортируются/обрабатываются корректно.
 == Общая информация для модулей взаимосвязи с биллингами ==