Данное руководство поможет вам установить Monq.
ВНИМАНИЕ
Перед установкой Monq обязательно ознакомьтесь с системными требованиями и архитектурой продукта.
Установка делится на два основных этапа: подготовка инфраструктуры и установка ПО Monq.
Внимание
Установка продуктов Monq выполняется с помощью образа VM.
Авторизационные данные администратора VM – root/root
.
Выполните импорт образа в систему виртуализации.
Образ установщика подготовлен для импорта в VMware vSphere 6.5, VMware Workstation, VMWare Player. Также образ успешно конвертируется для импорта и в другие системы виртуализации. Проверялась работа на Xen, Hyper-V, oVirt(kvm).
Справочную информацию по импорту в VMWare Workstation вы можете найти здесь
Для импорта образа в VMWare vSphere воспользуйтесь следующими рекомендациями.
После первого запуска виртуальной машины необходимо произвести загрузку в rescue-mode.
После загрузки ОС войти в консоль и выполнить команду dracut -f
для создания нового файла initramfs
(initial RAM disk image, загружаемый в оперативную память файл с образом файловой системы)
После успешного импорта образа в среду виртуализации создайте на виртуальной машине сетевой интерфейс и включите VM.
Внимание
Если IP-адрес VM назначается вручную, после включения VM потребуется выполнить перезапуск компонентов кластера Kubernetes.
Если адрес назначается DHCP сервером перезапуск компонентов кластера не требуется.
Выполняется только при ручном назначении IP-адреса.
Перейдите в консоль VM
Остановите службу kubelet:
systemctl stop kubelet
Удалите контейнеры
nerdctl -n=k8s.io ps -q | xargs nerdctl -n=k8s.io rm -f
Включите службу kubelet
systemctl start kubelet
Подождите 5-7 минут, будут пересозданы контейнеры с компонентами Kubernetes.
Убедиться в работоспособности кластера можно следующей командой
kubectl get po -n kube-system
Все компоненты должны быть запущены и иметь статус Running
После этого переходите к установке прикладного программного обеспечения
Перед установкой ППО не забудьте выполнить Подготовку инфраструктуры
Внимание
Обязательным требованием перед запуском данного сценария является подготовка инфраструктуры.
Подключитесь к виртуальной машине по SSH
Логин и пароль
monq:monq
После входа автоматически запустится меню установщика
Выберите пункт monq-install
Прочтите лицензионное соглашение и нажмите "ОК"
Задайте доменное имя устанавливаемой системы
Предупреждение
Обратите внимание, что доменное имя monq.local
зарезервировано системой и его использование не допускается.
Выберите локализацию по умолчанию для устанавливаемой системы
Подтвердите правильность введенных данных и запустите установку
На последнем этапе установки отобразится информация для подключения к веб-интерфейсу monq
Авторизационные данные для доступа к веб-интерфейсу Monq после установки:
admin@{global_domain}
monq_admin
Секреты к инфраструктурным объектам Monq будут сохранены в секретах Kubernetes pl_auth
и system_auth
.
После успешной установки перейдите к руководству по управлению лицензионными ключами.
Если установка завершилась с ошибкой или допущена опечатка в доменном имени, рекомендуется очистить СПО от следов ППО – для этого выполните специальный сценарий:
Подключитесь к виртуальной машине по SSH
Логин и пароль
monq:monq
После входа автоматически запустится меню установщика
Выберите пункт monq-erase и подтвердите намерение удалить ППО.
Логин и пароль
monq:monq
monq
доступны привилегии суперпользователя.Если система установлена с использованием реального доменного имени и у вас имеется SSL-сертификат для этого домена(файлы fullchain.pem
и privkey.pem
), выполните следующую команду:
kubectl create secret tls {GLOBAL-DOMAIN}-tls --cert={fullchain.pem} --key={privkey.pem} --dry-run -n production -o yaml | kubectl -n production replace -n production -f -
Пример конфигурационного файла Nginx для проксирования запросов на внутренний инстанс Monq.
upstream monq {
server <MonqIP>:443;
}
server {
listen *:443 ssl;
listen [::]:443 ssl;
server_name <MONQ DOMAIN NAME>;
client_max_body_size 32m;
access_log /dev/null;
error_log /dev/null;
location / {
proxy_pass https://monq;
proxy_set_header Host <MONQ DOMAIN NAME>;
expires -1;
}
location /api/webui/pl/hubs {
proxy_pass https://monq;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 900s;
proxy_set_header Host <MONQ DOMAIN NAME>;
}
ssl_certificate /etc/nginx/ssl/<MONQ DOMAIN NAME>.cert.pem;
ssl_certificate_key /etc/nginx/ssl/<MONQ DOMAIN NAME>.key.pem;
}
Подключение производственного календаря
Скачайте образ установщика с сайта monq.ru (opens new window):
Загруженный архив содержит файл виртуального диска
monq-installer-full.vmdk
с предустановленным системным ПО.
Загрузите файл monq-installer-full.vmdk
в datastore вашего гипервизора любым удобным способом.
Подключитесь к гипервизору по протоколу SSH и выполните следующую команду для импорта образа диска:
#vmkfstools -i {путь к файлу monq-installer-full.vmdk} {путь к новому образу диска.vmdk}
cd /vmfs/volumes/datastore1/
vmkfstools -i monq-installer-full.vmdk disk-full.vmdk
Destination disk format: VMFS zeroedthick
Cloning disk 'monq-installer-full.vmdk'...
Clone: 100% done.
Создайте виртуальную машину, обратите особое внимание на следующие параметры при создании:
Сохраните параметры, включите виртуальную машину.
Первый раз загрузите систему в rescue режиме и выполните команду dracut -f
для пересоздания initramfs.
Выполните перезагрузку shutdown -r now
и переходите к дальнейшей подготовке инфраструктуры.