Skip to main content
Skip table of contents

Установка дистрибутива решения на сервер

Общая информация | Обязательно к прочтению

Образ дистрибутива решения основан на Debian. Данный материал не ставит целью обучить вас устанавливать классический Debian-based дистрибутив.

Для гибкости при инсталляции решения на серверы, предоставляется два типа инсталляционных образов: для первичного хоста, включающего компонент центрального сервера оркестрации, и для вторичных хостов, не включающего его. В дальнейшем для расширения центрального сервера допускается повторная установка первичного образа на другие хосты.

Образ для первичной ноды можно использовать и для инсталляции вторичных нод, т.к. он содержит все пакеты.

Внимание!

В любом типе установки при разметке дисков требуется закладывать 2,5х от объема оперативной памяти под SWAP.

После установка решения Вам необходимо настроить систему. Для этого используйте инструкцию по настройке: Настройка и лицензирование решения после установки.

Инструкции по различным типам установки

Инсталляция с помощью ISO-образов

Применение

  1. Когда есть физический доступ к серверам;

  2. Когда есть быстрое сетевое соединение с сервером и возможность по сети примонтировать ISO-образ в KVM интерфейсе (или аналога) сервера.

Инструкция по установке – физический доступ к серверу или доступ к IPMI/KVM

  1. Получаем образы с помощью предоставленной ссылки или оффлайн при физической передаче решения:

    CODE
    install_primary.iso
    install_secondary.iso
  2. Монтируем виртуальный диск средствами IPMI интерфейса (или аналога) или вставляем в сервер USB накопитель подходящего размера (>= 16Gb) с заранее записанным образом через утилиту dd;

  3. Выбираем в BIOS загрузку с Virtual Media / USB;

  4. Устанавливаем решение по общей процедуре установки (см. установочное видео): на первичный сервер install_primary.iso, на дальнейшие install_secondary.iso.

Инсталляция с помощью IPXE или ipxe.iso образа через IPMI/KVM

Применение

Когда есть медленное сетевое соединение с сервером с IPMI/KVM-интерфейсом управления с возможностью подключать ISO-образы + есть другой вспомогательный сервер в сети с настраиваемым сервером, либо публичный вспомогательный сервер в интернете (обычно https://assets.aircloud.org/menu.ipxe), к которому есть доступ из сети настраиваемого сервера.

Инструкция по установке с публичного IPXE сервера

Используйте ссылку https://assets.aircloud.org/menu.ipxe для IPXE установки. Для доступа вам должны предоставить логин и пароль. Если консоль сервера не имеет встроенной IPXE установки, используйте IPXE образ: https://boot.ipxe.org/ipxe.iso.

Подробные шаги установки:

  1. Получаем образы (https://boot.ipxe.org/ipxe.iso):

    CODE
    ipxe.iso
  2. В IPMI/KVM-интерфейсе монтируем ipxe.iso на сервер, куда ставим продукт и загружаемся с этого ISO;

  3. В момент загрузки будет возможность получить консоль для ввода команд
    Для этого нужно нажать Ctrl+B. Момент легко упустить, поэтому лучшей тактикой будет постоянно нажимать эту комбинацию.

  4. Настройка сети:

    1. Если в сети есть dhcp-сервер, который выдаст ip для данного сервера, то в консоли набрать комманду dhcp;

    2. Для статической настройки необходимо выяснить название сетевого интерфейса командой ifstat:

      CODE
      iPXE> ifstat
      net0: 52:54:00:3b:fa:dd ...
        [Link:up, TX:0 TXE:0 RX:0 RXE:0]

      здесь имя интерфйса net0

  5. Дальше набираем команду config и попадаем в меню настройки. Перемещаться по меню можно при помощи стрелок и клавиши Enter;

  6. В этом меню будет “каталог” net0/ или с вашем именем интерфейса. Заходим в него и задаём значения в полях gateway, ip, netmask, dns актуальные для вашей сети;

  7. Затем выходим из меню, нажав Ctrl+X.

  8. Проверить настройку можно введя в консоль команду route. Должны будут отобразиться ваши настройки сети

  9. Запускаем инсталлацию. Вводим команду

    CODE
    chain https://assets.aircloud.org/menu.ipxe
  10. Появится экран с выбором типа дистрибутива - primary или secondary. Выбираем нужный дистрибутив:

  11. Появится экран с запросом логина и пароля. После ввода правильного логина и пароля запустится инсталляция дистрибутива:

  12. Устанавливаем решение по общей инструкции установки.

Инструкция по развёртыванию и подключению собственного IPXE сервера

  1. Получаем один из следующих образов:

    CODE
    netboot_primary.tar
    netboot_secondary.tar
  2. Загружаем необходимый образ на вспомогательный сервер;

  3. Распаковываем образ в какой-либо каталог

    CODE
    mkdir /opt/AirCloud-install
    cd /opt/AirCloud-install
    tar xvf /path/to/netboot_primary.tar
  4. Изменяем конфигурацию (опционально)
    В файле config.json можно настроить ограничение скачивания файлов логином и паролем.
    За это отвечают опции http_server_user и http_server_pass

  5. Запускаем сервер инсталляции

    CODE
    cd /opt/AirCloud-install
    ./server
  6. Внутри образов netboot_primary.tar и netboot_secondary.tar есть файл ipxe.iso
    Его нужно либо скачать с вспомогательного сервера, либо распаковать tar-архив локально и взять оттуда;

  7. В IPMI/KVM-интерфейсе загружаем сервер в режиме загрузки по IPXE. Если недоступно, в IPMI/KVM-интерфейсе монтируем ipxe.iso (https://boot.ipxe.org/ipxe.iso) на сервер, куда ставим продукт, и загружаемся с этого ISO-образа;

  8. В момент загрузки будет возможность получить консоль для ввода команд
    Для этого нужно нажать Ctrl+B. Момент легко упустить, поэтому лучшей тактикой будет постоянно нажимать эту комбинацию;

  9. Настройка сети:

    1. Если в сети есть DHCP-сервер, который выдаст IP для данного сервера, то в консоли набрать команду dhcp;

    2. Для статической настройки необходимо выяснить название сетевого интерфейса командой ifstat:

      CODE
      iPXE> ifstat
      net0: 52:54:00:3b:fa:dd ...
        [Link:up, TX:0 TXE:0 RX:0 RXE:0]

      здесь имя интерфйса net0.

  10. Дальше набираем команду config и попадаем в меню настройки. Перемещаться по меню можно при помощи стрелок и клавиши Enter;

  11. В этом меню будет “каталог” net0/ или с вашем именем интерфейса. Заходим в него и задаём значения в полях gateway, ip, netmask, dns актуальные для вашей сети;

  12. Затем выходим из меню, нажав Ctrl+X;

  13. Проверить настройку можно введя в консоль команду route. Должны будут отобразиться ваши настройки сети;

  14. Запускаем инсталляцию. Вводим команду:

    CODE
    chain http://<ip вспомогательного сервера>/menu.ipxe
  15. Если в конфигурации config.json был задан логин и пароль, появится экран ввода логина и пароля;

  16. Инсталлируем решение по общей инструкции установки.

Инсталляция с помощью PXE образа через IPMI/KVM

Применение

Подходит, когда инсталляция предполагается на сервер с поддержкой загрузки по PXE, имеется возможность настроить DHCP и имеется вспомогательный сервер для хранения образа установки.

Инструкция по установке

  1. Получаем образы:

    CODE
    netboot_primary.tar
    netboot_secondary.tar
  2. Загружаем необходимый образ на вспомогательный сервер;

  3. Распаковываем образ в какой-либо каталог:

    CODE
    mkdir /opt/AirCloud-install
    cd /opt/AirCloud-install
    tar xvf /path/to/netboot_primary.tar
  4. Включаем tftpd в конфиге config.json. Выставляем опцию "enable_tftpd": true;

CODE
# /opt/AirCloud-install/config.json

{
    "http_server_port": "80",
    "http_server_host": "",
    "http_server_user": "",
    "http_server_pass": "",
    "log_file": "",
    "enable_tftpd": true
}
  1. Также в этом же конфиге можно настроить ограничение доступа по логину и паролю (опционально). За это отвечают опции http_server_user и http_server_pass;

  2. Настраиваем в DHCP-сервере next-server=<ip вспомогательного сервера> и filename=undionly.kpxe;
    в качестве примера приведён конфиг для isc-dhcp-server

    CODE
    default-lease-time 600;
    max-lease-time 7200;
    
    allow booting;
    
    subnet 192.168.0.0 netmask 255.255.255.0 {
      range 192.168.0.3 192.168.0.253;
      option broadcast-address 192.168.0.255;
      option routers 192.168.0.1;             # gateway
      option domain-name-servers 192.168.0.1; # dns
      next-server <ip вспомогательного сервера>;
      filename "undionly.kpxe";
    
    group {
      next-server <ip вспомогательного сервера>;
      host tftpclient {
          filename "undionly.kpxe";
      }
    }
  3. Запускаем сервер инсталляции:

    CODE
    cd /opt/AirCloud-install
    ./server
  4. В IPMI/KVM-интерфейсе загружаем сервер в режиме загрузки по IPXE;

  5. В момент загрузки будет возможность получить консоль для ввода команд
    Для этого нужно нажать Ctrl+B. Момент легко упустить, поэтому лучшей тактикой будет постоянно нажимать эту комбинацию.

  6. Настройка сети: в консоли набрать команду dhcp.

  7. Запускаем инсталлацию. Вводим команду:

  8. CODE
    chain http://<ip вспомогательного сервера>/menu.ipxe
  9. Если в конфигурации config.json был задан логин и пароль, появится экран ввода логина и пароля;

  10. Инсталлируем решение по общей инструкции установки.

Инсталляция через интернет с помощью PXE образа через IPMI/KVM

Применение

Подходит, когда целевой сервер поддерживает загрузку по PXE, но не поддерживает монтирование ISO-образа. При этом есть возможность настраивать DHCP-сервер.

Инструкция по установке

  1. Настраиваем в DHCP-сервере next-server=<ip aircloud-сервера в интернете> и filename=undionly.kpxe.
    В качестве примера приведён конфиг для isc-dhcp-server:

CODE
default-lease-time 600;
max-lease-time 7200;

allow booting;

subnet 192.168.0.0 netmask 255.255.255.0 {
  range 192.168.0.3 192.168.0.253;
  option broadcast-address 192.168.0.255;
  option routers 192.168.0.1;             # gateway
  option domain-name-servers 192.168.0.1; # dns
  next-server <ip aircloud-сервера в интернете>;
  filename "undionly.kpxe";

group {
  next-server <ip aircloud-сервера в интернете>;
  host tftpclient {
      filename "undionly.kpxe";
  }
}
  1. В IPMI/KVM-интерфейсе загружаем сервер в режиме загрузки по PXE;

  2. В момент загрузки будет возможность получить консоль для ввода команд
    Для этого нужно нажать Ctrl+B. Момент легко упустить, поэтому лучшей тактикой будет постоянно нажимать эту комбинацию.

  3. Настройка сети: в консоли набрать комманду dhcp
    Запускаем инсталляцию. Вводим команду

  4. CODE
    chain https://assets.aircloud.org/menu.ipxe
  5. Появится меню с выбором дистрибутива

  6. После выбора дистрибутива загрузчик запросит логин и пароль

  7. После ввода правильного логина и пароля запустится установщик

  8. Инсталлируем решение по общей инструкции установки

Отладка

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.