Установка для версии 3.10 и более ранних

Материал из WiKi - UserSide
  • рекомендуется выполнять установку на FreeBSD/Linux-системы. Установка на Windows также возможна, но практика показала, что на *nix-системах производительность программы гораздо выше при тех же технических характеристиках сервера.
  • распаковать архив userside.zip в отдельно выделенный для системы каталог (напр. /var/www/userside/).
  • настроить веб-сервер и завести в него проект/веб-узел userside
  • опционально настроить виртуальный хост следующим образом (пример для Apache24 Debian/Ubuntu)
Исходные данные следующие:
а) файлы и каталоги приложения USERSIDE расположены в каталоге /var/www/userside/
б) адрес сайта виртуального хоста userside.mydomain.com
<VirtualHost *:80>
   ServerAdmin webmaster@yourdomain.name
   DocumentRoot "/var/www/userside/userside3"
   ServerName userside.mydomain.com
   ErrorLog "/var/log/apache2/userside-main-error.log"
   CustomLog "/var/log/apache2/userside-main-access.log" common
   <Directory "/var/www/userside/userside3">
       Options -Indexes
       AllowOverride All
       Require all granted
   </Directory>
</VirtualHost>
  • в MySQL-сервере переменную max_allowed_packet нужно увеличить до "10M" (файл my.cnf/my.ini)
  • создать базу данных на сервере MySQL с названием userside и кодировкой utf8
  • импортировать файл create_userside.sql. Импорт файла также можно выполнить с помощью консоли mysql – в этом случае команда выглядит следующим образом:
mysql --default-character-set=utf8 -u root -p userside < create_userside_new.sql
  • настроить файл /userside/userside3/main/config/config.php изменив значения переменных
  • открыть страницу системы http://userside.mydomain.com/oper/ и убедиться в работоспособности системы (имя пользователя: Admin, пароль: 1234)
  • прописать права на запись для веб-сервера для всего каталога UserSide, включая подкаталоги. Это необходимо для проведения обновлений
  • на уровне файла .htaccess запретить просмотр листинга каталогов
  • доступ к файлу API "/userside/userside3/api.php" рекомендуется ограничить на уровне веб-сервера для доступа лишь с разрешённых IP-адресов
  • настроить взаимодействие с биллингом в соответствии с нижеуказанными инструкциями:
а) на странице "Настройка - Биллинги" добавьте свой биллинг и укажите необходимые параметры для взаимодействия с ним.
б) если у вас отдельный биллинг – то выделите отдельный каталог для модуля взаимодействия Биллинг->UserSide, поместите 
в него модуль и выполните настройку конфигурационного файла модуля (модули приобретаются отдельно). После чего запустите модуль вручную, убедитесь в 
работоспособности и правильности импортируемых данных. Если все в порядке, то добавьте модуль в системный крон с частотой запуска 5-10 минут.
в) в случае использования собственного биллинга – вы можете написать свой модуль импорта данных на основании наших рекомендаций, что содержатся в файловом архиве (API)

Крайне рекомендуется после установки системы установить периодическое (лучше - ежедневное) создание резервной копии штатными средствами MySQL и её хранение НА ДРУГОМ КОМПЬЮТЕРЕ. Например:

mysqldump -uroot -pPASS userside > /var/www/userside.sql

Важно: После установки системы и выполнение настройки взаимодействия с биллингом – ОБЯЗАТЕЛЬНО сверьте показатели балансов у абонентов в биллинге и в UserSide. В случае несовпадений – свяжитесь с нами.


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


Рекомендуется ознакомиться с инструкциями на странице: С чего начать?


Дополнительные данные

  • мы постоянно усовершенствуем систему и выпускаем обновления. Они представляют собой архив с обновленными файлами и инструкцией по обновлению. Подпишитесь на рассылку новостей, следите за новостями системы UserSide, скачивайте в файловом архиве обновления и следуйте прилагаемой инструкции.
  • после выпуска обновлений мы иногда можем выкладывать в файловом архиве "хотфиксы" с текущим исправлением ошибок и небольшими усовершенствованиями. Они представляют собой архив с файлами, которые нужно перенести к себе в рабочую систему (заменяя существующие файлы). Рекомендуем периодически заходить в файловый архив и проверять наличие «хотфиксов».