# Установка продукта 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 и переходите к дальнейшей подготовке инфраструктуры.