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

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

ВНИМАНИЕ

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

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

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

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

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

ВНИМАНИЕ

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

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

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

dns=8.8.8.8
gw=192.168.1.1
ipa=192.168.1.28/24
   
nmcli connection modify "Wired connection 1" ipv4.dns ${dns} ipv4.addresses ${ipa} ipv4.gateway ${gw} ipv4.method manual

# Установка инфраструктуры

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

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

Дальнейшие действия производятся в веб-интерфейсе:

  1. Перейдите в веб-интерфейс installer.in.monq.local:888
  2. Авторизуйтесь под учетной записью admin/admin
  3. Перейдите в PROJECTSmonqJOBS и запустите infra install
  4. Задайте значения переменных:
    • global_domain – основное доменное имя, после запуска система будет доступна по данному доменному имени, например – monq.example.ru.
    • nodeIp – IP-адрес целевого сервера, на котором устанавливается monq.
  5. Запустите сценарий в веб-интерфейсе – нажмите Run Job Now.
  6. После выполнения сценария на сервере будут запущены инфраструктурные объекты внутри Kubernetes.

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

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

ВНИМАНИЕ

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

  1. Перейдите в веб-интерфейс установщика по адресу installer.in.monq.local:888.
  2. Перейдите в PROJECTSmonqJOBS и запустите monq install.
  3. Задайте значения переменных
    • global_domain – основное доменное имя. После запуска, система будет доступна по данному доменному имени, например, monq.example.ru.
    • nodeIp – IP-адрес сервера, на котором будет продолжена установка monq.
  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 и его инфраструктурным объектам будут сохранены в секретах kubernetes pl_auth и system_auth. В случае утери авторизационных данных, пароль можно восстановить следующим образом – выполните на целевом сервере команду от имени учетной записи root:
    kubectl get secrets -n production pl-auth -o json | jq -r .data.pl_auth | base64 --decode | jq .identity_connect_info.identity_users.UserProfileAdmin.identity_user_password
    

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

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

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

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