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

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

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

---

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

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

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

Ниже описана настройка через TrueNAS — самый распространённый сценарий. Для NetX и GGBOOT порядок шагов отличается: раздел Настройка NetX через облачный API ниже охватывает NetX; для GGBOOT — отдельная страница Подключение GGBOOT к IZI.

---

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

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

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

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

Протокол (HTTP или HTTPS) и LAN-адреса сервера вводить не нужно: IZI определяет их сам при сохранении.

После заполнения нажмите «Далее» — IZI автоматически проверит подключение к TrueNAS. Если версия TrueNAS ниже 24.04, подключение сохранится, но мастер дальше не пойдёт: на шаге появится красная плашка с инструкцией по обновлению.

Если проверка не прошла, 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-таргет, к которому может подключиться только этот ПК — по его идентификатору в IZI.

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

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

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

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

---

Шаг 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 вернёт ошибку BOOT_DEVICE_BUSY.

---

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

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

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

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

---

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

Ошибка	Причина и решение
IZI_BOOT_DRIVE_LETTER_UNAVAILABLE	Выбранная буква занята на одном из ПК (системный диск, файл подкачки или локальный том). CRM показывает список конфликтующих ПК. Выберите другую букву.
IZI_BOOT_INSUFFICIENT_POOL_CAPACITY	На TrueNAS недостаточно свободного места (порог ~80% ёмкости пула). Освободите место или увеличьте пул.
IZI_BOOT_NAS_BEHIND_ACCESS	NAS клуба подключён через Cloudflare Access и общий с дисковой системой клуба. IZI Boot не принимает на нём чужие тома и не меняет общие настройки iSCSI; на NAS ничего не изменено.
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_SETUP_IN_PROGRESS	Идёт первоначальная настройка клуба (выбор режима установки или перенос с другой системы) — пока она не завершится, перезалить образ нельзя. Дождитесь окончания настройки.
IZI_BOOT_TRUENAS_VERSION_UNSUPPORTED	TrueNAS ниже 24.04. Подключение сохранено, но IZI Boot ничего не делает с сервером до обновления. Обновите сервер — Версии TrueNAS для IZI Boot.
IZI_BOOT_WEB_CREDENTIALS_REQUIRED	При первом подключении не указаны логин и пароль веб-интерфейса TrueNAS. Укажите их.
IZI_BOOT_WEB_CREDENTIALS_INVALID	TrueNAS не принял логин и пароль веб-интерфейса. Проверьте их на самом сервере.
IZI_BOOT_CONN_UNREACHABLE	TrueNAS не отвечает: сервер клуба выключен, потерял интернет или отвалился туннель подключения. Проверьте, что сервер включён и в сети.

---

---

Настройка NetX через облачный API

NetX подключается к IZI через облачный API вендора: вводить публичный IP, проброс порта или пароль не нужно — достаточно идентификатора клуба в системе NetX.

Что нужно

• Активный аккаунт клуба в NetX.
• ID клуба в NetX — берётся из панели NetX (раздел настроек клуба).
• Права в IZI: BOOT_CONFIG_MANAGE.

Порядок настройки

Откройте нужный клуб в IZI CRM → раздел Boot → карточка NetX → «Настроить →».

На экране подключения одно поле:

Поле	Что вводить
ID клуба в NetX	Идентификатор из панели NetX.

Дополнительно можно задать «Авто-обновление по расписанию» — расписание, по которому IZI будет применять обновления образа на ПК клуба. Если расписание не выбрано, обновление применяется сразу после освобождения ПК.

Нажмите «Сохранить». После этого нажмите «Проверить подключение» — IZI обращается к API NetX и подтверждает, что клуб доступен.

Изменение и удаление подключения

• Для смены ID нажмите «Изменить» рядом с полем.
• Для полного отключения нажмите «Удалить» — ПК клуба перестанут управляться через NetX.

---

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

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