Пошаговая установка Windows Worker ClashFlow: службы инвентаризации
моделей, подготовки NWC и отчёта коллизий в Navisworks. Ставится на
отдельную Windows-машину (или ВМ) рядом с шарой моделей, не в Linux
Kubernetes.
Установщик:
Обновления служб после первой установки подтягивает WorkerUpdater с
SoftInstaller IT4BIM (нужен исходящий доступ и лицензия сайта).
| # | Условие |
|---|---|
| 1 | Core отвечает: открывается веб, /health, вход (хотя бы пилотный) — см. Core в Kubernetes |
| 2 | Известен HTTPS URL API площадки (его даёт внедрение) |
| 3 | От IT4BIM получена лицензионная учётка сайта (license.site.*) |
| 4 | Есть учётка Keycloak площадки с правами для отправки коллизий (часто Administrator / служебная), если мастер её спрашивает |
| 5 | На ПК Worker установлен .NET 10 — ASP.NET Core Runtime 10.0 (ASP.NET Core Runtime или Hosting Bundle). Проверка: dotnet --list-runtimes показывает Microsoft.AspNetCore.App 10.x |
| 6 | Машина видит шары моделей / Revit Server той учёткой, под которой будут службы |
| 7 | Исходящий HTTPS до API Core, SoftInstaller, сервера лицензий и Seq IT4BIM; Core достучится до портов Worker во внутренней сети (связь двусторонняя) |
Железо — Железо и контур.
C:\IT4BIM\Collisions\Worker.Службы Worker собраны под .NET 10. До запуска Admin-установщика
установите runtime с
dotnet.microsoft.com/download/dotnet/10.0:
| Что поставить | Когда |
|---|---|
| ASP.NET Core Runtime 10.0 (x64) | Минимум для Inventory / NWC / Report / WorkerUpdater |
| Hosting Bundle 10.0 | То же + удобнее, если на машине ещё IIS |
Проверка в PowerShell:
dotnet --list-runtimes
# ожидается строка вида: Microsoft.AspNetCore.App 10.0.x [...]
Без AspNetCore 10.x службы не стартуют (в Event Log / логах установщика —
ошибки загрузки hostfxr / framework).
Без Manage службы Worker встанут, но NWC и отчёты не заработают.
Revit (по желанию). Если в настройках выгрузки включены флажки
«Удалять связи Revit» / «Удалять CAD», на Worker нужен Revit версии
моделей или новее, с лицензией у пользователя, в чьей сессии работает
выгрузка (п. 1.4a). Один раз запустите Revit под этим пользователем и
закройте стартовые диалоги (лицензия, приветствие); окно о неподписанной
надстройке служба закрывает сама. Без Revit NWC выгружаются как обычно, но связи
не удаляются, а в мониторинге будет предупреждение.
Службы при интерактивной установке идут от учётки установщика (пароль
один раз — требование Windows Service Control Manager). У LocalSystem
часто нет прав на UNC (\\server\share\...) — тогда диспетчер моделей отдаёт
пустое дерево (так бывает, если logon ещё не задавали или ставили headless).
Подготовьте доменную (или локальную) учётку с доступом к шарам — обычно
это тот же пользователь, под которым ставите Worker:
Пароль этой учётки понадобится в мастере или сразу после установки.
Navisworks из Windows-службы работает ненадёжно, поэтому служба Model
Actualization сама запускает подготовку NWC как приложение в сессии
вошедшего на Worker пользователя и следит, чтобы оно работало.
58429.InteractiveSession__UserName; InteractiveSession__Enabled=falseСлужбы слушают на машине Worker (localhost / внутренняя сеть):
| Порт | Служба | Назначение |
|---|---|---|
| 57439 | Model Inventory | Дерево моделей, настройки путей |
| 57429 | Navis Report | Clash Detective → отчёт в API |
| 58429 | Model Actualization | Подготовка NWC (CreateCache) |
| 57449 | Worker Updater | Версия Worker, license gate, обновление с SoftInstaller |
Связь с Core двусторонняя:
Наружу в интернет порты Worker не открывайте.
Опционально рядом с exe положите
it4bim.installer.settings.json:
{
"baseCoreApi": "https://collisions.it4bim.ru"
}
Тогда поле API в мастере заполнится само (удобно при установке с общей шары).
Для своей площадки замените URL на ваш Core. JSON рядом с exe имеет приоритет
над user env; аргумент /apiBase — выше.
Заполните по порядку (формулировки в UI могут чуть отличаться):
| # | Параметр | Что указать |
|---|---|---|
| 1 | Адрес API | HTTPS URL Core площадки (без лишнего /api в конце, если мастер так требует — как в подсказке UI) |
| 2 | Лицензия сайта | license.site.* + пароль (realm лицензий IT4BIM) — SoftInstaller и gate обновлений |
| 3 | Учётка API | Логин и пароль ClashFlow площадки для отправки коллизий из Navis (env CollisionsAuth__*); адрес Keycloak мастер берёт с Core по адресу API |
| 4 | Путь Navisworks Manage | Если не определился автоматически |
| 5 | Windows user / password | Учётка служб Worker (по умолчанию текущий пользователь). Пароль Windows обязателен один раз — сохраняется как service-credentials.dpapi / service-logon.*. Поля в UI имеют макс. приоритет |
Каталог установки фиксирован: C:\IT4BIM\Collisions\Worker (в мастере поля пути нет).
Установка:
https://updater.it4bim.ru через Ingress → Windows).Критично: в env Model Inventory должен быть
ModelInventory__ApiBaseUrl = адрес Core (https://collisions.it4bim.ru).
Без него диспетчер моделей отдаёт 500 «ApiBaseUrl не задан».
Мастер Admin всегда прописывает ApiBase и сохраняет api-base.json в каталоге установки.
Дальше адрес Core меняют в веб-интерфейсе («Настройки сервера»): сохранённый
там URL переживает обновления Worker и не сбрасывается адресом по умолчанию.
Дождитесь сообщения об успехе. При ошибке SoftInstaller («нет файлов» /
отказ лицензии) — проверьте исходящий доступ и срок лицензии сайта с IT4BIM.
Полное удаление Worker (службы + весь каталог C:\IT4BIM\Collisions\Worker):
кнопка «Удалить Worker» в Admin-установщике, либо из payload SoftInstaller /
каталога установки:
uninstall-workers.cmd
(или workers.ps1 -Action uninstall от администратора).
Откройте services.msc (или PowerShell от администратора). Должны быть
запущены службы вида:
IT4BIM.Collisions.ModelInventoryIT4BIM.Collisions.NavisReportIT4BIM.Collisions.ModelActualizationIT4BIM.Collisions.WorkerUpdaterПроверка портов на самой машине Worker:
Test-NetConnection -ComputerName 127.0.0.1 -Port 57439
Test-NetConnection -ComputerName 127.0.0.1 -Port 57429
Test-NetConnection -ComputerName 127.0.0.1 -Port 58429
Если служба падает сразу — смотрите журнал Windows Application / логи в
каталоге установки; частые причины: нет .NET 10 (AspNetCore runtime),
неверный API URL,
отказ лицензии, Navis не найден.
Если дерево моделей пустое при живой шаре — почти всегда нет прав на UNC
(служба ещё на LocalSystem). При интерактивной установке logon уже от
учётки установщика; иначе задайте его:
.\workers.ps1 -Action set-logon -ServiceUser 'DOMAIN\user'
(через оснастку служб или скрипт внедрения от IT4BIM тоже можно).
Проверьте от этой учётки: dir \\server\share\... в сессии пользователя.
mapUnc.json)В Windows сетевой диск (Z:\…), который вы видите в проводнике, не
доступен службам Worker сам по себе: буква привязана к вашей сессии входа,
а Model Inventory / Model Actualization / Navis Report работают в отдельной
сессии службы.
Предпочтительно в настройках сервера
указывать пути в виде UNC (\\server\share\…) — так надёжнее всего.
Если на площадке всё же нужны пути с буквой диска (Z:\Оригинальные модели),
настройте файл на машине Worker:
C:\IT4BIM\Collisions\Worker\mapUnc.json
Формат — JSON: буква → UNC-корень (в JSON обратные слэши удваиваются):
{
"Z": "\\\\fileserver\\share\\models"
}
Можно несколько букв:
{
"Z": "\\\\fileserver\\share\\models",
"Y": "\\\\nas\\nwc-export"
}
При старте трёх служб Worker читают этот файл и подключают буквы в своей
сессии (Z: становится видимой службе так же, как вам в проводнике). Права
администратора для служб не нужны — достаточно, чтобы учётка службы имела
доступ к указанной шаре.
После правки файла перезапустите службы Inventory, Model Actualization и
Navis Report (или обновите Worker). Пока файл пустой ({}) или отсутствует —
маппинг не выполняется, это нормально.
Файл площадочный: его не перезаписывает SoftInstaller / обновление
бинарников. Не кладите в поставку чужие лабораторные пути — только свои шары.
На стороне Core (env / Secret API) должны быть URL Worker, доступные
из подов Kubernetes, например:
http://windows-worker.internal:57439 — Inventory;http://windows-worker.internal:57429 — Navis Report;http://windows-worker.internal:58429 — NWC export.Имена хостов — ваши (DNS площадки, Ingress только во внутренней сети, или
Endpoints на IP Windows-машины). После смены env перезапустите Deployment API.
На стороне Worker в env уже должен быть …__ApiBaseUrl / адрес API,
указанный в мастере. Агенты pipeline без этого адреса не claim-ят
задачи — в диспетчере задач job «висит» в ожидании NWC или отчёта.
Под учёткой Administrator:
Первое наполнение состава NWF→NWC может занять время (фон через Navis на
Worker). До этого UI может помечать часть моделей как «не в NWF» — это
нормально на холодном старте.
Полный список — чеклист приёмки.
Администратор может открыть в вебе страницу «Мониторинг». Отдельной
команды диагностики активного Roamer на странице нет; состояние разбирают по
списку процессов и обычному текстовому логу. Доступ к странице и Core API есть
только у Administrator. Порт Worker 58429 должен оставаться во внутренней
сети.
Ниже таблицы Navisworks на той же странице есть блок «Все процессы
Worker»: PID, родительский PID, сессия (0 — службы, 1+ — пользователи),
окно, CPU, память и время старта всех процессов машины. Процессы, порождённые
Roamer или его потомками, подсвечены как «Дочерний Navisworks», а
запущенные после старта текущего CreateCache отмечены отдельно — так видно,
не ждёт ли Roamer вспомогательный процесс или окно Autodesk в сессии 0.
Список фильтруется по имени или PID и сортируется по старту, CPU или памяти.
Снимок машины обновляется раз в 2 секунды, лог — раз в 15 секунд. Командная
строка процессов не показывается. Worker старой версии список не отдаёт —
страница попросит обновить Windows Worker.
В блоке «Лог Model Actualization (txt)» кнопка «Открыть целиком»
показывает полный текущий ma-*.log (до 10 МБ), а «Скачать» выгружает его
без ограничения размера. Именно здесь находятся текущие ошибки CreateCache и
цепочка HResult.
Отдельный файловый архив диагностики CreateCache не создаётся и в вебе не
показывается. После окончательного отказа Worker не запускает второй Roamer;
для временных отказов выполняется до трёх Automation-попыток. Доступ к
обычному логу, как и ко всей странице, есть только у Administrator; порт
Worker 58429 не публикуйте во внешнюю сеть. При первом старте обновлённый
Worker удаляет прежний каталог <staging-root>\diagnostics\createcache.
Если Navisworks на Worker падает или ведёт себя странно, причиной может быть
испорченный пользовательский профиль. На странице «Мониторинг» в блоке
«Настройки Navisworks» есть кнопки «Сбросить настройки» и
«Восстановить настройки».
Сброс затрагивает все загруженные профили Windows на Worker: учётку службы и
пользователя, в чьей сессии запускается Roamer. Папки
%AppData%\Autodesk Navisworks Manage 20XX переименовываются, ветки реестра
HKCU\Software\Autodesk\Navisworks Manage сохраняются в резервную копию и
удаляются. При следующем запуске Navisworks создаст настройки по умолчанию.
Параметры со страницы «Настройки выгрузки» не теряются: Worker применяет их
к File Reader при каждой выгрузке NWC.
«Восстановить настройки» возвращает последнюю резервную копию. Обе операции
недоступны, пока на Worker запущен Navisworks: дождитесь окончания выгрузки
NWC. Если пользователь вышел из Windows после сброса, его реестр восстановится
только после повторного входа — копия сохраняется до этого момента.
| Способ | Когда |
|---|---|
| WorkerUpdater (служба) | /version, license gate; обновление payload — кнопка в UI «Обновить Worker» |
| Повторный запуск Admin-установщика | Крупное обновление / смена роли / по просьбе IT4BIM |
| Тихий update (скрипт внедрения) | Когда IT4BIM передаёт runbook с Setup.exe /silent … |
Перед обновлением не оставляйте mid-run тяжёлые job без согласования.
Локальные appsettings / server-settings установщик сохраняет; бинарники
берёт с SoftInstaller.
Как и плагины Revit/Navisworks, Worker обновляется пофайлово: скачиваются
только файлы, содержимое которых изменилось. Установщик держит зеркало payload в
%ProgramData%\IT4BIM\Installer\cache\Worker и перед загрузкой ищет файл с тем
же размером и SHA-256 в этом кэше и в установленном Worker
(C:\IT4BIM\Collisions\Worker). Совпавший файл берётся локально, даже если
сервер опубликовал его заново с новой датой. В логе обновления это видно по
строке SoftInstaller: план — скачать N (~… МБ), взять локально M …; обычно
после релиза скачивается несколько собранных DLL, а не весь payload (~470
файлов). Кэш можно удалить — следующее обновление восстановит его из
установленного Worker без скачивания.
Перед upload в SoftInstaller CI гоняет Obfuscar по IT4BIM*.dll
(deploy/windows-worker/publish-to-softinstaller.ps1). На каждом модуле
не обфусцируются API/DTO:
*Dto / *Request / *Response (+ nested)*Endpoints / *Controller / *Extensions (+ nested <>c)*Options (биндинг env/appsettings)Новые Minimal API на Worker — через явный RequestDelegate (HttpContext +
RequestServices), без лямбд с параметрами: иначе после Obfuscar служба
падает при старте (parameter without a name), UI показывает «недоступен».
Лицензия сайта должна быть активна — иначе SoftInstaller может
отказать в скачивании Worker.
Updater сам себя обычно не обновляет «на лету» (файл службы залочен) —
полный Setup по инструкции IT4BIM.
| Симптом | Что проверить |
|---|---|
| Model Actualization Stopped / «недоступен» + timeout 3s | Event Log: parameter without a name → Obfuscar+Minimal API; нужен свежий Worker с RequestDelegate diagnostics |
| Пустое дерево моделей | Учётка служб → UNC; пути в настройках сервера; Inventory на :57439 |
«Путь не найден» для Z:\… |
Буква из проводника службе не видна — UNC или mapUnc.json (см. выше) |
| 502 / timeout дерева | Не открывать Navis на каждый refresh (так задумано); смотреть службу Inventory |
| Job вечно «ожидание NWC / отчёта» | ClashDetectionAgent__ApiBaseUrl у служб, сеть Worker→API, lease/логи NavisReport |
| SoftInstaller / Setup: нет пакета | Лицензия сайта, исходящий доступ, обращение в IT4BIM |
| Navis не стартует из службы | Manage установлен, лицензия Automation; Session 0 / interactive — по runbook IT4BIM |
NWC не выгружаются, :58429 не отвечает, служба MA запущена |
Model Actualization работает в сессии пользователя Worker: войдите на Worker (консоль или RDP, можно отключиться без выхода) под учёткой с лицензией Navisworks; причина — в %ProgramData%\IT4BIM\ModelActualization\logs\supervisor-*.log |
| Предупреждение «Связи не удалены перед выгрузкой» | Установлен ли Revit версии модели или новее, лицензия и пройденный первый запуск у пользователя сессии выгрузки; подробности — в ma-*.log или Seq: ModelPurgeFailed (шаг очистки в тексте ошибки), строки Revit purge plugin: (шаги, диалоги, сообщения Revit, загруженные надстройки и updaters) и Revit journal: (исключения из журнала Revit). «A managed exception was thrown by Revit or by one of its external applications» обычно означает сбой сторонней надстройки Revit у этого пользователя |
| Примечание «Связи удалены, но при очистке были нюансы» | Связи удалены, NWC собран из очищенной модели; Revit сообщил об ошибке при открытии (обычно сторонняя надстройка падает в событии открытия документа). Какая надстройка — в строках Revit journal: в ma-*.log или Seq; при повторении надстройку можно отключить у пользователя сессии выгрузки |
| Отчёт есть, картинок нет | MinIO на Core, не Worker |