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

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
 
(не показано 48 промежуточных версий 2 участников)
Строка 1: Строка 1:
[[Installation_for_version_3.10_and_earlier|en]] | [[Установка_для_версии_3.10_и_более_ранних|ru]]
'''ВНИМАНИЕ: Данная инструкция актуальна для версий ERP "UserSide" до 3.11. Для версии 3.11 и выше - используйте инструкцию по [[Установка (инсталлятор)|установке системы с инсталлятором]].
* рекомендуется выполнять установку на FreeBSD/Linux-системы. Установка на Windows также возможна, но практика показала, что на *nix-системах производительность программы гораздо выше при тех же технических характеристиках сервера.
* рекомендуется выполнять установку на FreeBSD/Linux-системы. Установка на Windows также возможна, но практика показала, что на *nix-системах производительность программы гораздо выше при тех же технических характеристиках сервера.


* распаковать архив '''userside.zip''' в отдельно выделенный для системы каталог ''(напр. /usr/local/www/data/userside/ или d:/userside/)''.
* убедитесь, что ваша система соответствует необходимым [[Технические требования|техническим требованиям]]
 
* распаковать архив '''userside.zip''' в отдельно выделенный для системы каталог ''(напр. /var/www/userside/)''.
 
* настроить веб-сервер и завести в него проект/веб-узел userside


* настроить Apache (или IIS с расширением для PHP) и завести в него проект/веб-узел userside
* опционально настроить виртуальный хост следующим образом ''(пример для Apache24 Debian/Ubuntu)''


* PHP должен быть собран с поддержкой библиотек mysqli, snmp, socket, iconv, curl
Исходные данные следующие:
а) файлы и каталоги приложения 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-сервере переменную ''max_allowed_packet'' нужно увеличить до "10M" ''(файл my.cnf/my.ini)''


* создать базу данных на сервере MySQL с названием '''userside''' и кодировкой '''cp1251'''
* создать базу данных на сервере MySQL с названием '''userside''' и кодировкой '''utf8'''
 


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


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


* с помощью клиента SQL импортировать файл '''create_userside_new.sql''' (мы рекомендуем клиент [http://www.mysqlfront.de/ sql-front] или [http://www.phpmyadmin.net/ phpmyadmin]). Импорт файла также можно выполнить с помощью консоли mysql – в этом случае команда выглядит следующим образом:
* выполнить [[Установка PostgreSQL|установку и/или настройку PostgreSQL]]


<code>
* настроить файл '''/userside/userside3/main/config/config.php''' изменив значения переменных
mysql --default-character-set=cp1251 -u root -p userside < create_userside_new.sql
</code>


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


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


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


* прописать внутренний [[Скрипт - Планировщик|планировщик]] UserSide в cron. Скрипт планировщика находится в '''userside/script/script_cron.php'''. Частота запуска должна быть 1 раз в минуту. На файл скрипта следует обязательно поставить права на выполнение. В планировщик ("[[Настройка - Планировщик]]") следует добавить выполнение задачи «18. [[Ежедневные внутрисистемные операции]]» ''(указать запуск 1 раз в сутки)'' и выполнение задачи «29. [[Ежечасовые системные операции]]» ''(указать запуска 1 раз в час)''.
* на уровне файла .htaccess запретить просмотр листинга каталогов


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


{| border=1
* прописать внутренний [[Скрипт - Планировщик|планировщик]] UserSide в cron.
|
[[Файл:alert.png]] '''Предупреждение:''' не пренебрегайте безопасностью. Используйте устойчивые пароли для операторов системы и не забывайте их периодически менять. Также запретите просмотр содержимого директорий в каталоге  /userside/.
|}


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


* настроить взаимодействие с [[Поддерживаемые биллинги|биллингом]] в соответствии с нижеуказанными инструкциями:
* настроить взаимодействие с [[Поддерживаемые биллинги|биллингом]] в соответствии с [[Настройка взаимодействия с биллингом|инструкциями]]
а) на странице "[[Настройка - Биллинги]]" добавьте свой биллинг и укажите необходимые параметры для взаимодействия с ним.
б) если у вас отдельный биллинг – то выделите отдельный каталог для модуля взаимодействия Биллинг->UserSide, поместите в него модуль и выполните настройку конфигурационного файла [[Модули|модуля]] ''(модули приобретаются отдельно)''. После чего запустите модуль вручную, убедитесь в работоспособности и правильности импортируемых данных. Если все в порядке, то добавьте модуль в системный крон с частотой запуска 5-10 минут.
в) при работе с "[[MikroTik]]" настройте роутер(ы) и систему в соответствии с рекомендациями изложенными в [http://userside.ua/main/files/us_mikrotik_instr_1_1.doc этом документе]
г) в случае использования собственного биллинга – вы можете написать свой модуль импорта данных на основании наших рекомендаций, что содержатся в файловом архиве ([[Написание своего модуля (API)|API]])


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


'''Крайне рекомендуется после установки системы установить периодическое ''(лучше - ежедневное)'' создание резервной копии штатными средствами MySQL и PostgeSQL и её хранение НА ДРУГОМ КОМПЬЮТЕРЕ. Например:'''
mysqldump -uroot -pPASS userside > /var/www/userside.sql
pg_dump -c -Fc userside > /var/www/userside.dump


{| border=1  
{| border=1  
|
|
[[Файл:alert.png]] '''Важно:''' После установки системы и выполнение настройки взаимодействия с биллингом – ОБЯЗАТЕЛЬНО сверьте показатели балансов у абонентов в биллинге и в UserSide. В случае несовпадений – [[Контактная информация|свяжитесь с нами]].
[[Файл:alert.png]] '''Предупреждение:''' не пренебрегайте безопасностью. Используйте устойчивые пароли для операторов системы и не забывайте их периодически менять. Также запретите просмотр содержимого директорий в каталоге  /userside/.
|}
|}


'''Рекомендуется ознакомиться с инструкциями на странице: [[С чего начать?]]'''
'''Рекомендуется ознакомиться с инструкциями на странице: [[С чего начать?]]'''
== Дополнительные данные ==
== Дополнительные данные ==


* мы постоянно усовершенствуем систему и выпускаем [[Обновление|обновления]]. Они представляют собой архив с обновленными файлами и инструкцией по обновлению. Подпишитесь на [[Рассылка новостей|рассылку новостей]], следите за новостями системы UserSide, скачивайте в [[Файловый архив|файловом архиве]] обновления и следуйте прилагаемой инструкции.
* мы постоянно усовершенствуем систему и выпускаем [[Обновление|обновления]]. Они представляют собой архив с обновленными файлами и инструкцией по обновлению. Следите за новостями системы UserSide, скачивайте в "личном кабинете" обновления и следуйте прилагаемой инструкции.
 
* после выпуска обновлений мы иногда можем выкладывать в файловом архиве "[[HotFix|хотфиксы]]" с текущим исправлением ошибок и небольшими усовершенствованиями. Они представляют собой архив с файлами, которые нужно перенести к себе в рабочую систему (заменяя существующие файлы). Рекомендуем периодически заходить в файловый архив и проверять наличие «хотфиксов».
 
* если вы используете систему для работы без биллинга либо с MikroTik, то настоятельно рекомендуем Вам установить ssl-сертификат и использовать https-протокол для повышения уровня безопасности доступа
 
* для постоянного мониторинга пользователей Вы можете использовать модуль [[us_ping]], который периодически будет пинговать все компьютеры Вашей сети и сохранять информацию об активности в базу данных системы. При этом не важно какая у Вас ОС сервера, биллинг и пр. – us_ping может быть установлен на любом компьютере сети, пинговать компьютеры сети и фиксировать результаты в БД UserSide. Для большей точности – можно ставить эти программы на разных машинах в удаленных сегментах сети – конфликта работ не будет. Модули пингования кроме того анализируют ARP-таблицы, что позволяет выявлять активность и тех пользователей, которые находятся за брандмауэрами.
 
* модуль [[us_peleng]] периодически опрашивает управляемые коммутаторы, фиксирует MAC-адреса (по известным MAC-адресам прописывает свежее время активности, а неизвестные фиксирует отдельно). Позволяет смотреть всю историю MAC-адресов как по каждому отдельному порту, так и выполнять поиск MAC-адреса на всех коммутаторах/портах за весь период работы модуля
 
* для постоянной фиксации наличия/отсутствия абонентов в сети и/или интернете Вы можете воспользоваться модулем [[us_stat]], который каждый час (настраиваемо) фиксирует в базу данных факт наличия компьютера пользователя в сети/интернете. Это помогает в т.ч. в доказательствах абоненту факта пользования предоставляемыми услугами
 
* путь к [[Заявка на подключение|интерфейсу подачи заявок на подключение]] от сторонних посетителей: "../userside/script/newin.php" или "../userside/script/newin_new/sample1.php"
 
* вы можете устанавливать у абонентов клиентский агент [[us_agent]], который будет отражать наличие/отсутствие связи, баланс, трафик, ссылки на сайты сети, сообщения администрации и пр.
 
* в UserSide содержится внутренний модуль интеграции с [[Настройка - SMS-настройка|сервисами SMS-сообщений]] http://www.turbosms.ua http://www.smsc.ru http://www.smstraffic.ru – зарегистрируйтесь в них, чтобы иметь возможность отправлять сообщения абонентам, персоналу и вести историю этих рассылок.
 
* в UserSide содержатся скрипты для работы с сервисами пополнения счетов абонентам http://www.easysoft.com.ua и http://www.ukrpays.com ''(актуально для режима работы «Без биллинга» и «MikroTik»)''.
 
* если Вы не хотите, чтобы абоненты Вашей сети знали какую систему Вы используете для управлению сетью ''(имеется в виду UserSide)'', а также с целью безопасности, то Вы можете купить услугу – [[Отключение копирайтов]]
 


{| border=1
* после выпуска обновлений мы иногда можем выкладывать в файловом архиве "[[HotFix|хотфиксы]]" с текущим исправлением ошибок и небольшими усовершенствованиями. Они представляют собой архив с файлами, которые нужно перенести к себе в рабочую систему (заменяя существующие файлы).
|
[[Файл:alert.png]] '''Очень важно:''' Для нас главное не продать Вам систему, а чтобы она у Вас стабильно и без ошибок работала. Поэтому ВСЕГДА обращайтесь с вопросами и за поддержкой.
|}

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

en | ru

ВНИМАНИЕ: Данная инструкция актуальна для версий 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
  • настроить файл /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-адресов
* * * * *   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, скачивайте в "личном кабинете" обновления и следуйте прилагаемой инструкции.
  • после выпуска обновлений мы иногда можем выкладывать в файловом архиве "хотфиксы" с текущим исправлением ошибок и небольшими усовершенствованиями. Они представляют собой архив с файлами, которые нужно перенести к себе в рабочую систему (заменяя существующие файлы).