Это руководство описывает установку платформы Navixy On-Premise с помощью автоматизированных скриптов.
Данный тип установки предназначен и поддерживается только на Ubuntu 20 и 22.
Для других дистрибутивов Linux, а также для серверов Windows доступна только ручная установка. Если ваша ОС отличается от Ubuntu 20 или 22, перейдите к соответствующим руководствам.
Перед началом установки необходимо, чтобы у вас было следующее:
- Сервер (или серверы), отвечающий всем требованиям к оборудованию
- Зарегистрированные доменные имена для вашего сервера Navixy
- Установочный пакет платформы Navixy, полученный от команды техподдержки или вашего аккаунт-менеджера.
- Лицензионный ключ (обычно предоставляется вместе с установочным пакетом)
Если вы выполняете автоматическую установку, вам не нужно беспокоиться об установке необходимого программного обеспечения, так как оно будет установлено и настроено вместе с платформой.
Установка
Следующие шаги зависят от того, будет ли у вас один сервер ("все в одном") или отдельные серверы для приложений и базы данных.
Пожалуйста, выберите вкладку, соответствующую вашему типу установки.
Для начала распакуйте дистрибутив платформы, который вы получили от команды Navixy. Как правило, это архив tar.gz. Перейдите в каталог с архивом и выполните следующую команду для его распаковки (само собой, замените PACKAGE_NAME фактическим именем файла):
tar -zxvf PACKAGE_NAME.tar.gz
Архив будет распакован в каталог navixy-package.
Затем откройте этот каталог и запустите из него скрипт install.sh
./install.sh
Вам будет предложено выбрать роль сервера для дальнейшего развертывания.
Выберите Single server - all services in one server.
Будьте осторожны, чтобы не выбрать другие опции, так как они должны использоваться для развертывания платформы на два сервера.
Скрипт инициирует проверку системы и программного обеспечения.
Вы увидите процесс установки необходимого ПО, включая Java и MySQL.
Вы увидите запрос на перезапуск MySQL, подтвердите это, введя 1. Далее вам будет предложено подтвердить инициализацию баз данных, снова ответьте положительно, введя y.
MySQL попросит вас указать пароль root. Данный пароль не используется для работы платформы и не является обязательным, поэтому вы можете оставить его пустым. Если вы укажете какой-либо пароль, не забудьте его запомнить на тот случай, если вам потребуется дальнейшее вмешательство в БД.
Далее скрипт создаст базы данных и пользователя БД navixy со случайным паролем. Это будет основной пользователь, используемый сервисами платформы для взаимодействия с БД. Однако вам не нужно запоминать его пароль, так как он будет автоматически вставлен в конфигурационные файлы. После этого скрипт заполнит базу данных системными таблицами.
После инициализации базы данных скрипт выполнит следующие действия:
- Создаст пользователя для Java-сервисов (бэкэнд)
- Создаст каталоги Java-сервисов и заполнит их необходимыми файлами
- Скопирует и настроит веб-компоненты (фронтенд)
- Скопирует скрипты runit, необходимые для запуска Java-сервисов
- Настроит Java-сервисы
На этом базовая установка платформы завершена.
Теперь необходимо выполнить конфигурацию платформы с помощью скрипта ./configure.sh.
Вам понадобится дистрибутив платформы, полученный от команды Navixy. Как правило, это архив tar.gz. Загрузите и распакуйте архив на оба сервера.
Перейдите в каталог с архивом и выполните следующую команду для его распаковки (само собой, замените PACKAGE_NAME фактическим именем файла):
tar -zxvf PACKAGE_NAME.tar.gz
Архив будет распакован в каталог navixy-package.
Дальнейшая установка должна быть выполнена сначала на сервере базы данных, а затем на сервере приложений.
Сервер базы данных
Откройте каталог navixy-package и запустите из него скрипт install.sh.
./install.sh
Вам будет предложено выбрать роль сервера для дальнейшего развертывания.
Выберите #2 SQL server.
Скрипт инициирует проверку системы и программного обеспечения. Далее будет выполнена установка и настройка MySQL.
Вы увидите запрос на перезапуск MySQL, подтвердите это, введя 1. Далее вам будет предложено подтвердить инициализацию баз данных, снова ответьте положительно, введя y.
MySQL попросит вас указать пароль root. Данный пароль не используется для работы платформы и не является обязательным, поэтому вы можете оставить его пустым. Если вы укажете какой-либо пароль, не забудьте его запомнить на тот случай, если вам потребуется дальнейшее вмешательство в БД.
Далее скрипт создаст базы данных и пользователя БД navixy со случайным паролем. Это будет основной пользователь, используемый сервисами платформы для взаимодействия с БД.
Скрипт заполнит базу данных системными таблицами.
После инициализации базы данных вы увидите следующую информацию:
- Username: navixy - это пользователь БД, который указывается в системных конфигурациях для взаимодействия с базой данных.
- Password: random - пароль для пользователя navixy.
- IP address: фактический адрес сервера базы данных.
Сохраните эти значения, так как они понадобятся вам во время настройки сервера приложений.
Сервер приложений
Откройте каталог navixy-package и запустите из него скрипт install.sh.
./install.sh
Вам будет предложено выбрать роль сервера для дальнейшего развертывания.
Выберите #3 Application server.
Сценарий загрузит и установит Java, Nginx и другое ПО, необходимое для работы платформы. Это будет сделано автоматически и не требует вашего внимания.
После установки необходимого программного обеспечения скрипт запросит у вас пароль пользователя SQL. Это пароль пользователя navixy, который вы получили после установки базы данных. Используйте Shift+Insert, чтобы вставить скопированный пароль из буфера обмена.
Далее вам будет предложено ввести IP-адрес вашего сервера базы данных.
Скрипт проверит, что IP-адрес действителен.
Затем вам будет предложено подтвердить установку сервисов платформы на вашем сервере.
Сделайте это, набрав y и нажав Enter.
Скрипт выполнит следующие действия:
- Создаст пользователя для Java-сервисов (бэкэнд)
- Создаст каталоги Java-сервисов и заполнит их необходимыми файлами
- Скопирует и настроит веб-компоненты (фронтенд)
- Скопирует скрипты runit, необходимые для запуска Java-сервисов
- Настроит Java-сервисы
На этом базовая установка платформы завершена.
Теперь необходимо выполнить конфигурацию платформы с помощью скрипта ./configure.sh.
Конфигуратор
После запуска скрипта ./configure.sh вы увидите меню мастера настройки:
На этом этапе вам необходимо выполнить первичную конфигурацию для правильной работы платформы. Для этого вам понадобится сделать следующее:
- Указать имена доменов;
- Применить лицензионный ключ;
- Установить сертификаты для доменов.
Доменные имена
Прежде всего, необходимо настроить доменные имена. Они необходимы для работы системы, поскольку указываются почти во всех конфигурационных файлах.
К этому моменту у вас должны быть зарегистрированные домены третьего уровня, предназначенные для API, панели администратора и пользовательского интерфейса.
Доменные имена третьего уровня могут быть абсолютно любыми, в этом отношении нет никаких ограничений. Однако мы настоятельно рекомендуем использовать очевидные имена для облегчения дальнейшей работы.
В приведенном ниже примере мы будем использовать нестандартные имена для большей ясности:
- Сервис API: myapi.mywebsite.com
- Панель администратора: adminpanel.mywebsite.com
- Пользовательский интерфейс: client.mywebsite.com
Выберите #1 Domain name settings в меню мастера настройки.
Вы увидите единственный вариант #1 Change domain names, выберите его.
Вам будет предложено настроить доменное имя.
Здесь вам нужно указать домен второго уровня. В нашем примере это mywebsite.com.
После этого необходимо последовательно указать доменные имена для API, панели администратора и пользовательского интерфейса. Будьте внимательны - здесь вы указываете только доменные имена третьего уровня, не указывая второй и верхний уровни.
После указания всех доменов вы увидите результаты настройки.
Если вы видите, что какой-либо из доменов указан неверно, запустите мастер еще раз, чтобы указать правильные значения.
Лицензионный ключ
Лицензионный ключ (fingerprint) предоставляется командой Navixy.
Ключ необходим для проверки лицензии, когда ваш сервер связывается с сервером аутентификации auth.navixy.com. После успешной проверки лицензии платформа позволит регистрировать устройства, а также начнет обрабатывать данные отслеживания и телематики. Без указания корректного лицензионного ключа ваши устройства не смогут отображаться онлайн.
Выберите #5 License key settings в меню мастера настройки.
Вы увидите два варианта:
Выберите #1 Change license key.
Вы увидите предупреждение о том, что не следует менять ключ без причины. Нажмите OK, чтобы продолжить.
Далее вам будет предложено ввести лицензионный ключ.
Поскольку лицензионный ключ состоит из множества различных символов, его нецелесообразно вводить вручную. Если вы используете SSH-клиент для подключения к серверу, вы можете вставить ключ из буфера обмена. Для этого используйте комбинацию клавиш Shift + Insert. Также вы можете использовать для этого правую кнопку мыши, удерживая Shift.
После применения ключа вам будет предложено перезапустить службы платформы. Сделайте это с помощью следующей команды:
restart-navixy
Таким образом вы перезапустите Java-сервисы платформы (бэкенд), после чего произойдет проверка лицензии.
SSL-сертификаты
Во время автоматической установки платформа настраивается на использование HTTPS в URL-адресах во всех конфигурационных файлах. Поэтому после развертывания платформы вам необходимо установить SSL-сертификаты для ваших доменов.
Запустите мастер настройки и выберите #8 SSL certificate settings.
В следующем меню будет единственная опция - install SSL certificates. Выберите её.
Вы увидите предупреждение о том, что вам потребуются зарегистрированные DNS-записи и публичный IP-адрес. Подтвердите, чтобы продолжить.
Скрипт задаст вам вопрос, собираетесь ли вы использовать бесплатные SSL-сертификаты Letsencrypt.
Выберите Yes, чтобы установить для ваших доменов бесплатные SSL-сертификаты с автоматическим продлением.
Скрипт установит программное обеспечение, необходимое для выпуска сертификата. Вам нужно будет принять terms of service - введите y.
Далее вам будет предложено выбрать домены, для которых необходимо установить сертификаты. Рекомендуется сделать это для всех доменов сразу. Для этого вам не нужно ничего вводить, просто оставьте поле пустым и нажмите Enter.
Теперь сертификаты выпущены и установлены, и ваши домены защищены SSL. Вам больше не нужно беспокоиться о сертификатах, так как установленное программное обеспечение будет автоматически их обновлять.
Установка завершена
Теперь вы можете войти в панель администратора, используя доменное имя, которое вы указали во время установки. Логин по умолчанию - 'admin', пароль - 'admin'.
Для выполнения дополнительных настроек можно снова воспользоваться мастером конфигурации мастером конфигурации.
Если у вас возникли вопросы по установке или настройке продукта, обратитесь в службу технической поддержки Navixy по адресу support@navixy.ru.