# Установка продукта 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-адреса.

  1. Перейдите в консоль VM

  2. Остановите службу kubelet:

    systemctl stop kubelet
    
  3. Удалите контейнеры

    nerdctl -n=k8s.io ps -q | xargs nerdctl -n=k8s.io rm -f
    
  4. Включите службу kubelet

    systemctl start kubelet
    
  5. Подождите 5-7 минут, будут пересозданы контейнеры с компонентами Kubernetes.

  6. Убедиться в работоспособности кластера можно следующей командой

    kubectl get po -n kube-system
    

    Все компоненты должны быть запущены и иметь статус Running

После этого переходите к установке прикладного программного обеспечения

# Установка прикладного программного обеспечения

Перед установкой ППО не забудьте выполнить Подготовку инфраструктуры

# Установка ППО

Внимание

Обязательным требованием перед запуском данного сценария является подготовка инфраструктуры.

  1. Подключитесь к виртуальной машине по SSH

    Логин и пароль monq:monq

  2. После входа автоматически запустится меню установщика

  3. Выберите пункт monq-install

    Изображение

  4. Прочтите лицензионное соглашение и нажмите "ОК"

    Изображение

  5. Задайте доменное имя устанавливаемой системы

    Предупреждение

    Обратите внимание, что доменное имя monq.local зарезервировано системой и его использование не допускается.

    Изображение

  6. Выберите локализацию по умолчанию для устанавливаемой системы

    Изображение

  7. Подтвердите правильность введенных данных и запустите установку

    Изображение

  8. На последнем этапе установки отобразится информация для подключения к веб-интерфейсу monq

    Изображение

Авторизационные данные для доступа к веб-интерфейсу Monq после установки:

  • логин - admin@{global_domain}
  • пароль - monq_admin

Секреты к инфраструктурным объектам Monq будут сохранены в секретах Kubernetes pl_auth и system_auth.

После успешной установки перейдите к руководству по управлению лицензионными ключами.

# Удаление ППО

Если установка завершилась с ошибкой или допущена опечатка в доменном имени, рекомендуется очистить СПО от следов ППО – для этого выполните специальный сценарий:

  1. Подключитесь к виртуальной машине по SSH

    Логин и пароль monq:monq

  2. После входа автоматически запустится меню установщика

  3. Выберите пункт monq-erase и подтвердите намерение удалить ППО.

    Изображение

# Дополнительно

# Переход в консоль управления виртуальной машиной (shell)

  1. Подключитесь к виртуальной машине по SSH

    Логин и пароль monq:monq

  2. После входа автоматически запустится меню установщика
  3. Выберите пункт Exit to shell
  4. Пользователю 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 -

# Настройка внешнего сервера Nginx для проксирования запросов в Monq

Пример конфигурационного файла 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;
}

# Подключение производственного календаря

Подключение производственного календаря

# Импорт образа в VMware vSphere

  1. Скачайте образ установщика с сайта monq.ru (opens new window):

    Загруженный архив содержит файл виртуального диска monq-installer-full.vmdk с предустановленным системным ПО.

  2. Загрузите файл monq-installer-full.vmdk в datastore вашего гипервизора любым удобным способом.

  3. Подключитесь к гипервизору по протоколу 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.
    
  4. Создайте виртуальную машину, обратите особое внимание на следующие параметры при создании:

    • SCSI controller - LSI Logic Parallel
    • Use an existing virtual disk - Выберите новый импортированный диск в п.3
  5. Сохраните параметры, включите виртуальную машину.

  6. Первый раз загрузите систему в rescue режиме и выполните команду dracut -f для пересоздания initramfs.

  7. Выполните перезагрузку shutdown -r now и переходите к дальнейшей подготовке инфраструктуры.