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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• если вы используете систему для работы без биллинга либо с 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-сообщений http://www.turbosms.ua http://www.smsc.ru http://www.smstraffic.ru – зарегистрируйтесь в них, чтобы иметь возможность отправлять сообщения абонентам, персоналу и вести историю этих рассылок.

• в UserSide содержатся скрипты для работы с сервисами пополнения счетов абонентам http://www.easysoft.com.ua и http://www.ukrpays.com (актуально для режима работы «Без биллинга» и «MikroTik»).

• если Вы не хотите, чтобы абоненты Вашей сети знали какую систему Вы используете для управлению сетью (имеется в виду UserSide), а также с целью безопасности, то Вы можете купить услугу – Отключение копирайтов

Очень важно: Для нас главное не продать Вам систему, а чтобы она у Вас стабильно и без ошибок работала. Поэтому ВСЕГДА обращайтесь с вопросами и за поддержкой.