Установка для версии 3.10 и более ранних: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
Строка 4: Строка 4:


* настроить Apache (или IIS с расширением для PHP) и завести в него проект/веб-узел userside
* настроить Apache (или IIS с расширением для PHP) и завести в него проект/веб-узел userside
* PHP должен быть собран с поддержкой библиотек mysqli, snmp, socket, iconv, curl
* в MySQL-сервере переменную ''max_allowed_packet'' нужно увеличить до "10M" ''(файл my.cnf/my.ini)''


* создать базу данных на сервере MySQL с названием '''userside''' и кодировкой '''cp1251'''
* создать базу данных на сервере MySQL с названием '''userside''' и кодировкой '''cp1251'''
Строка 10: Строка 14:
{| border=1  
{| border=1  
|
|
''[[Файл:alert.png]] '''Предупреждение:''' При подключении клиентом MySQL к базе данных необходимо '''принудительно''' выбрать в настройке подключения кодировку '''cp1251'''. Иначе база данных может импортироваться в формате UTF-8 и это приведет к тому, что данные будут отображаться в виде ??????????? – в таком случае поможет удаление базы и установка по-новой.''
[[Файл:alert.png]] '''Предупреждение:''' При подключении клиентом MySQL к базе данных необходимо '''принудительно''' выбрать в настройке подключения кодировку '''cp1251'''. Иначе база данных может импортироваться в формате UTF-8 и это приведет к тому, что данные будут отображаться в виде ??????????? – в таком случае поможет удаление базы и установка по-новой.
|}
|}


Строка 17: Строка 21:


<code>mysql --default-character-set=cp1251 -u root -p userside < create_userside_new.sql</code>
<code>mysql --default-character-set=cp1251 -u root -p userside < create_userside_new.sql</code>
* настроить файл '''/userside/main/config/config.php''' изменив значения переменных
* открыть страницу системы '''<nowiki>http://userside.your_net.net/oper/</nowiki>''' и убедиться в работоспособности системы ''(имя пользователя: Admin, пароль: 1234)''
* прописать права на запись для веб-сервера для всего каталога UserSide, включая подкаталоги. Это необходимо для проведения обновлений
* прописать внутренний [[Планировщик|планировщик]] UserSide в cron. Скрипт планировщика находится в '''userside/script/script_cron.php'''. Частота запуска должна быть 1 раз в минуту. На файл скрипта следует обязательно поставить права на выполнение. В планировщик ("[[Настройка]]" - "[[Настройка - Планировщик|Планировщик]]") следует добавить выполнение задачи «18. [[Ежедневные внутрисистемные операции]]» ''(указать запуск 1 раз в сутки)'' и выполнение задачи «29. [[Ежечасовые системные операции]]» ''(указать запуска 1 раз в час)''.
{| border=1
|
[[Файл:alert.png]] '''Предупреждение:''' не пренебрегайте безопасностью. Используйте устойчивые пароли для операторов системы и не забывайте их периодически менять. Также запретите просмотр содержимого директорий в каталоге  /userside/.
|}
* настроить взаимодействие с [[Поддерживаемые биллинги|биллингом]] в соответствии с нижеуказанными инструкциями:
а) на странице "[[Настройка]]" - "[[Настройка - Биллинги|Биллинги]]" добавьте свой биллинг и укажите необходимые параметры для взаимодействия с ним.
б) если у вас отдельный биллинг – то выделите отдельный каталог для модуля взаимодействия Биллинг->UserSide, поместите в него модуль и выполните настройку конфигурационного файла [[Модули|модуля]] ''(модули приобретаются отдельно)''. После чего запустите модуль вручную, убедитесь в работоспособности и правильности импортируемых данных. Если все в порядке, то добавьте модуль в системный крон с частотой запуска 5-10 минут.
в) при работе с "[[MikroTik]]" настройте роутер(ы) и систему в соответствии с рекомендациями изложенными в [http://userside.ua/main/files/us_mikrotik_instr_1_1.doc этом документе]
г) в случае использования собственного биллинга – вы можете написать свой модуль импорта данных на основании наших рекомендаций, что содержатся в файловом архиве ([[API]])
* в разделе "[[Настройка]]" изучите основные разделы, параметры и настройте систему под себя.

Версия от 13:02, 18 апреля 2013

  • рекомендуется выполнять установку на FreeBSD/Linux-системы. Установка на Windows также возможна, но практика показала, что на *nix-системах производительность программы гораздо выше при тех же технических характеристиках сервера.
  • распаковать архив userside.zip в отдельно выделенный для системы каталог (напр. /usr/local/www/data/userside/ или d:/userside/).
  • настроить Apache (или IIS с расширением для PHP) и завести в него проект/веб-узел userside
  • PHP должен быть собран с поддержкой библиотек mysqli, snmp, socket, iconv, curl
  • в MySQL-сервере переменную max_allowed_packet нужно увеличить до "10M" (файл my.cnf/my.ini)
  • создать базу данных на сервере MySQL с названием userside и кодировкой cp1251


Предупреждение: При подключении клиентом MySQL к базе данных необходимо принудительно выбрать в настройке подключения кодировку cp1251. Иначе база данных может импортироваться в формате UTF-8 и это приведет к тому, что данные будут отображаться в виде ??????????? – в таком случае поможет удаление базы и установка по-новой.


  • с помощью клиента SQL импортировать файл create_userside_new.sql (мы рекомендуем клиент sql-front или phpmyadmin). Импорт файла также можно выполнить с помощью консоли mysql – в этом случае команда выглядит следующим образом:

mysql --default-character-set=cp1251 -u root -p userside < create_userside_new.sql

  • настроить файл /userside/main/config/config.php изменив значения переменных
  • открыть страницу системы http://userside.your_net.net/oper/ и убедиться в работоспособности системы (имя пользователя: Admin, пароль: 1234)
  • прописать права на запись для веб-сервера для всего каталога UserSide, включая подкаталоги. Это необходимо для проведения обновлений


Предупреждение: не пренебрегайте безопасностью. Используйте устойчивые пароли для операторов системы и не забывайте их периодически менять. Также запретите просмотр содержимого директорий в каталоге /userside/.


  • настроить взаимодействие с биллингом в соответствии с нижеуказанными инструкциями:
а) на странице "Настройка" - "Биллинги" добавьте свой биллинг и укажите необходимые параметры для взаимодействия с ним.
б) если у вас отдельный биллинг – то выделите отдельный каталог для модуля взаимодействия Биллинг->UserSide, поместите в него модуль и выполните настройку конфигурационного файла модуля (модули приобретаются отдельно). После чего запустите модуль вручную, убедитесь в работоспособности и правильности импортируемых данных. Если все в порядке, то добавьте модуль в системный крон с частотой запуска 5-10 минут.
в) при работе с "MikroTik" настройте роутер(ы) и систему в соответствии с рекомендациями изложенными в этом документе
г) в случае использования собственного биллинга – вы можете написать свой модуль импорта данных на основании наших рекомендаций, что содержатся в файловом архиве (API)
  • в разделе "Настройка" изучите основные разделы, параметры и настройте систему под себя.