ThingWorx Azure IoT Hub Connector Release Notes, v. 3.0.1
ThingWorx Azure IoT Hub Connector Release Notes, v. 3.0.1
The ThingWorx Azure IoT Hub Connector enables devices that use the Microsoft Azure IoT Edge SDKs and IoT Hub Device SDKs to interact with the ThingWorx Platform. The ThingWorx Azure IoT Hub Connector includes the following components:
• The core connection server and the Azure IoT Hub Protocol Adapter, configured to support Azure IoT Hubs, Azure IoT Edge Devices and Edge Modules, and Azure Blob Storage Containers connected to an Azure IoT Hub.
• An Azure IoT Hub Adapter Extension that must be imported into ThingWorx Platform to support Azure IoT entities. This extension provides entities to support Azure IoT Devices and Azure IoT Edge Devices, an Azure IoT Hub, and Azure Storage Containers.
• Another extension, called Connection Services Extension (CSE), which manages communication between ThingWorx Platform and the Azure IoT Hub Connector.
Together, these components provide the following features:
• Scalable connectivity between ThingWorx Platform and Azure IoT Hubs, Azure Blob Storage Containers, and Azure IoT Devices and Edge Devices.
• Horizontally scalable by adding instances of the ThingWorx Azure IoT Hub Connector to handle increased load.
• A health check service, logging, and metrics collection, which enable you to monitor the health of the connection to the ThingWorx Platform as well as the traffic that it is handling. The logging feature provides detailed logs to help in troubleshooting.
• Configuration file to tune settings for the Connector.
• Security for connections to ThingWorx Platform.
All of these components are part of the distribution bundle for the Connector.
What's New in ThingWorx Azure IoT Hub Connector, v.3.0.1
The ThingWorx Azure IoT Hub Connector, v.3.0.1, includes security-related updates, as follows:
• Fixed potential security issues, including items proactively identified by vulnerability scanning software or PTC Quality Assurance testing. Please upgrade as soon as possible to take advantage of these important improvements.
• See this technical support article for important recommendations regarding the use and update of third-party software for ThingWorx.
What Changed in ThingWorx Azure IoT Hub Connector, v. 3.0.0
Release 3.0.0 of the ThingWorx Azure IoT Hub Connector provides support for Azure IoT Edge Devices, improved support for native capabilities of Azure IoT Hub and Azure IoT Devices. The following table lists the changes for this release and provides links to details about them:
Feature
Description
Improved ease of Azure IoT Hub configuration
Improved ease of granting visibility and permissions to the Azure IoT Hub Connector.
Support for Azure IoT Edge Devices and Edge Modules
Improved outgoing message ("egress") processing
Support for Device Methods for Azure IoT Edge Devices as well as Azure IoT Devices
Improved support for Azure Blob Storage
Encryption of the configuration file for the Azure IoT Hub Connector
Updated smoke test for Azure IoT Edge Devices and Modules
Improved metrics for monitoring your Connector
Improved troubleshooting information
Improved logging by adding rolling policy
For more information about the Azure IoT Hub features, refer to the Microsoft Azure IoT Hub developer guide at https://docs.microsoft.com/en-us/azure/guides/developer/azure-developer-guide.
Issues Fixed in v.3.0.0
In addition to continuous security improvements, this release provides the following software issues fixed in this release:
ID (SFID)
Description
AZX-485 (14753782)
Azure IoT Hub Connector 2.0.0 works well with Java 1.8_u131 but fails with Java 1.8_201 on Azure Windows 2016.
This issue is fixed in v.3.0.0 of the Connector. The version of Java for this release is 1.8_u141 at minimum due to requirements of the ThingWorx Security Client application.
AZX-372 (14078093)
The Edge Device demo fails to start with error: No signature of method.
This issue is fixed in this release.
AZX-374 (14074993)
Azure IoT Hub Connector Firmware Update Demo NodeJS code fails.
This issue is fixed in this release.
Known Issue
The following table describes a known issue for this release:
ID
Description
AZX-3
Message ordering is not preserved for a single device.
Although messages are retrieved synchronously from the Azure Event Hub endpoint, messages are dispatched to ThingWorx Platform asynchronously, leading to potential out-of-order application.