# Установка продукта monq
Данное руководство поможет вам установить 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 сервером перезапуск компонентов кластера не требуется.
# Перезапуск компонентов кластера Kubernetes
Выполняется только при ручном назначении IP-адреса.
Перейдите в консоль VM
Остановите службу kubelet:
systemctl stop kubelet
Удалите контейнеры
docker ps --format "{{.Names}}" -f "name=k8s_kube*" -f "name=k8s_POD_kube*" | xargs docker 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 и подтвердите намерение удалить ППО.
# Дополнительно
# Переход в консоль управления виртуальной машиной (shell)
- Подключитесь к виртуальной машине по SSH
Логин и пароль
monq:monq
- После входа автоматически запустится меню установщика
- Выберите пункт Exit to shell
- Пользователю
monq
доступны привилегии суперпользователя.
# Замена SSL-сертификата
Если система установлена с использованием реального доменного имени и у вас имеется 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 -
# Подключение производственного календаря
Подключение производственного календаря
# Импорт образа в VMware vSphere
Скачайте образ установщика с сайта monqlab.com (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.
Создайте виртуальную машину, обратите особое внимание на следующие параметры при создании:
- SCSI controller - LSI Logic Parallel
- Use an existing virtual disk - Выберите новый импортированный диск в п.3
Сохраните параметры, включите виртуальную машину.
Первый раз загрузите систему в rescue режиме и выполните команду
dracut -f
для пересоздания initramfs.Выполните перезагрузку
shutdown -r now
и переходите к дальнейшей подготовке инфраструктуры.