DataMiner Extension Modules (DxMs)
About DxMs
A DataMiner Extension Module (DxM) is an independently versioned service that can be installed, upgraded, and uninstalled without rebooting the DataMiner Agent. DxMs extend the core DataMiner software with additional features and capabilities. DxMs can be added through the Admin app and through DataMiner upgrade packages. In most cases, DxMs are backward-compatible with all supported core DataMiner versions. In cases where this is not possible, a minimum required core DataMiner version is indicated.
When you trigger a DxM update via the Admin app, any dependencies (typically the required .NET version) are indicated.
Tip
If you are looking for information on DataMiner modules included in the core upgrades, refer to DataMiner Core Modules (DcMs).
Packs
For ease of installation, DxMs may be packaged together in a pack, such as the Cloud Pack. These packs allow users to install several DxMs at once.
Available DxMs
CloudGateway
The CloudGateway module is responsible for connecting a DataMiner System to dataminer.services. It manages the identity towards dataminer.services and ensures a secure connection.
This DxM is included in DataMiner upgrade packages from DataMiner 10.5.9/10.6.0 onwards. However, the DxM will only be upgraded if an older version is found on the DMA. If no older version is found, it will not be installed.
CloudFeed
The CloudFeed module is responsible for offloading data towards dataminer.services. This setting can be controlled in the Admin app. Among the data that is offloaded are alarm events, change point events, SRM events, element configuration events, and feedback events.
From CloudFeed version 1.4.0 onwards, the minimum required DataMiner version is DataMiner 10.4.10.
From DataMiner 10.5.0/10.5.1 onwards, DataMiner upgrade packages by default include the latest version of the CloudFeed module. If a newer version of the CloudFeed module is available but you prefer not to install an upgrade package, you can install a newer version separately via the Admin app.
CommunicationGateway
The CommunicationGateway module makes it possible for connectors or scripts running in the DataMiner environment to communicate with devices that require a gRPC connection.
At present, we support the gNMI service, but more services and RPC connections may be added.
This DxM exists in tandem with service-specific middleware that facilitates the NATS communication to the DxM. However, not all middleware require the CommunicationGateway to establish a connection with the device. The DxM is primarily used to bridge the gap between different .NET versions. This is because gRPC requires .NET 5 or higher for full functionality, while SLScripting still runs on .NET 4.6.2.
Tip
See also: OpenConfig Middleware
DataMiner Assistant
The DataMiner Assistant module extends DataMiner with conversational AI. For more information, see DataMiner Assistant DxM.
Note
Prior to version 2.0.0, this DxM is called "Copilot".
DataAggregator
See Data Aggregator.
DataAPI
The DataAPI module provides an HTTP interface that accepts requests with a JSON-formatted body. When required, it creates an element to store values extracted from the JSON payload.
In combination with the DataAggregator DxM, the DataAPI DxM is required for the Data Sources module.
This DxM is included in DataMiner upgrade packages from DataMiner 10.5.11/10.6.0 onwards. However, the DxM will only be upgraded if an older version is found on the DMA. If no older version is found, it will not be installed.
ModelHost
The ModelHost module is responsible for allowing users to retrieve parameter relationship data on DataMiner Agents that are connected to dataminer.services and have been configured to offload alarm and change point events to the cloud.
The ModelHost DxM is not included in the Cloud Pack and must be deployed separately. However, once it has been deployed, it gets upgraded when you install DataMiner upgrades from DataMiner 10.5.7/10.6.0 onwards.
SiteManager
The SiteManager module is used to set up secure communication tunnels enabling access to on-premises data sources from a DaaS system. It is supported from DataMiner 10.5.10/10.5.0 onwards and is included in the 10.5.10 DaaS image.
For more information, refer to Edge Manager.
Logging
If you encounter any issues with a DxM, consult the log files for errors and warnings. By default, you can find these in the following folder: C:\ProgramData\Skyline Communications\<DxM>\Logs.