# Установка продукта monq

Данное руководство поможет вам установить monq на выделенные серверы.

ВНИМАНИЕ

Перед установкой monq обязательно ознакомьтесь с требованиями и архитектурой продукта.

Установка monq делится на два основных этапа:

Воспользуйтесь ссылками для быстрого перехода к нужному этапу установки.

# Настройка инфраструктуры

# Импорт образа VM

Внимание

Установка продуктов monq выполняется с помощью образа VM.
Авторизационные данные администратора VM – root/root.

Выполните импорт образа в систему виртуализации. Создайте на виртуальной машине сетевой интерфейс и включите VM. Справочную информацию по импорту вы можете найти здесь

Образ установщика подготовлен для импорта в VMware vSphere 6.5, VMware Workstation, VMWare Player. Если вы используете VMware vSphere 5.5 обратите внимание на следующие нюансы.

Внимание

Если адрес VM назначается вручную, после включения VM потребуется выполнить перезапуск компонентов кластера kubernetes.

Если адрес назначается DHCP сервером перезапуск компонентов кластера не требуется.

Перезапуск компонентов кластера kubernetes:

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

  2. Остановить kubelet:

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

    docker ps --format "{{.Names}}" -f "name=k8s_kube*" -f "name=k8s_POD_kube*" | xargs docker rm -f
    
  4. Включить kubelet

    systemctl start kubelet
    
  5. Подождать 5 минут, будут пересозданы контейнеры с компонентами kubernetes, убедиться в работоспособности кластера можно следующей командой

    kubectl get po -n kube-system
    

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

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

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

Обеспечьте разрешение имен на машине, с которой будет производится установка – сконфигурируйте файл hosts:

<IP-адрес-сервера> installer.in.monq.local

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

ВНИМАНИЕ

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

  1. Перейдите в веб-интерфейс установщика по адресу installer.in.monq.local:888 (admin/admin).

  2. Перейдите в PROJECTSmonqJOBS и запустите monq install.

  3. Задайте значения переменной global_domain – основное доменное имя. После запуска, система будет доступна по данному доменному имени, например, monq.example.ru.

  4. Запустите сценарий в веб-интерфейсе – нажмите Run Job Now.

  5. Перейдите в журнал выполнения – нажмите Log Output.

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

    TASK [sm : echo ui interface credentials] **************************************
    ok: [d-head] => {
    "msg": [
        "save you credentials:",
        "- ui interface: <доменное имя>",
        "- ui interface username: <имя пользователя>",
        "- ui interface password: <пароль>"
            ]
        }
    

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

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

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

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

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

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

  1. Перейдите в веб-интерфейс установщика по адресу installer.in.monq.local:888.
  2. Перейдите в PROJECTSmonqJOBS и запустите monq erase.
  3. Задайте значение переменной nodeIp – IP-адрес сервера, на котором устанавливался monq.
  4. Запустите сценарий в веб-интерфейсе, кнопка Run Job Now.

# Особенности установщика

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

  1. Скачайте образ установщика в виде VM:

    Образ содержит 2 файла:

    • monq_{version}.ovf
    • monq_{version}-disk1.vmdk

    Файл с расширением monq_{version}.ovf подготовлен для VMware vSphere 6.5 и соответственно несовместим с VMware vSphere 5.5.

  2. Загрузите в datastore вашего гипервизора файл monq_{version}-disk1.vmdk любым удобным способом.

  3. Подключитесь к гипервизору по протоколу SSH и выполните следующую команду для импорта образа диска:

    vmkfstools -i {путь к файлу monq_{version}-disk1.vmdk} {путь к новому образу диска.vmdk}
    
  4. Создайте виртуальную машину, обратите особое внимание на следующие параметры при создании:

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

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

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