November 13, 2025 - OPC UA gateway local database upgrade

Context


Change Type: Announcement
Product area: Device management & connectivity
Component: OPC UA
Deployed at: eu.latest.cumulocity.com, apj.cumulocity.com, jp.cumulocity.com, cumulocity.com, us.cumulocity.com, emea.cumulocity.com

Technical details

Build artifact: opcua (1022.0.0)
Internal ID: DM-4961

Description


Together with the update to Java 17, the internal database of the OPC UA gateway has been changed from MapDB and ChronicleMap to RocksDB.
This change enhances the performance and reliability of the gateway, ensuring compatibility with Java 17.

Important
Note that this update may require additional data migration or re-registration of device gateways.
Refer to Upgrading from 1021 to 1022 gateway version in the documentation.

It is recommended to back up your existing local gateway data before proceeding with the update.

Some gateway properties related to the internal database have been removed and are no longer applicable:

  • gateway.mappingExecution.alarmStatusStore.maxEntries
  • gateway.mappingExecution.deviceTypeMappingStore.maxServerMappingsEntries
  • gateway.mappingExecution.alarmStatusStore.averageKeySize
  • gateway.mappingExecution.deviceTypeMappingStore.averageMappingsKeySize
  • gateway.mappingExecution.deviceTypeMappingStore.averageMappingsValueSize
  • gateway.mappingExecution.alarmStatusStore.maxBloatFactor
  • gateway.mappingExecution.deviceTypeMappingStore.maxMappingsBloatFactor