thingsHub Public Documentation

Breaking Changes in thingsHub 5.3

This document describes the changes that a user must be aware of when upgrading from thingsHub 5.2 to thingsHub 5.3:

Breaking helm changes:

Only for On-Premise Customers

Restructure of Kafka TLS configuration in thingsflow
The tenant configuration file structure for Kafka’s tls configuration block in thingsflow has been changed. The whole tls_config section has been moved to thingsflow.node_config.kafka .

Previous:

global:
  ...
  ...
thingsflow:
  enabled: true
  tls_config:
    ca_cert: <YOUR BASE64 ENCODED CA CERTIFICATE>
    tls_cert: <YOUR BASE64 ENCODED TLS CERTIFICATE>
    tls_key: <YOUR BASE64 ENCODED TLS KEY>


Changed to:

global:
  ...
  ...
thingsflow:
  enabled: true
  node_config:
    kafka:
      enabled: true
      tls_config:
        ca_cert: <YOUR BASE64 ENCODED CA CERTIFICATE>
        tls_cert: <YOUR BASE64 ENCODED TLS CERTIFICATE>
        tls_key: <YOUR BASE64 ENCODED TLS KEY>

Required Actions:

  • Change the structure of the thingsflow.tls_config block to the format specified above in the tenant configuration file

Ensure these changes are implemented before upgrading to thingsHub 5.3 to avoid any disruptions in functionality.