Проверьте diskless шаг за шагом
Тест Windows, установка нового diskless-сервера и лабораторная проверка двух ПК — отдельные инструкции.
01. Часть 1 · тестовый пакет Windows
Достаточно тестового ПК или VM с Windows 10/11 x64 и Windows PowerShell 5.1 / PowerShell 7. Python устанавливать не нужно.
Сборка Windows и нативный тест DPAPI пройдены. PXE, запуск интерфейса и сохранность после трёх сбросов проверяются в лаборатории.
SHA256 архива
de947c7c48b3ef2d6cfa74fa8aad6dddd0b0f4c4207082a0ff189f50e2791384- 1Скачайте и распакуйте ZIP. Сохраните Agent/ и deployment/ вместе. Дважды щёлкните deployment/START-LAB.cmd, чтобы открыть меню локальных инструментов.
- 2Проверьте архив. Откройте PowerShell в корне распакованного пакета и скопируйте команду. Имя файла и SHA256 уже заполнены; измените ArchivePath, если ZIP лежит не в Downloads. Ожидается archive_verified, exit 0.PowerShell
$zip = "$env:USERPROFILE\Downloads\iControl-agent-boot-lab-1.4.88-win-x64-20261101T073451Z-9250b86b.zip" $expected = 'de947c7c48b3ef2d6cfa74fa8aad6dddd0b0f4c4207082a0ff189f50e2791384' if ((Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash -ieq $expected) { powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Verify -ArchivePath $zip -ExpectedSha256 $expected } else { throw 'ZIP SHA256 mismatch' } - 3Проверьте результат. Проверяются hash, manifest, опасные пути и целостность файлов без распаковки или запуска. При blocked / exit 2 проверьте ZIP и выбранный путь.
Это пакет Windows-агента. Linux boot-controller и PXE/iSCSI-инфраструктура для части 2 готовятся отдельно.
02. Установка нового diskless-сервера
Подробная инструкция для коллеги на узбекском: осмотр текущего сервера, отдельный Linux, образ Windows, два ПК и три сброса.
- 1Сначала определите текущую систему. Сервер может работать на Windows. Первая часть только собирает сведения; далее нужна отдельная тестовая среда Linux/ZFS.
- 2Проверьте, на какой машине выполнять шаг. Сервер, сборщик Windows и клиентские ПК разделены. Для каждого шага указаны команды, ожидаемый результат и условия остановки.
03. Тест Windows без лаборатории
Восемь шагов для обычного ПК или VM с Windows 10/11 x64. В PowerShell 5.1 или 7 последовательно проверьте ZIP, Windows preflight, DPAPI и диагностический отчёт.
- 1Скачайте и распакуйте ZIP. Скачайте актуальный пакет кнопкой ZIP выше. Распакуйте в папку iControl-Lab внутри Downloads. Непосредственно в ней должны находиться Agent и deployment. Команды ниже используют это расположение.
- 2Проверьте целостность ZIP. Откройте PowerShell и скопируйте готовую команду ниже. Имя файла и SHA256 уже заполнены; измените $zip, если архив не в Downloads. Ожидается archive_verified. При несовпадении hash не продолжайте. hardware_verified:false и ui_launch_verified:false означают, что приёмка оборудования и интерфейса выполняется отдельно.PowerShell
cd "$env:USERPROFILE\Downloads\iControl-Lab" $zip = "$env:USERPROFILE\Downloads\iControl-agent-boot-lab-1.4.88-win-x64-20261101T073451Z-9250b86b.zip" $expected = 'de947c7c48b3ef2d6cfa74fa8aad6dddd0b0f4c4207082a0ff189f50e2791384' if ((Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash -ieq $expected) { powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Verify -ArchivePath $zip -ExpectedSha256 $expected } else { throw 'ZIP SHA256 mismatch' } - 3Запустите Windows preflight. Дважды щёлкните deployment\START-LAB.cmd и выберите 2 — Windows preflight. Права администратора не требуются. windows, architecture, powershell и dpapi должны иметь passed, общий статус — ready. При blocked прочитайте hint этой проверки. Меню выполняет одно действие; для следующего откройте его заново.
- 4Создайте тестовый DPAPI-файл. Через Win + R откройте powershell.exe -NoProfile -ExecutionPolicy Bypass и выполните команду ниже. Bypass действует только для этого процесса PowerShell. Ожидаются dpapi-test.bin и DPAPI test file created. Это несекретные тестовые данные, настоящий AgentKey не затрагивается. Затем закройте окно PowerShell.PowerShell
& { $ErrorActionPreference = 'Stop' cd "$env:USERPROFILE\Downloads\iControl-Lab" . .\deployment\boot-acceptance-tools.ps1 $path = "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin" $data = [Text.Encoding]::UTF8.GetBytes('icontrol-lab-test') [IO.File]::WriteAllBytes($path, (Protect-IControlAcceptanceData $data)) 'DPAPI test file created' } - 5Проверьте в новом окне PowerShell. Под той же учётной записью Windows через Win + R откройте новое окно powershell.exe -NoProfile -ExecutionPolicy Bypass. Выполните команду ниже; ожидается DPAPI OK. Пока не удаляйте тестовый файл.PowerShell
& { $ErrorActionPreference = 'Stop' cd "$env:USERPROFILE\Downloads\iControl-Lab" . .\deployment\boot-acceptance-tools.ps1 $path = "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin" $data = Unprotect-IControlAcceptanceData ([IO.File]::ReadAllBytes($path)) if ([Text.Encoding]::UTF8.GetString($data) -ceq 'icontrol-lab-test') { 'DPAPI OK' } else { throw 'DPAPI test failed' } } - 6Повторите после обычного restart Windows. Сохраните работу и перезагрузите компьютер. Войдите в тот же Windows-аккаунт, откройте новое окно PowerShell как выше и повторите команду. Ожидается DPAPI OK. Это обычный локальный restart; diskless-сбросы проверяются отдельно в лаборатории.PowerShell
& { $ErrorActionPreference = 'Stop' cd "$env:USERPROFILE\Downloads\iControl-Lab" . .\deployment\boot-acceptance-tools.ps1 $path = "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin" $data = Unprotect-IControlAcceptanceData ([IO.File]::ReadAllBytes($path)) if ([Text.Encoding]::UTF8.GetString($data) -ceq 'icontrol-lab-test') { 'DPAPI OK' } else { throw 'DPAPI test failed' } } - 7Создайте диагностический ZIP. Снова откройте START-LAB.cmd, выберите 4 — Diagnostics ZIP, затем W — Windows. На Desktop появится новый iControl-support-....zip с preflight.json, events.json и README.txt. files_scanned:0 нормально, если агент ещё не запускался на ПК. Отчёт остаётся локальным и автоматически не отправляется.
- 8Удалите тестовый файл. После всех проверок выполните эту команду в PowerShell. Удалится только dpapi-test.bin, созданный по инструкции. Пакет, исходный ZIP и диагностический отчёт можно сохранить.PowerShell
Remove-Item -LiteralPath "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin"
Критерии успеха: archive_verified → ready → DPAPI OK в новом окне и после обычного restart → создан диагностический ZIP. PXE и три diskless-сброса проверяются на лабораторном этапе.
04. Автоматический preflight
Только чтение: настройки Windows, диски, tasks, markers и identity не меняются. AgentKey и содержимое config не читаются.
- 1Проверка Windows. Можно начать без лаборатории. Проверяются x64 OS/process, PowerShell и DPAPI roundtrip в памяти под текущим Windows-аккаунтом.PowerShell
powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Check -Mode Windows - 2Проверка diskless. Когда лаборатория готова, запустите PowerShell elevated под самим kiosk-аккаунтом. Проверяются image policy, OS iSCSI target, private-диск/serial, manifest, UUID firmware binding, аккаунт task и autologin/shell.PowerShell
powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Check -Mode Diskless -InstallDir C:\iControl\Agent -StateRoot P:\iControl - 3Прочитайте статус. ready / exit 0 — проверки режима пройдены. pending / exit 3 — нужен отдельный setup/reboot gate агента. maintenance / exit 3 — обнаружена maintenance-загрузка. blocked / exit 2 — следуйте подсказке в отчёте.
Preflight не заменяет startup gate агента и приёмку после трёх сбросов. Если UUID firmware identity недоступен, нужна проверка оператора.
05. Часть 2 · diskless-лаборатория
Подготовьте Linux boot-controller, два тестовых ПК, Windows maintenance image, постоянный kiosk-профиль и отдельный state-диск для каждого ПК.
- 1Подготовьте pilot image. Скопируйте Agent/ в C:\Lab\Agent внутри образа. Отключите автозапуск billing/lock iCafe только в pilot image. Заранее настройте оболочку explorer.exe, autologin Windows и kiosk-аккаунт с правами администратора.
- 2Разместите агент. Скрипты deployment должны лежать вместе; запустите команду от администратора. Замените LAB\Kiosk и YOUR-PILOT-API.example на свой тестовый аккаунт и pilot API. IQN prefix должен совпадать с контроллером.PowerShell
.\deployment\prepare-icontrol-boot-image.ps1 ` -AgentBuildDir C:\Lab\Agent ` -KioskUser 'LAB\Kiosk' ` -IqnPrefix 'iqn.2026-10.uz.i-control.lab' ` -StateRoot P:\iControl ` -ServerUrl 'https://YOUR-PILOT-API.example' ` -ICafeDisabledOnPilotImage - 3Сохраните общий образ чистым. Не копируйте в него AgentKey, club enroll token, config другого ПК или файлы DPAPI. Полные требования — в deployment/ICONTROL-BOOT.md внутри ZIP.
06. Identity каждого ПК
При обычной загрузке controller экспортирует OS через LUN 0, private state-диск этого ПК — через LUN 1. Maintenance-загрузка не подключает state-диск.
- 1Получите manifest контроллера. Командой station-identity pc01 создайте pc01.boot-station.json. Для pc02 нужен отдельный manifest. Передайте каждый файл на соответствующий ПК доверенным административным способом.
- 2Проверьте state-диск. Вручную подготовьте только пустой private-диск с ожидаемым serial и назначьте P:. Не выбирайте boot/system-диск. Скрипт ниже не форматирует диски.
- 3Установите manifest. Остановите агент и выполните команду из отдельного аккаунта администратора Windows. На pc02 используйте его собственный manifest.PowerShell
.\deployment\initialize-icontrol-boot-state.ps1 -ManifestPath C:\Setup\pc01.boot-station.json -StateRoot P:\iControl - 4Запустите агент. Первая загрузка под kiosk-аккаунтом создаёт binding и требует reboot. После прохождения gate на следующей отдельной загрузке выполните per-PC provisioning. Проверьте отдельные identity в dashboard.
07. DPAPI · три сброса
Используйте тот же kiosk-аккаунт, что и агент. Private-диск, профиль Windows и учётная запись должны оставаться прежними.
- 1Начните тест один раз. Выполните Begin из папки распакованного пакета.PowerShell
.\deployment\test-icontrol-boot-state.ps1 -Mode Begin -StateRoot P:\iControl - 2Выполните три настоящих сброса. После каждой reset-загрузки через controller запускайте Verify. Повторный вызов во время одной загрузки Windows не считается новым сбросом.PowerShell
.\deployment\test-icontrol-boot-state.ps1 -Mode Verify -StateRoot P:\iControl - 3Проверьте результат. Exit 3 / pending_reboots — нужна ещё одна отдельная reset-загрузка. Exit 0 / verified — тест трёх сбросов пройден. Exit 2 / blocked — проверьте диск, manifest, аккаунт или DPAPI.
При ошибке сохраните историю и markers. Не удаляйте их для обхода gate.
08. Диагностический ZIP
Выберите пункт 4 в START-LAB или создайте новый отчёт командой.
- 1Создайте отчёт. Пример для diskless. Для обычной Windows-проверки используйте -Mode Windows. Существующие отчёты не перезаписываются; выберите другое имя. Меню автоматически создаёт новое имя на Desktop.PowerShell
powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Report -Mode Diskless -InstallDir C:\iControl\Agent -StateRoot P:\iControl -OutputPath "$env:USERPROFILE\Desktop\iControl-support.zip" - 2Что внутри. preflight.json — разрешённые статусы. events.json — счётчики категорий из последних четырёх agent-логов, не более 256 KiB из каждого. README.txt — границы отчёта. Нет raw logs, токенов, AgentKey, config-контента, имён пользователей, SID, serial или DPAPI-файлов.
- 3Просмотрите и отправьте сами. Отчёт остаётся локальным и автоматически никуда не загружается. При необходимости передайте support. files_scanned=0 означает, что читаемые agent-логи не найдены; preflight всё равно может описать заблокированный ПК.
09. Итоговая проверка
Зафиксируйте результаты для обоих тестовых ПК.
- 1Identity и подключение. pc01 и pc02 отображаются отдельно; после трёх сбросов оба подключаются без повторного запроса AgentKey.
- 2Maintenance и блокировка. Maintenance boot завершает агент до запуска сеанса/kiosk. Отсутствующий state-диск или manifest другого ПК блокирует запуск.
- 3Тестовый сеанс. Проверьте отдельный тестовый сеанс, lock/unlock и бронирование в pilot-клубе.
- 4Сообщение об ошибке. Запишите этап, JSON status/exit code, версию Windows и имя тестового ПК. Не отправляйте AgentKey, токены и DPAPI-файлы.
Готовы к проверке?
Распакуйте ZIP и сначала выполните проверки Windows. К diskless-тесту переходите после подготовки лаборатории.