Это руководство описывает установку платформы Navixy On-Premise с помощью автоматизированных скриптов.
Данный тип установки предназначен и поддерживается только на 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.
Будьте осторожны, чтобы не выбрать другие опции, так как они должны использоваться для развертывания платформы на два сервера.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/11-select1.png)
Скрипт инициирует проверку системы и программного обеспечения.
Вы увидите процесс установки необходимого ПО, включая Java и MySQL.
Вы увидите запрос на перезапуск MySQL, подтвердите это, введя 1
. Далее вам будет предложено подтвердить инициализацию баз данных, снова ответьте положительно, введя y
.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/12-this-will-initialize-navixy1.png)
MySQL попросит вас указать пароль root. Данный пароль не используется для работы платформы и не является обязательным, поэтому вы можете оставить его пустым. Если вы укажете какой-либо пароль, не забудьте его запомнить на тот случай, если вам потребуется дальнейшее вмешательство в БД.
Далее скрипт создаст базы данных и пользователя БД navixy со случайным паролем. Это будет основной пользователь, используемый сервисами платформы для взаимодействия с БД. Однако вам не нужно запоминать его пароль, так как он будет автоматически вставлен в конфигурационные файлы. После этого скрипт заполнит базу данных системными таблицами.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/13-default-password1.png)
После инициализации базы данных скрипт выполнит следующие действия:
- Создаст пользователя для Java-сервисов (бэкэнд)
- Создаст каталоги Java-сервисов и заполнит их необходимыми файлами
- Скопирует и настроит веб-компоненты (фронтенд)
- Скопирует скрипты runit, необходимые для запуска Java-сервисов
- Настроит Java-сервисы
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/14-done1.png)
На этом базовая установка платформы завершена.
Теперь необходимо выполнить конфигурацию платформы с помощью скрипта ./configure.sh.
Вам понадобится дистрибутив платформы, полученный от команды Navixy. Как правило, это архив tar.gz. Загрузите и распакуйте архив на оба сервера.
Перейдите в каталог с архивом и выполните следующую команду для его распаковки (само собой, замените PACKAGE_NAME
фактическим именем файла):
tar -zxvf PACKAGE_NAME.tar.gz
Архив будет распакован в каталог navixy-package.
Дальнейшая установка должна быть выполнена сначала на сервере базы данных, а затем на сервере приложений.
Сервер базы данных
Откройте каталог navixy-package и запустите из него скрипт install.sh.
./install.sh
Вам будет предложено выбрать роль сервера для дальнейшего развертывания.
Выберите #2 SQL server.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/21-select-db-11.png)
Скрипт инициирует проверку системы и программного обеспечения. Далее будет выполнена установка и настройка MySQL.
Вы увидите запрос на перезапуск MySQL, подтвердите это, введя 1
. Далее вам будет предложено подтвердить инициализацию баз данных, снова ответьте положительно, введя y
.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/22-this-will-initialize-navixy-11.png)
MySQL попросит вас указать пароль root. Данный пароль не используется для работы платформы и не является обязательным, поэтому вы можете оставить его пустым. Если вы укажете какой-либо пароль, не забудьте его запомнить на тот случай, если вам потребуется дальнейшее вмешательство в БД.
Далее скрипт создаст базы данных и пользователя БД navixy со случайным паролем. Это будет основной пользователь, используемый сервисами платформы для взаимодействия с БД.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/23-default-password-11.png)
Скрипт заполнит базу данных системными таблицами.
После инициализации базы данных вы увидите следующую информацию:
- Username: navixy - это пользователь БД, который указывается в системных конфигурациях для взаимодействия с базой данных.
- Password: random - пароль для пользователя navixy.
- IP address: фактический адрес сервера базы данных.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/24-db-login-pass-ip-11.png)
Сохраните эти значения, так как они понадобятся вам во время настройки сервера приложений.
Сервер приложений
Откройте каталог navixy-package и запустите из него скрипт install.sh.
./install.sh
Вам будет предложено выбрать роль сервера для дальнейшего развертывания.
Выберите #3 Application server.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/25-select-app-11.png)
Сценарий загрузит и установит Java, Nginx и другое ПО, необходимое для работы платформы. Это будет сделано автоматически и не требует вашего внимания.
После установки необходимого программного обеспечения скрипт запросит у вас пароль пользователя SQL. Это пароль пользователя navixy, который вы получили после установки базы данных. Используйте Shift+Insert
, чтобы вставить скопированный пароль из буфера обмена.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/26-sql-pass-11.png)
Далее вам будет предложено ввести IP-адрес вашего сервера базы данных.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/27-sql-ip-11.png)
Скрипт проверит, что IP-адрес действителен.
Затем вам будет предложено подтвердить установку сервисов платформы на вашем сервере.
Сделайте это, набрав y
и нажав Enter
.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/28-ip-is-valid-11.png)
Скрипт выполнит следующие действия:
- Создаст пользователя для Java-сервисов (бэкэнд)
- Создаст каталоги Java-сервисов и заполнит их необходимыми файлами
- Скопирует и настроит веб-компоненты (фронтенд)
- Скопирует скрипты runit, необходимые для запуска Java-сервисов
- Настроит Java-сервисы
На этом базовая установка платформы завершена.
Теперь необходимо выполнить конфигурацию платформы с помощью скрипта ./configure.sh.
Конфигуратор
После запуска скрипта ./configure.sh вы увидите меню мастера настройки:
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/31-configuration-menu-11.png)
На этом этапе вам необходимо выполнить первичную конфигурацию для правильной работы платформы. Для этого вам понадобится сделать следующее:
- Указать имена доменов;
- Применить лицензионный ключ;
- Установить сертификаты для доменов.
Доменные имена
Прежде всего, необходимо настроить доменные имена. Они необходимы для работы системы, поскольку указываются почти во всех конфигурационных файлах.
К этому моменту у вас должны быть зарегистрированные домены третьего уровня, предназначенные для API, панели администратора и пользовательского интерфейса.
Выберите #1 Domain name settings в меню мастера настройки.
Вы увидите единственный вариант #1 Change domain names, выберите его.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/32-change-domain-names1.png)
Вам будет предложено настроить доменное имя.
Здесь вам нужно указать домен второго уровня. В нашем примере это mywebsite.com.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/33-second-level-domain1.png)
После этого необходимо последовательно указать доменные имена для API, панели администратора и пользовательского интерфейса. Будьте внимательны - здесь вы указываете только доменные имена третьего уровня, не указывая второй и верхний уровни.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/34-api-domain1.png)
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/35-panel-domain1.png)
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/36-ui-domain1.png)
После указания всех доменов вы увидите результаты настройки.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/37-domains-done1.png)
Если вы видите, что какой-либо из доменов указан неверно, запустите мастер еще раз, чтобы указать правильные значения.
Лицензионный ключ
Лицензионный ключ (fingerprint) предоставляется командой Navixy.
Выберите #5 License key settings в меню мастера настройки.
Вы увидите два варианта:
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/41-changekey-11.png)
Выберите #1 Change license key.
Вы увидите предупреждение о том, что не следует менять ключ без причины. Нажмите OK, чтобы продолжить.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/42-warning-11.png)
Далее вам будет предложено ввести лицензионный ключ.
Поскольку лицензионный ключ состоит из множества различных символов, его нецелесообразно вводить вручную. Если вы используете SSH-клиент для подключения к серверу, вы можете вставить ключ из буфера обмена. Для этого используйте комбинацию клавиш Shift + Insert
. Также вы можете использовать для этого правую кнопку мыши
, удерживая Shift
.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/43-insert-key-11.png)
После применения ключа вам будет предложено перезапустить службы платформы. Сделайте это с помощью следующей команды:
restart-navixy
Таким образом вы перезапустите Java-сервисы платформы (бэкенд), после чего произойдет проверка лицензии.
SSL-сертификаты
Во время автоматической установки платформа настраивается на использование HTTPS в URL-адресах во всех конфигурационных файлах. Поэтому после развертывания платформы вам необходимо установить SSL-сертификаты для ваших доменов.
Запустите мастер настройки и выберите #8 SSL certificate settings.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/51-sslstart1.png)
В следующем меню будет единственная опция - install SSL certificates. Выберите её.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/52-ssl11.png)
Вы увидите предупреждение о том, что вам потребуются зарегистрированные DNS-записи и публичный IP-адрес. Подтвердите, чтобы продолжить.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/53-ssl-confirmation1.png)
Скрипт задаст вам вопрос, собираетесь ли вы использовать бесплатные SSL-сертификаты Letsencrypt.
Выберите Yes, чтобы установить для ваших доменов бесплатные SSL-сертификаты с автоматическим продлением.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/54-ssl-le-or-not1.png)
Скрипт установит программное обеспечение, необходимое для выпуска сертификата. Вам нужно будет принять terms of service - введите y
.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/55-ssl-le-agree-11.png)
Далее вам будет предложено выбрать домены, для которых необходимо установить сертификаты. Рекомендуется сделать это для всех доменов сразу. Для этого вам не нужно ничего вводить, просто оставьте поле пустым и нажмите Enter
.
![Автоматическая установка Автоматическая установка](https://www.navixy.ru/wp-content/uploads/2023/09/56-ssl-le-domains-11.png)
Теперь сертификаты выпущены и установлены, и ваши домены защищены SSL. Вам больше не нужно беспокоиться о сертификатах, так как установленное программное обеспечение будет автоматически их обновлять.
Установка завершена
Теперь вы можете войти в панель администратора, используя доменное имя, которое вы указали во время установки. Логин по умолчанию - 'admin', пароль - 'admin'.
Для выполнения дополнительных настроек можно снова воспользоваться мастером конфигурации мастером конфигурации.
Если у вас возникли вопросы по установке или настройке продукта, обратитесь в службу технической поддержки Navixy по адресу support@navixy.ru.