Установка, лицензия и обновление

От проверенного BTP к работающему экземпляру на тестовых данных.

Лицензия на ваш ID

Если включен лицензионный контроль, нужны разрешенный runtime и entitlement на точный plugin ID. Для неизмененного примера это io.example.community-starter. Запросите его у команды BlueTraktor для своей установки; название пакета или редакция «Профессиональный» не заменяют это право.

Для привязанной лицензии передавайте только публичный ID установки. Ключи и секреты автору плагина не нужны. Готовую лицензию применяет администратор; она не включается в BTP или config.

bash

sudo bluetraktor license device-id
sudo bluetraktor license install customer-license.json
sudo bluetraktor license status

Установка пакета

Откройте Настройки → Плагины и убедитесь, что менеджер готов.
Выберите Загрузить и укажите платформенный .btp.
Дождитесь inspection. Сверьте ID, версию, издателя, platform, SHA-256 и capabilities.
Стартер неподписан: ожидается LOCAL_UNSIGNED (в HTTP/UI local_unsigned). Подтверждайте только собственный проверенный пакет и только если политика установки это допускает.
Завершите установку и проверьте появление нужной версии в библиотеке.
Если ответ потерян, сначала обновите список и проверьте результат, прежде чем повторять загрузку.

Экземпляр

Добавьте экземпляр установленной версии и задайте понятное имя.
Выберите сервер, числовой путь и MQTT-топик; проверьте раскрытые точные grants в форме.
Для первого запуска: scale = 1, offset = 0, intervalMs = 5000.
Во вкладке Доступ явно разрешите оба точных capability, прочитав их reason.
Оставьте системные лимиты по умолчанию и сохраните экземпляр остановленным.
Запустите и дождитесь фактического running/«Работает». «Запуск запрошен» означает только желаемое состояние.

Проверка результата

Первые две строки подтверждают готовность и принятие публикации. Отдельным MQTT-клиентом стенда проверьте сообщение: для входа 21.5, scale = 1 и offset = 0 ожидается {"value":21.5}. Затем остановите экземпляр и дождитесь остановленного состояния и строки STOP. Повторите запуск.

Running и READY не доказывают свежесть источника или доставку MQTT подписчику. WARN может появляться при продолжающем работать процессе. Локальное подтверждение unsigned-пакета не дает grants, не добавляет лицензию и не разрешает UI contributions.

text

BT_STARTER READY
BT_STARTER OK publish accepted (QoS 0)
BT_STARTER STOP shutdown received

Тесты на стенде

Корректный ввод, неверный тип, слишком большой payload и переполнение результата.
Отсутствие обязательного grant и несовпадение config с разрешенным путем.
Временная недоступность источника и MQTT, ограниченные повторы и восстановление.
Остановка во время чтения, публикации и паузы, без оставшегося старого процесса.
Правильный отказ без entitlement на отдельном тестовом экземпляре.
Повторный запуск после перезапуска установки и отдельный smoke-test каждой платформы.

Ручное обновление

В актуальном менеджере можно сменить установленную версию у остановленного экземпляра с сохранением ID. Сохраняется один предыдущий checkpoint config/data для ручного возврата. Автоматического health-check rollback и произвольных migration scripts нет. В более старой установке сначала проверьте поддержку этой операции.

Сохраните старый BTP, digest, config, grants и лимиты; проверьте возможность возврата.
Увеличьте версии в Cargo.toml и manifest, обновите lockfile и повторите тесты, сборку и inspection.
Установите новую версию рядом со старой, остановите экземпляр и дождитесь остановки. Выберите новую версию; исправьте config под новую схему и заново согласуйте измененные права.
Сохранение выполняет смену версии и сохраняет предыдущее поколение. Проверьте результат перед запуском. Для отдельного параллельного теста используйте другой разрешенный topic.
Запустите обновленный экземпляр и проверьте бизнес-результат, источник данных и журналы.
При проблеме остановите экземпляр и выберите ручной возврат предыдущего checkpoint. Отозванные grants не восстанавливаются, а внешние публикации и действия оборудования не отменяются.
Удаляйте старые экземпляры и неиспользуемый пакет только после проверки.