Известные кейсы (Buildography)
1. Лицензирование и Sentinel
Проблема | Решение |
Sentinel key not found (H0007) — Buildography не видит лицензию
|
На билд-машине в $HOME/.hasplm/hasp_101213.ini (или /etc/hasplm/hasplm.ini) указать serveraddr = <hostname или ip сервера лицензий>. Файл создать, если его нет.
|
Программная лицензия не подходит к сборке под XEKDC
|
Обновиться до Buildography 3.7.5 — в нём добавлены сборки под XEKDC (vendor id 36343) и YMYCK (101213). Использовать buildography-v3.7.5+sentinel-xekdc.amd64.tar.gz или buildography-v3.7.5+sentinel-ymyck.amd64.tar.gz.
|
Не видит новый лицензионный ключ после обновления
|
Обновить Buildography до 3.7.5. Установить sentinel-runtime из папки нужного вендора. Удалить старый файл ключа .v2c.
|
Sentinel LDK Protection System: Sentinel key not found на одной из машин сборки
|
Проверить, что у пользователя сервиса есть доступ к ~/.hasplm/hasp_101213.ini. Убедиться, что файл не ведёт на другого пользователя (в Docker — жёстко прописать путь, например /root/.hasplm/hasp_101213.ini).
|
Buildography не подключается к лицензии из Docker-контейнера
|
Запустить контейнер с --net=host. В hasp_101213.ini указать broadcast_search = 0, serveraddr = <IP>, увеличить server_search_timeout. Проверить доступность UDP-порта 475: nc -z -v -u <IP> 475.
|
Программная лицензия была привязана к другому хосту
|
Программная лицензия привязана к fingerprint хоста. Если хост менялся — запросить новую. Для отладки — sentinel-liccheck из папки sentinel-runtime.
|
Лицензия Svace и Buildography — можно ли использовать одну
|
Это независимые лицензии. Если на USB-ключе только Svace — дозаписать Buildography или использовать программную лицензию. Программную можно использовать на другом хосте по сети.
|
Как продлить лицензию
|
Написать в отдел оформления лицензий: SDL@ispras.ru или через https://www.ispras.ru/sdl/. Для сертификации полезно приложить fingerprint.
|
Нужна ли aksusbd.deb на билд-машинах
|
Нет. Пакет нужен только на сервере с лицензией. На билд-машинах достаточно указать serveraddr.
|
Работа через Docker-контейнеры
| Запускать бинарник hasplmd_x86_64 -s, читающий /etc/hasplm/hasplm.ini. |
2. Дистрибутивы и установка
Проблема | Решение |
Где искать дистрибутив Buildography
| |
Какая сборка подходит под мой ключ
|
Смотреть код вендора в Sentinel Admin Control Center (http://localhost:1947/). YMYCK (101213) → buildography-v3.7.5+sentinel-ymyck.amd64.tar.gz. XEKDC (36343) → buildography-v3.7.5+sentinel-xekdc.amd64.tar.gz.
|
Buildography на Windows
|
Версии под Windows не существует. Buildography — трассировщик Linux-процессов, работает через ptrace. Планов сборки под Windows нет.
|
Как установить
|
tar xf buildography-<arch>.tar.gz -C <install-dir> |
3. Ошибки утилит анализа (bxy_*)
Проблема | Решение |
bxy_find_unbuilt_binaries: ошибка разбора флага -o <filename>
|
Ошибка не связана с Buildography — ! в bash используется для history expansion. Использовать одинарные кавычки, экранировать \ или выполнить set +o histexpand.
|
bxy_parse_flags: Cannot deduce type of command with id ...: incomplete rules
|
Возникает из-за конфигурационных тестов, которые могут завершаться неуспешно. Использовать скрипт bxy_sieve, чтобы отсеять такие команды перед bxy_parse_flags.
|
bxy_parse_flags не поддерживает символические ссылки
|
В актуальной версии исправлено (workaround на уровне bxy_parse_flags). Обновить Buildography.
|
bxy_parse_flags не поддерживает -M* флаги GCC
|
В актуальной версии исправлено. Обновить Buildography.
|
|
bxy_diff: JSONDecodeError: Expecting property name enclosed in double quotes
|
На вход подан обрезанный JSON (трассировщик завершился досрочно или JSON обработан внешним скриптом). Проверить целостность: jq < file.json > /dev/null. Обновить Buildography.
|
ModuleNotFoundError: No module named 'msgspec'
|
Установить msgspec из pip в систему или venv, под которым запускаются скрипты. Скрипты анализа — на Python, лицензией не защищены.
|
High memory consumption на JSON > 8 ГиБ
|
В актуальных релизах улучшено, но полностью решается после рефакторинга. Если проблема воспроизводится — сообщите в поддержку.
|
Скрипты анализа падают на несовпадении версий
| Основная и подверсия Buildography во входных JSON должны совпадать с текущей версией инструмента. При несовпадении — аварийный останов. |
5. Зависания трассировщика
Проблема | Решение |
Зависание dotnet build / dotnet publish (.NET 9.0)
| Причина — build-серверы VBCSCompiler, которые не завершаются. Решения: --disable-build-servers, dotnet build-server shutdown или <UseSharedCompilation>false</UseSharedCompilation> в .csproj. |