iControl Boot · инструкция по тестированию

Проверьте diskless шаг за шагом

Тест Windows, установка нового diskless-сервера и лабораторная проверка двух ПК — отдельные инструкции.

01. Часть 1 · тестовый пакет Windows

Достаточно тестового ПК или VM с Windows 10/11 x64 и Windows PowerShell 5.1 / PowerShell 7. Python устанавливать не нужно.

LABWindows x64 · v1.4.88 · 67.6 MB

Сборка Windows и нативный тест DPAPI пройдены. PXE, запуск интерфейса и сохранность после трёх сбросов проверяются в лаборатории.

SHA256 архиваde947c7c48b3ef2d6cfa74fa8aad6dddd0b0f4c4207082a0ff189f50e2791384
  1. 1
    Скачайте и распакуйте ZIP. Сохраните Agent/ и deployment/ вместе. Дважды щёлкните deployment/START-LAB.cmd, чтобы открыть меню локальных инструментов.
  2. 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. 3
    Проверьте результат. Проверяются hash, manifest, опасные пути и целостность файлов без распаковки или запуска. При blocked / exit 2 проверьте ZIP и выбранный путь.

Это пакет Windows-агента. Linux boot-controller и PXE/iSCSI-инфраструктура для части 2 готовятся отдельно.

02. Установка нового diskless-сервера

Подробная инструкция для коллеги на узбекском: осмотр текущего сервера, отдельный Linux, образ Windows, два ПК и три сброса.

  1. 1
    Сначала определите текущую систему. Сервер может работать на Windows. Первая часть только собирает сведения; далее нужна отдельная тестовая среда Linux/ZFS.
  2. 2
    Проверьте, на какой машине выполнять шаг. Сервер, сборщик Windows и клиентские ПК разделены. Для каждого шага указаны команды, ожидаемый результат и условия остановки.

03. Тест Windows без лаборатории

Восемь шагов для обычного ПК или VM с Windows 10/11 x64. В PowerShell 5.1 или 7 последовательно проверьте ZIP, Windows preflight, DPAPI и диагностический отчёт.

  1. 1
    Скачайте и распакуйте ZIP. Скачайте актуальный пакет кнопкой ZIP выше. Распакуйте в папку iControl-Lab внутри Downloads. Непосредственно в ней должны находиться Agent и deployment. Команды ниже используют это расположение.
  2. 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. 3
    Запустите Windows preflight. Дважды щёлкните deployment\START-LAB.cmd и выберите 2 — Windows preflight. Права администратора не требуются. windows, architecture, powershell и dpapi должны иметь passed, общий статус — ready. При blocked прочитайте hint этой проверки. Меню выполняет одно действие; для следующего откройте его заново.
  4. 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. 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. 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. 7
    Создайте диагностический ZIP. Снова откройте START-LAB.cmd, выберите 4 — Diagnostics ZIP, затем W — Windows. На Desktop появится новый iControl-support-....zip с preflight.json, events.json и README.txt. files_scanned:0 нормально, если агент ещё не запускался на ПК. Отчёт остаётся локальным и автоматически не отправляется.
  8. 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. 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. 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. 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. 1
    Подготовьте pilot image. Скопируйте Agent/ в C:\Lab\Agent внутри образа. Отключите автозапуск billing/lock iCafe только в pilot image. Заранее настройте оболочку explorer.exe, autologin Windows и kiosk-аккаунт с правами администратора.
  2. 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. 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. 1
    Получите manifest контроллера. Командой station-identity pc01 создайте pc01.boot-station.json. Для pc02 нужен отдельный manifest. Передайте каждый файл на соответствующий ПК доверенным административным способом.
  2. 2
    Проверьте state-диск. Вручную подготовьте только пустой private-диск с ожидаемым serial и назначьте P:. Не выбирайте boot/system-диск. Скрипт ниже не форматирует диски.
  3. 3
    Установите manifest. Остановите агент и выполните команду из отдельного аккаунта администратора Windows. На pc02 используйте его собственный manifest.
    PowerShell
    .\deployment\initialize-icontrol-boot-state.ps1 -ManifestPath C:\Setup\pc01.boot-station.json -StateRoot P:\iControl
  4. 4
    Запустите агент. Первая загрузка под kiosk-аккаунтом создаёт binding и требует reboot. После прохождения gate на следующей отдельной загрузке выполните per-PC provisioning. Проверьте отдельные identity в dashboard.

07. DPAPI · три сброса

Используйте тот же kiosk-аккаунт, что и агент. Private-диск, профиль Windows и учётная запись должны оставаться прежними.

  1. 1
    Начните тест один раз. Выполните Begin из папки распакованного пакета.
    PowerShell
    .\deployment\test-icontrol-boot-state.ps1 -Mode Begin -StateRoot P:\iControl
  2. 2
    Выполните три настоящих сброса. После каждой reset-загрузки через controller запускайте Verify. Повторный вызов во время одной загрузки Windows не считается новым сбросом.
    PowerShell
    .\deployment\test-icontrol-boot-state.ps1 -Mode Verify -StateRoot P:\iControl
  3. 3
    Проверьте результат. Exit 3 / pending_reboots — нужна ещё одна отдельная reset-загрузка. Exit 0 / verified — тест трёх сбросов пройден. Exit 2 / blocked — проверьте диск, manifest, аккаунт или DPAPI.

При ошибке сохраните историю и markers. Не удаляйте их для обхода gate.

08. Диагностический ZIP

Выберите пункт 4 в START-LAB или создайте новый отчёт командой.

  1. 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. 2
    Что внутри. preflight.json — разрешённые статусы. events.json — счётчики категорий из последних четырёх agent-логов, не более 256 KiB из каждого. README.txt — границы отчёта. Нет raw logs, токенов, AgentKey, config-контента, имён пользователей, SID, serial или DPAPI-файлов.
  3. 3
    Просмотрите и отправьте сами. Отчёт остаётся локальным и автоматически никуда не загружается. При необходимости передайте support. files_scanned=0 означает, что читаемые agent-логи не найдены; preflight всё равно может описать заблокированный ПК.

09. Итоговая проверка

Зафиксируйте результаты для обоих тестовых ПК.

  1. 1
    Identity и подключение. pc01 и pc02 отображаются отдельно; после трёх сбросов оба подключаются без повторного запроса AgentKey.
  2. 2
    Maintenance и блокировка. Maintenance boot завершает агент до запуска сеанса/kiosk. Отсутствующий state-диск или manifest другого ПК блокирует запуск.
  3. 3
    Тестовый сеанс. Проверьте отдельный тестовый сеанс, lock/unlock и бронирование в pilot-клубе.
  4. 4
    Сообщение об ошибке. Запишите этап, JSON status/exit code, версию Windows и имя тестового ПК. Не отправляйте AgentKey, токены и DPAPI-файлы.

Готовы к проверке?

Распакуйте ZIP и сначала выполните проверки Windows. К diskless-тесту переходите после подготовки лаборатории.