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

Материал из WiKi - UserSide
Строка 32: Строка 32:


== Текущие версии модулей ==
== Текущие версии модулей ==
  [[us_asterisk]] - 0.1b.7
  [[us_asterisk]] - 0.1b.9
  [[us_bgbilling]] - 1.5.14
  [[us_bgbilling]] - 1.6.15
  [[us_control]] - 1.1.10
  [[us_control]] - 1.1.10
  [[us_gps]] - 1.2.15
  [[us_gps]] - 1.3.16
  [[us_hydra]] - 3.3.25
  [[us_hydra]] - 3.4.28
  [[us_ideco]] - 3.11.66
  [[us_ideco]] - 3.11.66
  [[us_lanbilling]] - 3.19.157
  [[us_lanbilling]] - 3.20.159
  [[us_mikbill]] - 3.8.25
  [[us_mikbill]] - 3.8.25
  [[us_nodeny]] - 3.22.190
  [[us_nodeny]] - 3.23.191
  [[us_nodeny_plus]] - 3.5.10
  [[us_nodeny_plus]] - 3.5.10
  [[us_radio]] - 1.0.1
  [[us_radio]] - 1.2.3
[[us_stat]] - 3.7.14
  [[us_stg]] - 3.1.10
  [[us_stg]] - 3.1.10
  [[usm_abills]] - 3.22.153
  [[usm_abills]] - 3.22.153
  [[usm_billing]] - 1.1.7
  [[usm_billing]] - 1.2.34
  [[usm_peleng]] - 3.21.110
  [[usm_peleng]] - 3.22.113
  [[usm_ping]] - 3.17.62
  [[usm_ping]] - 3.18.69
  [[usm_pon]] - 1.6.20
  [[usm_pon]] - 1.7.23
[[usm_stat]] - 3.8.20
  [[usm_utm5]] - 3.31.454
  [[usm_utm5]] - 3.31.454

Версия от 20:15, 10 июня 2016

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

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

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

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

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

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

us_asterisk - 0.1b.9
us_bgbilling - 1.6.15
us_control - 1.1.10
us_gps - 1.3.16
us_hydra - 3.4.28
us_ideco - 3.11.66
us_lanbilling - 3.20.159
us_mikbill - 3.8.25
us_nodeny - 3.23.191
us_nodeny_plus - 3.5.10
us_radio - 1.2.3
us_stg - 3.1.10
usm_abills - 3.22.153
usm_billing - 1.2.34
usm_peleng - 3.22.113
usm_ping - 3.18.69
usm_pon - 1.7.23
usm_stat - 3.8.20
usm_utm5 - 3.31.454