Как настроить IZI Boot и образ диска

Как настроить IZI Boot и эталонный образ диска

IZI Boot — это модуль IZI, который хранит единый эталонный образ диска (операционная система, игры, настройки клиента) на сетевом хранилище TrueNAS и загружает все ПК клуба с него по протоколу iSCSI (загрузка по сети вместо локального диска). Каждый раз, когда ПК перезагружается после сессии, он откатывается к «золотому» состоянию: никаких вирусов, сломанных настроек или случайно удалённых файлов. Вся настройка выполняется через раздел Control Center в IZI CRM — без ручных манипуляций с TrueNAS напрямую. Ниже — полный сценарий от подключения хранилища до момента, когда первый ПК загрузился с вашего образа.

---

Что нужно перед началом

Требование	Подробности
TrueNAS в сети клуба	Версия 25.04 (Fangtooth) и выше. Более ранние версии поддерживаются, но некоторые функции (WebSocket-обновления статуса) доступны только с 24.10+.
API-токен TrueNAS	Создаётся в TrueNAS: Credentials → API Keys → Add.
IP хранилища	Внешний IP (для CRM) и локальный LAN-IP (для iSCSI-подключения с ПК). Это могут быть разные адреса.
Буква диска	Латинская заглавная буква (A–Z), кроме C:. Выбранная буква должна быть свободна на всех ПК клуба.
ПК с поддержкой Boot	Обычные игровые ПК с сетевой картой — никакого специального оборудования не нужно.

Убедитесь также, что у вашей роли в IZI есть разрешения IZI_BOOT_MANAGE и IZI_BOOT_CONFIG_MANAGE — без них кнопки мастера настройки не появятся.

---

Шаг 1. Подключение хранилища

Откройте в CRM нужный клуб → Control Center → кнопка «Настроить IZI Boot». Откроется мастер настройки (wizard). На первом шаге — экран «IZI Boot — подключение хранилища».

Заполните поля:

Поле	Что вводить
Протокол	HTTP или HTTPS. HTTPS требует, чтобы сертификат TrueNAS был доверенным; для самоподписанных — используйте HTTP или импортируйте сертификат.
IP	Внешний IP или hostname TrueNAS, по которому CRM дотягивается до API.
Порт	Стандартный порт TrueNAS API (80 для HTTP, 443 для HTTPS).
API токен	Токен из TrueNAS. После сохранения он скрывается — при необходимости нажмите «Сменить токен».
Локальный IP TrueNAS	LAN-адрес, по которому сами ПК клуба будут подключаться к iSCSI-хранилищу.
Буква диска	Буква, на которую будет смонтирован игровой диск на каждом ПК (например, D или G).
TrueNAS pool	Название пула. Если на TrueNAS один пул — поле можно оставить пустым (авто-определение).
Размер диска donor (GiB)	Объём тома для ПК-донора. Диапазон: 1–10240 GiB. Рекомендуется выбирать с запасом под рост библиотеки игр.
Авто-обновление по расписанию	Расписание, по которому reconciler будет применять новый образ на ПК. Если не указать — система использует расписание «Всегда» (обновление сразу после освобождения ПК).

После заполнения нажмите «Далее» — IZI автоматически проверит подключение к TrueNAS.

Если проверка не прошла, CRM покажет точную причину: неверный токен (IZI_BOOT_CONN_AUTH), недоступный хост (IZI_BOOT_CONN_DNS), проблема с TLS (IZI_BOOT_CONN_TLS) или таймаут (IZI_BOOT_CONN_TIMEOUT). Исправьте соответствующий параметр и нажмите «Повторить».

---

Шаг 2. Выбор режима установки

После успешной проверки подключения IZI определяет, есть ли уже на TrueNAS готовые диски:

• Чистая установка — на хранилище нет ничего. Нужно подготовить ПК-донор, установить на него Windows по iSCSI и снять образ.
• Перенести существующий TrueNAS — на хранилище обнаружены сторонние диски (например, от другой системы). IZI предложит захватить один из них как эталонный образ без разрушения оригинала.

Режим выбирается автоматически на основе состояния пула. Вы можете переключить его вручную, если нужно.

---

Шаг 3. Выбор источника

Чистая установка: выбор ПК-донора

Выберите ПК, который станет «ПК-донором» — источником эталонного образа. Он должен быть включён. После выбора IZI подготовит на TrueNAS пустой том нужного размера и iSCSI-таргет с привязкой к MAC-адресу этого ПК.

Дальнейшие действия на ПК-доноре (вне CRM):

1. Загрузите ПК по сети (PXE/iSCSI) — IZI автоматически «подключит» диск по iSCSI.
2. Установите Windows на этот диск в штатном режиме.
3. Настройте всё, что должно быть в эталоне: клиент IZI, игры, браузеры, звук, заставки.
4. Убедитесь, что настройки iSCSI-соединения сохранены как постоянные (персистентные), чтобы диск монтировался после перезагрузки.

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

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

---

Шаг 4. Снятие эталонного образа

Когда донор готов, вернитесь в CRM и нажмите «Снять референс» (кнопка на шаге «Подготовка образа»).

Что происходит в этот момент:

1. IZI делает снапшот диска донора в TrueNAS — это и есть эталонный образ (baseline).
2. Идентификатор образа фиксируется (формат: YYYY-MM-DD_HH:MM:SS).
3. Reconciler получает задание: переключить все ПК клуба на новый эталонный образ при следующей перезагрузке в период простоя.

После снятия образа донор перестаёт быть «особым» — он становится обычным ПК клуба, который тоже будет откатываться к эталону наравне с остальными.

---

Шаг 5. Выбор ПК для IZI Boot

На следующем шаге CRM покажет список всех ПК клуба с поддержкой Boot. Отметьте те, которые должны загружаться через IZI Boot. Снимите отметку с тех, которым это не нужно (например, гоночные симуляторы с нестандартными конфигурациями).

Нажмите «Сохранить» — IZI запишет выбор и запустит процесс установки.

---

Шаг 6. Установка на ПК

После сохранения каждый отмеченный ПК установит клиент IZI Boot автоматически — при следующем включении и простое. Прогресс виден в CRM: индикатор показывает, сколько ПК уже онлайн из общего числа.

Ждать завершения необязательно — можно нажать «Завершить сейчас» и закрыть мастер. Занятые или выключенные ПК установятся автоматически, как только освободятся.

---

Статусы ПК после настройки

В разделе ПК с Boot каждый ПК отображается с одним из статусов:

Статус	Значение
ONLINE	ПК загружен с эталонного образа, всё в порядке.
OFFLINE	IZI Boot не получает статус от ПК (ПК выключен или клиент не установлен).
PENDING	Reconciler поставил ПК в очередь на применение нового образа.
APPLYING	Идёт переключение на новый образ.
READY	Готов к перезагрузке в новый образ.
BROKEN	Проблема с iSCSI-подключением или образом. Требует диагностики.

Если показывает OUTDATED (значок расхождения) — ПК ещё не перезагрузился после применения нового образа. Reconciler перезагрузит его автоматически при первом простое.

---

Обновление эталонного образа

Для обновления игр или системных настроек:

1. Выберите ПК, который хотите использовать как донор (должен быть capturableAsReference).
2. Внесите изменения в систему на этом ПК.
3. В CRM: клуб → Control Center → раздел IZI Boot → «Снять референс».
4. Reconciler автоматически применит новый образ на все ПК по расписанию.

Кнопка «Снять референс» доступна только когда ПК свободен (нет активной сессии и удержания). Если ПК занят — CRM вернёт ошибку IZI_BOOT_DEVICE_BUSY.

---

Применение образа вручную

Для срочного отката конкретного ПК к эталону (без ожидания расписания):

• Откройте ПК в разделе ПК с Boot → кнопка «Применить образ».
• Это принудительно применяет текущий эталон к выбранному ПК при ближайшей его перезагрузке.
• Активная сессия блокирует применение — система не прерывает игроков.

Для применения ко всем ПК сразу используйте «Применить ко всем» — reconciler поставит все ПК в очередь на немедленный проход.

---

Типичные ошибки и их причины

Ошибка	Причина и решение
IZI_BOOT_DRIVE_LETTER_UNAVAILABLE	Выбранная буква занята на одном из ПК (системный диск, файл подкачки или локальный том). CRM показывает список конфликтующих ПК. Выберите другую букву.
IZI_BOOT_INSUFFICIENT_POOL_CAPACITY	На TrueNAS недостаточно свободного места (порог ~80% ёмкости пула). Освободите место или увеличьте пул.
IZI_BOOT_CLUB_BUSY	Другая операция IZI Boot уже выполняется для этого клуба (применение образа, reconcile). Подождите завершения и повторите.
IZI_BOOT_NOT_PROVISIONED	У ПК нет iSCSI-тома в TrueNAS. Включите ПК в список Boot-устройств и дождитесь, пока reconciler его подготовит.
IZI_BOOT_UNSUPPORTED_DEVICE_TYPE	Тип устройства не поддерживает IZI Boot (например, платёжный терминал или принтер). Только игровые ПК поддерживаются.
IZI_BOOT_CONN_TLS	TLS-рукопожатие с TrueNAS не удалось. Проверьте сертификат или переключитесь на HTTP.

---

Связанные материалы

• Обзор IZI Boot — как устроена загрузка по сети
• Эталонный образ: что входит и как обновлять
• Восстановление ПК после сбоя
• Как заменить ПК в клубе