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

Установка ISO-образа, первичная настройка, лицензирование и запуск узлов. Документ рассчитан на инженера с физическим доступом к серверу или доступом через IPMI/KVM.

1. Общая информация

Документ описывает установку дистрибутива на серверное оборудование из ISO-образа, запуск скрипта настройки, получение лицензии и ввод сервера в систему. Используются термины primary node / secondary node и management interface — как в установщике.

1.1. Термины

1.2. Последовательность работ

1. Проверить соответствие оборудования минимальным требованиям.

2. Получить ISO-образ и подготовить носитель или Virtual Media IPMI/KVM.

3. Загрузить сервер с носителя.

4. Установить базовый Debian: язык, сеть, пользователи, диск, пакеты.

5. Войти в окружение суперпользователя и собрать файл информации о сервере.

6. Передать файл поставщику и получить лицензию.

7. Разместить лицензию по пути /etc/skyspace/host.lic.

8. Запустить sky-start и настроить первичный или вторичный узел.

9. Проверить сеть, лицензию, службы и доступность ЦС.

2. Системные требования

Минимум для отказоустойчивого кластера — три сервера. Рекомендуются однотипные серверы в рамках кластера.

3. Подготовка к установке с ISO

3.1. Получение образа

ISO предоставляется по ссылке или офлайн при поставке. Проверьте контрольную сумму, если она предоставлена. Для физической передачи подготовьте USB не менее 16 ГБ и убедитесь, что порядок загрузки можно изменить в BIOS/UEFI.

3.2. Загрузочный носитель

lsblk
sudo dd if=/path/to/image.iso of=/dev/sdX bs=4M status=progress oflag=sync
sync

3.3. Выбор загрузки в BIOS/UEFI

1. Откройте BIOS/UEFI или Boot Menu сервера.

2. Выберите загрузку с Virtual Media / виртуального CD/DVD или USB.

3. Сохраните выбор и продолжите загрузку установщика.

4. Установка базового дистрибутива Debian

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

4.1. Старт и выбор языка

1. Выберите рекомендованный для образа режим установки.

2. Выберите язык интерфейса установщика.

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

4.2. Настройка сети

Выберите физический интерфейс, через который сервер будет доступен для управления — он станет management interface по умолчанию.

1. Выберите интерфейс, подключённый к management-сети.

2. Если сеть тегированная — укажите VLAN tag.

3. Задайте IP-адрес, маску, шлюз и DNS.

4. Укажите host-name (понадобится для лицензии).

4.3. Учётные записи и пароли

1. Задайте пароль суперпользователя root.

2. Создайте локальную учётную запись, если установщик её запрашивает.

3. Сохраните пароль root в защищённом хранилище — он нужен для su -, collect-host-info и sky-start.

4.4. Разметка диска и Swap

1. Выберите системный диск (SAS SSD или NVMe, от 256 ГБ).

2. Выберите авто- или ручную разметку.

3. Проверьте размер Swap; при необходимости скорректируйте вручную.

4. Подтвердите запись только после проверки root-, EFI/boot- и Swap-разделов.

4.5. Установка пакетов решения

Устанавливаются системные пакеты и компоненты виртуализации, копируется образ ВМ Центрального Сервера. Не отключайте питание и Virtual Media до завершения.

4.6. Завершение и перезагрузка

1. Дождитесь сообщения о завершении установки.

2. Извлеките USB или размонтируйте Virtual Media.

3. Перезагрузите сервер.

4. Убедитесь, что загрузка идёт с системного диска, а не с ISO.

5. Консоли и контроль хода установки

Команды ниже не обязательны — они нужны только для контроля хода установки во второй консоли: tail -f по syslog и dpkg.log показывает установку пакетов в реальном времени, df -h — свободное место на диске, ip addr и ip route — что сеть поднялась корректно.

tail -f /var/log/syslog
tail -f /target/var/log/dpkg.log
df -h
ip addr
ip route

6. Сбор информации и лицензирование

6.1. Вход под суперпользователем

su -
whoami   # ожидается: root

6.2. Сбор информации о сервере

collect-host-info <host-name>

Например: collect-host-info node-01. Параметр host-name должен совпадать с именем, заданным при установке ОС (проверить командой hostname). Команда сформирует файл, который передаётся для формирования лицензии.

6.3. Размещение файла лицензии

После получения лицензионного файла от поставщика решения разместите его на сервере по пути:

/etc/skyspace/host.lic

Проверьте, что файл на месте:

ls -l /etc/skyspace/host.lic

7. Запуск sky-start

su -
whoami   # root
sky-start

Откроется пошаговый сценарий. На первом этапе выбирается тип ноды.

8. Установка первичного узла

Задаются данные супер администратора, SMTP, management-сеть, сеть ВМ ЦС, путь хранения образа, NTP и пароль лицензии.

8.1. Данные супер администратора

8.2. SMTP Configuration

Задайте адрес SMTP, порт, авторизацию и шифрование. Через почту доставляется профиль для входа в приложение. Отправьте тестовое письмо.

8.3. Internal Server Network

8.4. Сеть ВМ Центрального Сервера

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

8.5. Путь хранения образа ВМ ЦС

# пример пути (директория создаётся рекурсивно):
/var/lib/skyspace/central-server

Проверьте свободное место. Используйте надёжное локальное хранилище, не временные каталоги.

8.6. Параметры NTP

Укажите основной и резервный NTP-серверы. Синхронизация времени критична для лицензирования, журналов и работы кластера.

8.7. Пароль лицензии

8.8. Summary и запуск

1. Проверьте параметры в окне Summary.

2. При ошибке вернитесь и исправьте значение.

3. Если всё верно — запустите настройку.

4. Дождитесь завершения, не прерывайте процесс.

9. Установка вторичного узла

Вторичный сервер подключается к уже развёрнутому Центральному Серверу.

9.1. Central server IP

Укажите виртуальный IP ЦС, заданный при настройке первичного узла.

ping <central-server-ip>
ip route

9.2. Пароль лицензии

Введите пароль лицензии, заданный при настройке первичного узла.

9.3. Проверка компании и лицензии

1. Проверьте название компании и параметры лицензии.

2. Убедитесь в правильности сервера и ЦС.

3. Запустите установку.

4. Дождитесь завершения и проверьте появление узла в системе управления.

10. Проверки после настройки

11. Типовые ошибки

12. Отладка и полезные команды

12.1. Базовая диагностика ОС

hostname
whoami
ip addr
ip route
cat /etc/resolv.conf
df -h
free -h
swapon --show
timedatectl

12.2. Логи установки и системы

tail -f /var/log/syslog
tail -f /target/var/log/dpkg.log
journalctl -xe
journalctl -b
systemctl --failed

12.3. Проверка сетевой доступности

ping <gateway-ip>
ping <central-server-ip>
traceroute <central-server-ip>
# если traceroute отсутствует:
tracepath <central-server-ip>