Содержание
- Поддерживаемая среда
- Установка MySQL / MariaDB
- Установка Wine
- Загрузка и распаковка Glovizor
- Настройка Glovizor
- Регистрация служб Glovizor в systemd
- Проверка работы
- Сетевые порты
- Управление службами
- Удаление Glovizor
Поддерживаемая среда
Инструкция проверена на Ubuntu Server 22.04 / 24.04 LTS и Debian 12 / 13 (x86_64, systemd). На Ubuntu используется MySQL, на Debian — MariaDB; Wine и сервер базы данных устанавливаются из стандартных репозиториев соответствующей системы.
Для других дистрибутивов Linux названия пакетов и команды установки могут отличаться.
Примечание. Установку и дальнейший запуск Glovizor рекомендуется выполнять от отдельного Linux-пользователя. Можно использовать существующего пользователя. Все команды Wine и первоначальную настройку Glovizor выполняйте от одного выбранного пользователя; sudo используйте только там, где он указан.
Установка MySQL / MariaDB
Если список пакетов после установки системы ещё не обновлялся, выполните:
sudo apt update
Glovizor работает с MySQL и MariaDB.
Для Ubuntu:
sudo apt install mysql-server -y
Для Debian:
sudo apt install default-mysql-server -y
Дополнительная проверка.
Проверить состояние MySQL:
systemctl status mysql --no-pager
Нормальное состояние: Active: active (running).
Создание пользователя MySQL
Откройте консоль MySQL:
sudo mysql
Создайте пользователя Glovizor для локального подключения. Вместо <STRONG_PASSWORD> укажите собственный пароль:
CREATE USER 'glovizor'@'localhost' IDENTIFIED BY '<STRONG_PASSWORD>';
GRANT ALL PRIVILEGES ON glovizor.* TO 'glovizor'@'localhost';
EXIT;
Базу данных glovizor вручную создавать не требуется — она будет создана через конфигуратор Glovizor.
Примечание. Если пользователь glovizor уже существует, CREATE USER повторно выполнять не нужно. При необходимости измените пароль существующего пользователя командой ALTER USER.
Установка Wine
Если apt update уже выполнялся на предыдущем этапе, повторять его не требуется.
Установите Wine из стандартного репозитория Ubuntu:
sudo apt install wine -y
Дополнительная проверка.
Проверить установленную версию Wine:
wine --version
На 64-битной Ubuntu команда может дополнительно сообщить, что wine32 не установлен. Если версия Wine выводится, продолжайте установку Glovizor.
Примечание. На сервере без графического интерфейса Wine может выводить сообщения о DISPLAY/X server, tray window или ntlm_auth. Если консольное меню Glovizor открывается и серверные компоненты работают, эти сообщения сами по себе не требуют дополнительной настройки.
Загрузка и распаковка Glovizor
Linux-пакет можно скачать на странице загрузки Glovizor и самостоятельно загрузить в домашний каталог выбранного Linux-пользователя.
Либо скачайте актуальный пакет непосредственно на сервер:
cd ~
wget https://glovizor.com/files/glovizor.tar.gz
Создайте рабочий каталог и распакуйте пакет:
mkdir -p ~/glovizor
tar -xzf ~/glovizor.tar.gz -C ~/glovizor
cd ~/glovizor
После успешной распаковки исходный архив можно удалить:
rm ~/glovizor.tar.gz
Дополнительная проверка.
Проверить основные файлы:
ls -la
В каталоге должны находиться как минимум glovizorcfgc.exe, glovizorwebc.exe, glovizorgpsc.exe, install-service.sh и uninstall-service.sh.
Настройка Glovizor
Запустите консольный конфигуратор без sudo:
cd ~/glovizor
wine glovizorcfgc.exe
Главное меню
=== Glovizor configuration ===
1. Database
2. Web
3. Logging
4. Win services
5. About
6. Exit
Подключение к базе данных
Откройте Database. Меню раздела:
=== Database ===
1. Show settings
2. Edit settings
3. Test connection
4. Create database
5. Back
Откройте Edit settings и укажите:
- Server:
localhost— оставьте значение по умолчанию. - Database:
glovizor. - User:
glovizor. - Password: пароль, заданный при создании пользователя MySQL.
Сохраните настройки и выполните Test connection.
При первой установке, пока база еще не создана, нормальный результат:
SQL server connection successful.
Database connection failed: #42000Unknown database 'glovizor'
Важно. Такой результат означает, что соединение с MySQL и учетная запись работают. Ошибка относится только к отсутствующей базе glovizor и ожидаема на этом этапе.
Выполните Create database, затем повторите Test connection. Успешный результат:
Database created successfully.
SQL server connection successful.
Database connection successful.
Web и HTTPS
По умолчанию Glovizor использует HTTP-порт 8080 и HTTPS-порт 443. В разделе Web включите Use HTTPS. Порты менять не требуется, если стандартные значения подходят для сервера. HTTP для первоначальной проверки оставьте включенным.
В поставку Glovizor входит самоподписанный TLS-сертификат. Поэтому при первом открытии HTTPS браузер предупредит, что сертификат не является доверенным. Для продолжения разрешите переход на сайт. Для постоянной эксплуатации можно установить собственный доверенный TLS-сертификат; его настройка описывается отдельно и в данное руководство не входит.
Примечание. Порт 443 является привилегированным Linux-портом. Скрипт install-service.sh дает Web-службе право открывать его через CAP_NET_BIND_SERVICE; запуск всей службы от root для этого не требуется.
Регистрация служб Glovizor в systemd
Находясь в каталоге Glovizor, выполните:
sudo bash install-service.sh
Скрипт регистрирует две службы Glovizor:
glovizor-web.service— Web/HTTP/HTTPS сервер.glovizor-gps.service— сервер приема данных GPS-трекеров.
Обе службы запускаются сразу и включаются в автозапуск при старте Linux.
После выполнения скрипт должен показать:
Web: active
GPS: active
Проверка работы
Состояние служб
systemctl status glovizor-web --no-pager
systemctl status glovizor-gps --no-pager
Для обеих служб нормальное состояние — Active: active (running).
Web-доступ
С другого компьютера откройте в браузере оба адреса, подставив IP-адрес или доменное имя сервера:
http://SERVER_IP:8080
https://SERVER_IP
При первой установке должна открыться страница входа. Используйте начальную учетную запись:
- Пользователь:
admin - Пароль: оставьте поле пустым.
После первого входа рекомендуется сразу задать пароль для учетной записи admin.
Если HTTP и HTTPS открываются, Web-служба работает корректно. После проверки при необходимости можно отключить HTTP в настройках Glovizor и перезапустить Web-службу:
sudo systemctl restart glovizor-web
Диагностика Web-доступа
Этот раздел используйте, если Web-интерфейс Glovizor не открывается с другого компьютера. Проверки ниже позволяют отделить работу самого Glovizor от ограничений сети или firewall.
Проверка Web непосредственно на сервере
Сначала выполните HTTP-запрос к локальному адресу сервера:
curl http://127.0.0.1:8080
Затем проверьте HTTPS. Параметр -k разрешает подключение с самоподписанным сертификатом из поставки Glovizor:
curl -k https://127.0.0.1
Если Web-сервер Glovizor работает, curl вернет содержимое страницы — HTML-код Web-интерфейса. Это означает, что Glovizor принимает запросы на самом сервере.
Короткая проверка кода ответа. Если не нужно выводить всю страницу, можно проверить только HTTP-код ответа:
curl -sS -o /dev/null -w "HTTP: %{http_code}\n" http://127.0.0.1:8080
curl -k -sS -o /dev/null -w "HTTPS: %{http_code}\n" https://127.0.0.1
Коды 200, 301 или 302 означают, что Web-сервер отвечает.
Если локально работает, а с другого компьютера — нет
Если локальный curl возвращает страницу или корректный HTTP-код, Web-компонент Glovizor работает. В этом случае проверьте доступ к портам 8080 и 443 в firewall сервера, внешнем firewall или правилах сети/VPS-панели.
Если локальный запрос не проходит
Проверьте состояние Web-службы и наличие слушающих портов:
systemctl status glovizor-web --no-pager
sudo ss -ltnp | grep ":8080"
sudo ss -ltnp | grep ":443"
Если служба активна, но нужный порт отсутствует в LISTEN, проверьте настройки Web в конфигураторе Glovizor и после изменения перезапустите службу:
sudo systemctl restart glovizor-web
Дополнительная проверка автозапуска.
Перезагрузите сервер:
sudo reboot
После повторного входа проверьте:
systemctl status glovizor-web --no-pager
systemctl status glovizor-gps --no-pager
Обе службы должны запуститься автоматически.
Сетевые порты
В firewall сервера и внешнем firewall/VPS-панели должны быть разрешены используемые Web-порты. После добавления моделей GPS-трекеров в Web-интерфейсе также разрешите настроенные для них TCP-порты приема данных.
Управление службами
Web
sudo systemctl start glovizor-web
sudo systemctl stop glovizor-web
sudo systemctl restart glovizor-web
systemctl status glovizor-web --no-pager
GPS
sudo systemctl start glovizor-gps
sudo systemctl stop glovizor-gps
sudo systemctl restart glovizor-gps
systemctl status glovizor-gps --no-pager
Web и GPS можно останавливать и перезапускать независимо.
Удаление Glovizor
Сначала удалите службы Glovizor из systemd:
cd ~/glovizor
sudo bash uninstall-service.sh
Скрипт остановит Web и GPS, отключит их автозапуск и удалит зарегистрированные service unit-файлы.
После этого, если файлы программы больше не нужны, удалите рабочий каталог:
cd ~
rm -rf ~/glovizor
Если установочный архив был сохранен, его также можно удалить:
rm -f ~/glovizor.tar.gz
Примечание. Удаление служб и каталога Glovizor не удаляет базу данных MySQL и Wine prefix ~/.wine. При необходимости они удаляются отдельно администратором.