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

Текущая версия от 17:19, 28 февраля 2024

ВНИМАНИЕ: Данная инструкция актуальна для версий ERP "UserSide" до 3.11. Для версии 3.11 и выше - используйте инструкцию по установке системы с инсталлятором.

рекомендуется выполнять установку на 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

выполнить установку и/или настройку PostgreSQL

настроить файл /userside/userside3/main/config/config.php изменив значения переменных

находясь в каталоге с приложением (например: /var/www/userside) выполните "php setup" и ответьте на вопросы скрипта установки. Там будет требоваться указать параметры для доступа к созданной базе данных PostgreSQL

открыть страницу системы http://userside.mydomain.com/oper/ и убедиться в работоспособности системы (имя пользователя: Admin, пароль: 1234)

прописать права на запись для веб-сервера для всего каталога UserSide, включая подкаталоги. Это необходимо для проведения обновлений

на уровне файла .htaccess запретить просмотр листинга каталогов

доступ к файлу API "/userside/userside3/api.php" рекомендуется ограничить на уровне веб-сервера для доступа лишь с разрешённых IP-адресов

прописать внутренний планировщик UserSide в cron.

* * * * *   www-data   php /var/www/userside/userside cron > /dev/null 2>&1

настроить взаимодействие с биллингом в соответствии с инструкциями

в разделе "Настройка - Основная" изучите основные разделы, параметры и настройте систему под себя.

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

mysqldump -uroot -pPASS userside > /var/www/userside.sql
pg_dump -c -Fc userside > /var/www/userside.dump

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

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

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

мы постоянно усовершенствуем систему и выпускаем обновления. Они представляют собой архив с обновленными файлами и инструкцией по обновлению. Следите за новостями системы UserSide, скачивайте в "личном кабинете" обновления и следуйте прилагаемой инструкции.

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

@@ Строка 1: / Строка 1: @@
+[[Installation_for_version_3.10_and_earlier|en]] | [[Установка_для_версии_3.10_и_более_ранних|ru]]
+'''ВНИМАНИЕ: Данная инструкция актуальна для версий ERP "UserSide" до 3.11. Для версии 3.11 и выше - используйте инструкцию по [[Установка (инсталлятор)|установке системы с инсталлятором]].
 * рекомендуется выполнять установку на FreeBSD/Linux-системы. Установка на Windows также возможна, но практика показала, что на *nix-системах производительность программы гораздо выше при тех же технических характеристиках сервера.
+* убедитесь, что ваша система соответствует необходимым [[Технические требования|техническим требованиям]]
 * распаковать архив '''userside.zip''' в отдельно выделенный для системы каталог ''(напр. /var/www/userside/)''.
@@ Строка 5: / Строка 13: @@
 * настроить веб-сервер и завести в него проект/веб-узел userside
-* Настроить виртуальные хосты следующим образом ''(пример для Apache24 Debian/Ubuntu)''
+* опционально настроить виртуальный хост следующим образом ''(пример для 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/useside-main-error.log"
+     ErrorLog "/var/log/apache2/userside-main-error.log"
-     CustomLog "/var/log/apache2/useside-main-access.log" common
+     CustomLog "/var/log/apache2/userside-main-access.log" common
      <Directory "/var/www/userside/userside3">
          Options -Indexes
@@ Строка 23: / Строка 31: @@
      </Directory>
   </VirtualHost>
- Виртуальный хост для фреймворка
- <VirtualHost *:80>
-    ServerAdmin webmaster@yourdomain.name
-    DocumentRoot "/var/www/userside/erp/web"
-    ServerName api.localhost
-    ErrorLog "/var/log/apache2/useside-api-error.log"
-    CustomLog "/var/log/apache2/useside-api-access.log" common
-    <Directory "/var/www/userside/erp/web">
-        Options -Indexes
-        AllowOverride All
-        Require all denied
-        Require ip 127.0.0.1
-        RewriteEngine on
-        RewriteCond %{REQUEST_FILENAME} !-f
-        RewriteCond %{REQUEST_FILENAME} !-d
-        RewriteRule . index.php
-    </Directory>
- </VirtualHost>
- В файл /etc/hosts на сервере необходимо добавить запись типа
-.0.0.1   api.localhost
-* PHP должен быть собран с поддержкой библиотек mysqli, snmp, socket, iconv, curl, mbstring, zlib, xml
 * в MySQL-сервере переменную ''max_allowed_packet'' нужно увеличить до "10M" ''(файл my.cnf/my.ini)''
@@ Строка 54: / Строка 36: @@
 * создать базу данных на сервере MySQL с названием '''userside''' и кодировкой '''utf8'''
+* импортировать файл '''create_userside.sql'''. Импорт файла также можно выполнить с помощью консоли mysql – в этом случае команда выглядит следующим образом:
-{| border=1
+ mysql --default-character-set=utf8 -u root -p userside < create_userside_new.sql
-|
-[[Файл:alert.png]] '''Предупреждение:''' При подключении клиентом MySQL к базе данных необходимо '''принудительно''' выбрать в настройке подключения кодировку '''utf8'''.
-|}
+* выполнить [[Установка PostgreSQL|установку и/или настройку PostgreSQL]]
-* с помощью клиента SQL импортировать файл '''create_userside.sql''' (мы рекомендуем клиент [http://www.mysqlfront.de/ sql-front]  или [http://www.phpmyadmin.net/ phpmyadmin]). Импорт файла также можно выполнить с помощью консоли mysql – в этом случае команда выглядит следующим образом:
+* настроить файл '''/userside/userside3/main/config/config.php''' изменив значения переменных
- mysql --default-character-set=utf8 -u root -p userside < create_userside_new.sql
+* находясь в каталоге с приложением ''(например: /var/www/userside)'' выполните "php setup" и ответьте на вопросы скрипта установки. Там будет требоваться указать параметры для доступа к созданной базе данных PostgreSQL
-* настроить файл '''/userside/main/config/config.php''' изменив значения переменных
+* открыть страницу системы '''<nowiki>http://userside.mydomain.com/oper/</nowiki>''' и убедиться в работоспособности системы ''(имя пользователя: Admin, пароль: 1234)''
-* открыть страницу системы '''<nowiki>http://userside.your_net.net/oper/</nowiki>''' и убедиться в работоспособности системы ''(имя пользователя: Admin, пароль: 1234)''
 * прописать права на запись для веб-сервера для всего каталога UserSide, включая подкаталоги. Это необходимо для проведения обновлений
@@ Строка 73: / Строка 52: @@
 * на уровне файла .htaccess запретить просмотр листинга каталогов
-* доступ к файлу [[API]] "'''/userside/api.php'''" рекомендуется ограничить на уровне веб-сервера для доступа лишь с разрешённых IP-адресов
+* доступ к файлу [[API]] "'''/userside/userside3/api.php'''" рекомендуется ограничить на уровне веб-сервера для доступа лишь с разрешённых IP-адресов
-* прописать внутренний [[Скрипт - Планировщик|планировщик]] UserSide в cron. Скрипт планировщика находится в '''userside/script/script_cron.php'''. Частота запуска должна быть 1 раз в минуту. На файл скрипта следует обязательно поставить права на выполнение. В планировщик ("[[Настройка - Планировщик]]") следует добавить выполнение задачи «18. [[Ежедневные внутрисистемные операции]]» ''(указать запуск 1 раз в сутки)'' и выполнение задачи «29. [[Ежечасовые системные операции]]» ''(указать запуска 1 раз в час)''.
+* прописать внутренний [[Скрипт - Планировщик|планировщик]] UserSide в cron.
-{| border=1
-|
-[[Файл:alert.png]] '''Предупреждение:''' не пренебрегайте безопасностью. Используйте устойчивые пароли для операторов системы и не забывайте их периодически менять. Также запретите просмотр содержимого директорий в каталоге  /userside/.
-|}
+ * * * * *   www-data   php /var/www/userside/userside cron > /dev/null 2>&1
-* настроить взаимодействие с [[Поддерживаемые биллинги|биллингом]] в соответствии с нижеуказанными инструкциями:
+* настроить взаимодействие с [[Поддерживаемые биллинги|биллингом]] в соответствии с [[Настройка взаимодействия с биллингом|инструкциями]]
- а) на странице "[[Настройка - Биллинги]]" добавьте свой биллинг и укажите необходимые параметры для взаимодействия с ним.
- б) если у вас отдельный биллинг – то выделите отдельный каталог для модуля взаимодействия Биллинг->UserSide, поместите в него модуль и выполните настройку конфигурационного файла [[Модули|модуля]] ''(модули приобретаются отдельно)''. После чего запустите модуль вручную, убедитесь в работоспособности и правильности импортируемых данных. Если все в порядке, то добавьте модуль в системный крон с частотой запуска 5-10 минут.
- в) в случае использования собственного биллинга – вы можете написать свой модуль импорта данных на основании наших рекомендаций, что содержатся в файловом архиве ([[Написание своего модуля (API)|API]])
 * в разделе "[[Настройка - Основная|Настройка - Основная]]" изучите основные разделы, параметры и настройте систему под себя.
+'''Крайне рекомендуется после установки системы установить периодическое ''(лучше - ежедневное)'' создание резервной копии штатными средствами MySQL и PostgeSQL и её хранение НА ДРУГОМ КОМПЬЮТЕРЕ. Например:'''
+ mysqldump -uroot -pPASS userside > /var/www/userside.sql
+ pg_dump -c -Fc userside > /var/www/userside.dump
 {| border=1
 |
-[[Файл:alert.png]] '''Важно:''' После установки системы и выполнение настройки взаимодействия с биллингом – ОБЯЗАТЕЛЬНО сверьте показатели балансов у абонентов в биллинге и в UserSide. В случае несовпадений – [[Контактная информация|свяжитесь с нами]].
+[[Файл:alert.png]] '''Предупреждение:''' не пренебрегайте безопасностью. Используйте устойчивые пароли для операторов системы и не забывайте их периодически менять. Также запретите просмотр содержимого директорий в каталоге  /userside/.
 |}
-'''Крайне рекомендуется после установки системы установить периодическое ''(лучше - ежедневное)'' создание резервной копии штатными средствами MySQL и её хранение НА ДРУГОМ КОМПЬЮТЕРЕ. Например:'''
- mysqldump -uroot -pPASS userside > /var/www/userside.sql
 '''Рекомендуется ознакомиться с инструкциями на странице: [[С чего начать?]]'''
 == Дополнительные данные ==
-* мы постоянно усовершенствуем систему и выпускаем [[Обновление|обновления]]. Они представляют собой архив с обновленными файлами и инструкцией по обновлению. Подпишитесь на [[Рассылка новостей|рассылку новостей]], следите за новостями системы UserSide, скачивайте в [[Файловый архив|файловом архиве]] обновления и следуйте прилагаемой инструкции.
+* мы постоянно усовершенствуем систему и выпускаем [[Обновление|обновления]]. Они представляют собой архив с обновленными файлами и инструкцией по обновлению. Следите за новостями системы UserSide, скачивайте в "личном кабинете" обновления и следуйте прилагаемой инструкции.
-* после выпуска обновлений мы иногда можем выкладывать в файловом архиве "[[HotFix|хотфиксы]]" с текущим исправлением ошибок и небольшими усовершенствованиями. Они представляют собой архив с файлами, которые нужно перенести к себе в рабочую систему (заменяя существующие файлы). Рекомендуем периодически заходить в файловый архив и проверять наличие «хотфиксов».
+* после выпуска обновлений мы иногда можем выкладывать в файловом архиве "[[HotFix|хотфиксы]]" с текущим исправлением ошибок и небольшими усовершенствованиями. Они представляют собой архив с файлами, которые нужно перенести к себе в рабочую систему (заменяя существующие файлы).