---
title: BHDM 2.22.2
slug: bhdm/bhdm-2222
createdAt: 2024-09-10T16:28:25.175Z
---

:::hint{type="warning"}
**Important**: For a seamless upgrade experience in upcoming releases, it's crucial to upgrade from version 2.16.4 to 2.22.2 before making any further upgrades. Skipping the initial upgrade to version 2.16.4 and then 2.22.2 may disrupt the upgrade process, and is therefore not recommended.
:::

Release Date: Sept 25, 2024

Review the current list of [Limitations](docId\:c9I0pTd59DMhn2evgFD-_).&#x20;

## New Features

| **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Central Certificate Management:**<br />- The *Certificates&#x20;*&#x70;age has been updated to manage **SSL Certificates** on Edge Devices. The page includes combined menu items, sorting and filtering options, menu actions, as well as logging and monitoring features.<br />- Th&#x65;*&#x20;Certificate action* tab includes three actions:<br />- Issue a new certificate<br />- Upload a new certificate<br />- Reset to Edge default certificate<br />- The periodic certificate expiry check and renewal process for Edge devices is now available. |
| **Central AI/ML Model Management:**<br />- The main homepage now features a new user interface for central management of **AI/ML Models**, including summary statistics to provide a comprehensive understanding of the usage of AI/ML Models within Belden Horizon Data Operations.                                                                                                                                                                                                                                                                            |
| **DigiCert IoT Trust Manager integration**:<br />- The **DigiCert IoT Trust Manager** integration is now available from the admin console.                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Central Licenses Management:**<br />- The *License&#x20;*&#x6D;anagement homepage now features a new user interface with summary statistics, providing a comprehensive understanding of key usage within Belden Horizon Data Manager.<br />- The *License&#x20;*&#x6D;anagement page allows users to monitor and manage the expiration status of features and core licenses for edge devices within the current project.                                                                                                                                      |
| **Alerts:**<br />- The *Incidents&#x20;*&#x6F;ption is now accessible under the *Alerts&#x20;*&#x70;age, allowing you to effortlessly configure triggers and send notifications.                                                                                                                                                                                                                                                                                                                                                                                |
| **Edge Devices:**<br />- The Edge Devices page now includes a new menu item for **Node-Locked (NL) Licenses**. This feature displays a list of all NL licenses used across all projects and allows you to download the list as a *CSV&#x20;*&#x66;ile.                                                                                                                                                                                                                                                                                                          |
| **Activation:**<br />- The template variables now have a new drop-down selection menu for the variable name field, allowing users to select from the list of all the variables defined in the parameterized templates in the activation configuration.<br />- The *Activation&#x20;*>*&#x20;Requests* page displays an optimized summary of the activation requests and their respective statuses, including Total, Waiting for Approval, Processing, Processed, and Failed.                                                                                    |

## Enhancements and Improvements

| Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Admin Console Cloud Settings**:<br />- In *Cloud&#x20;*&#x73;ettings:<br />- When configuring *Cloud Credentials*, you now have the option of configuring GCP Workload Identity Federation (OIDC) for authorization.<br />- During account service key rotation, mpc-sync service account keys are also rotated as well.<br />- In *Domain/SSL* settings, the SSL Settings log now displays more information for update operations in SSL settings.<br />- In *Email&#x20;*&#x73;ettings, when the Enable SMTP toggle is disabled, any existing SMTP settings are now removed.                                                                                                                                                                                                                     |
| **Edge Devices:**<br />- The **Description&#x20;**&#x63;olumn is added to the edge device list.<br />- When the Belden Horizon Data Manager base-domain name is updated, respective activation URLs for Edge devices are automatically updated based on the new domain name.<br />- Upgrades are now restricted to VM-based Edge devices. Upgrades on Docker-based Edge devices are not allowed.<br />- The Nginx limit for the activation endpoint of 10 rps (requests per second) is now removed, allowing for more Edge devices to be processed at one time.<br />- The error message now contains the Activation config code and correct template name during failed activations with a template.<br />- Added logging for the deactivation process for an edge device in the *API actions* log. |
| **Templates**:<br />- The **Templates&#x20;**&#x6D;odule for Edge devices are now included in Belden Horizon Data Manager backups. If a Belden Horizon Data Manager backup is restored, Edge device templates are also restored.<br />- The **Template** cannot have duplicate names and must be unique.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Alerts:**<br />- The alert for DeviceHub device offline status has been updated to exclude stopped DeviceHub devices from generating Offline Device alerts.<br />- The Belden Horizon Data manager now supports triggering alerts with severity set to `Info`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Applications:**<br />- The device deployment status display has been improved to show the number of devices with the app and the total number of devices (online + offline). Additionally, the help text has been updated, and a subheader has been added to describe the widget's purpose without requiring a hover.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **DLM Actions:**<br />- The Purge action can now be used to archive and delete Clickhouse table data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Keycloak:**<br />- Upgraded keycloak to `24.0.5`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **User Interface:**<br />- The *Company list* page now displays the number of connected edge devices for each company.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Certificates:**<br />- The *Issue a new certificate* dialog box has a new Certificate Authority field, which includes `BHDM` and `DigiCert IoT Trust Manager` as selectable values for certificate issuance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Marketplace:**<br />- The marketplace catalog's API can be accessed by third-party applications using tokens authorized by Belden Horizon Data Manager's admin.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Settings:**<br />- The *CREDENTIALS&#x20;*&#x70;age in *Settings&#x20;*&#x68;as been updated with a new user interface to separately display and download SSL certificate information for MQTT and Web servers.<br />- Th&#x65;**&#x20;DigiCert IoT Trust** option is available for setting the SSL certificate only when the DigiCert integration parameters are configured.                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Domain/SSL:**<br />- The *SSL settings* have a new Async task to distribute Belden Horizon Data Manager's CA certificates to all activated Edge devices.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Support:**<br />- The support bundle has been updated to include docker disk usage information, which can be found in the `./utils/docker_system_df_output.txt` file.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Software:**<br />- The title of the *Software&#x20;*&#x6D;enu under *Projects&#x20;*&#x68;as now changed to **Software Update**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Incidents:**<br />- The *Incidents&#x20;*&#x6E;ow have added support for creating alerts and triggers based on OPC UA telemetry from the Prometheus endpoint.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Features:**<br />- The marketplace catalog app now supports adding fully compliant Docker Compose files to the new application releases.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

## Resolved Issues

| **Description**                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Edge Management**:<br />- Fixed issue with flows dashboard not showing on Remote UI.                                                                                                                                                                                         |
| **Security**:<br />- Various vulnerabilities fixes are addressed in this release.                                                                                                                                                                                              |
| **Events & Alerts:**<br />- Fixed the issue of not being able to set the *Verify SSL* setting to **false**.                                                                                                                                                                    |
| **Software Updates:&#x20;**<br />- Fixed issues with upgrades through update files failing because of insufficient disk space.                                                                                                                                                 |
| **DeviceHub**:<br />- Fixed issue with devicehub drivers parsing and saving payloads with new keys to OMA tables in ClickHouse.<br />- Fixed issue with maximum message size for syslog where messages are now truncated to fit within the limit.                              |
| **User Interface**:<br />- Fixed issue with `%` data on the *Disk Usage graph,* partially hiding the number. All data in percentages are displayed in full now.                                                                                                                |
| **Profile:**<br />- Fixed issue with the Two-factor authentication section that was causing an `Internal server error` when attempting to set up **2FA**.                                                                                                                      |
| **Sites:**<br />- Fixed issue encountered when attempting to add a site without an image, resulting in an `Error 403`.                                                                                                                                                         |
| **Integration**:<br />- Fixed issue where the Clickhouse data directory was relocated to the wrong location during an upgrade.                                                                                                                                                 |
| **Applications**:<br />- Fixed issue with an empty list displaying after filtering the list of applications by catalog.                                                                                                                                                        |
| **Tokens**:<br />- Fixed issue with not all associated projects being automatically selected when you select **\[Company name] \[All projects]**.<br />- Fixed issue with the long-term API Admin token not being able to create a new company and returning an error message. |

## Deprecated Components and Features

| **Description**                                                                |
| ------------------------------------------------------------------------------ |
| **Settings**:<br />- The OMA bindings are no longer available for any project. |

