/
How to Correctly Configure the UNS ISA95 prefixAllTopics Option in HiveMQ Edge 2025.3

How to Correctly Configure the UNS ISA95 prefixAllTopics Option in HiveMQ Edge 2025.3

Owned by Daria Samkova, created
May 05, 2025

Summary:
In HiveMQ Edge 2025.3, the ISA95 UNS configuration no longer accepts kebab-case (prefix-all-topics) and instead requires camelCase (prefixAllTopics). This change may result in the UNS prefix silently not being applied, without any error messages.

 Instructions

Symptoms:

  • The UNS prefix is not applied to MQTT topic mappings.

  • No errors are shown in logs or UI.

  • Configuration that worked in earlier versions (e.g., 2024.x) now silently fails.

Root Cause:
HiveMQ Edge 2025.3 expects prefixAllTopics in camelCase format in API requests and configurations. Earlier versions may have accepted prefix-all-topics.

Solution:

  1. Verify the current configuration via the Edge REST API:

    GET /api/v1/management/uns/isa95

  2. Check for this field in the response:

    { "enabled": true, "prefixAllTopics": true, "enterprise": "TECHNOFORM", "site": "GHISLENGHIEN", "area": "", "productionLine": "", "workCell": "" }

  3. Update your configuration accordingly using the API or UI:

    • If configuring via API: ensure the JSON payload uses prefixAllTopics.

    • If configuring via UI: ensure the "Prefix All Topics" toggle is set.

Notes:

  • The older prefix-all-topics is silently ignored in HiveMQ Edge 2025.3.

  • A new UI button has been introduced to explicitly control prefixAllTopics.

 Related articles