Welcome to ThingWorx Azure IoT Hub Connector 5 Help Center
Microsoft Azure Documentation Links
Terminology
Release Notes
Release Notes for ThingWorx Azure IoT Hub Connector 5
What’s New in ThingWorx Azure IoT Hub Connector 5.0.0
Fixed Issues in ThingWorx Azure IoT Hub Connector 5.0.0
Release Notes Archive
Release Notes for ThingWorx Azure IoT Hub Connector 4.3.2
What’s New in ThingWorx Azure IoT Hub Connector 4.3.2
Fixed Issues in Azure IoT Hub Connector 4.3.2
Known Issues in Azure IoT Hub Connector 4.3.2
Release Notes for ThingWorx Azure IoT Hub Connector 4.3.1
What’s New in ThingWorx Azure IoT Hub Connector 4.3.1
Fixed Issues in Azure IoT Hub Connector 4.3.1
Known Issues in Azure IoT Hub Connector 4.3.1
ThingWorx Azure IoT Hub Connector 4.3.0 Release Notes
ThingWorx Azure IoT Hub Connector 4.2.0 Release Notes
ThingWorx Azure IoT Hub Connector 4.1.0 Release Notes
ThingWorx Azure IoT Hub Connector 4.0.0 Release Notes
What's New in This Help Center Archive
ThingWorx Azure IoT Hub Connector
What is the ThingWorx Azure IoT Hub Connector?
Features of the ThingWorx - Azure IoT Integration
Azure IoT Hub Connector — Device Twin Support
Azure IoT Edge Module Twin
Security and the Azure IoT Hub Connector
ThingWorx Azure IoT Hub Connector in a ThingWorx High Availability Cluster
Installing the Azure IoT Hub Connector
System Requirements
Sizing Guidance
Step 1. Create and Configure Items in Azure IoT
Step 2. Download and Extract the Azure IoT Hub Connector
Content of the Distribution Bundle
Step 3. Import the Extensions
Step 4. Create Security Entities for the Connector
Step 5. Create Azure IoT Entities in ThingWorx Composer
Step 6. Configure the Connector
Before You Begin Configuration
Installing the Connector in Firewalled Environments
Minimal Configuration for Connecting to a ThingWorx Platform in Single-Server Mode
High Availability Configuration
Configuration Properties Reference
Optional Configuration Properties Shown in the Minimal and HA Sample Configuration Files
Creating a TrustStore
Configuring Metrics Reporting
Service Discovery Configuration
Step 7. Encrypt the Configuration File
Step 8. Set the Environment Variables for the Azure IoT Hub Connector
Step 9. Run the Service to Grant Permissions and Visibility to the Connector
Step 10. Start the Azure IoT Hub Connector
Upgrading the Azure IoT Hub Connector
Upgrading the Azure IoT Hub Connector from 4.3.2 to 5.0.0
Troubleshooting Checkpoint Migration
Upgrade Archive
Upgrading the Azure IoT Hub Connector from 4.3.1 to 4.3.2
Upgrading the Azure IoT Hub Connector from 4.3.0 to 4.3.1
Upgrading the Azure IoT Hub Connector from 4.2.0 to 4.3.0
Upgrading the Azure IoT Hub Connector from 4.1.0 to 4.2.0
Upgrading the Azure IoT Hub Connector from 4.0.x to 4.1.x
Upgrading the Azure IoT Hub Connector from 3.0.0 to 4.0.0
Upgrading the Azure IoT Hub Connector from 2.0.x to 3.0.0
Running the Smoke Test
Smoke Test Step 1. Validate the Connection to ThingWorx Platform
Smoke Test Step 2. Validate Configuration
Smoke Test Step 3. Validate Connection Services Hub
Smoke Test Step 4. Create a Test Thing
Smoke Test Step 5. Send Updated Property Values to ThingWorx
Sample Output from the Smoke Test Tool
Smoke Test Cleanup
Troubleshooting the Smoke Test
Smoke Test Exception 1: SSL Handshake error due to missing intermediate/root certificates
Smoke Test Exception 2: SSL Handshake error when sending messages due to missing intermediate/root certificates
Missing Root or Intermediate Certificates
Smoke Test Exception 3: Timeout when attempt to connect to the ThingWorx Platform
Interacting with Azure Edge Devices through ThingWorx
Importing Device Information from an Azure IoT Hub
Using Azure IoT Device Management Services
Setting Up Azure IoT Device Lifecycle Events
Updating Properties
JSON Formatting to Update Properties
Using the Azure Blob Storage in ThingWorx
Using the File Upload Functionality of Azure with ThingWorx
Event for File Uploads from the Edge
Downloading Files to Azure IoT Devices
Using Azure Direct Methods from ThingWorx
Invoke Using the AzureIotInvokeRemoteService Service
Invoke Using a Remote Service
Invoke Using the AzureIotDeviceJobScheduleDeviceMethodJob Service
Running Azure IoT Device Jobs
Monitoring the Azure IoT Hub Connector
Fine-Tuning the Azure IoT Hub Connector
Metrics
Background Information on Metrics
Logging
Log Levels
Log Messages
Troubleshooting
SSLHandshake Exceptions When Connecting to ThingWorx Platform
Errors on Connector Startup
Error: Cannot find function GrantConnectorPermissions
Error: Failed to initialize Azure IoT Hub Connector due to invalid configuration
Error: Invalid service name: GetConfiguration
Error: Failed to start health check server. Address already in use.
Error: Unable to bootstrap required extensions
Error Entity PlatformSubsystem does not exist or is not yet associated with a Thing
Error: Unable to Invoke Service GetExtensionPackageList on PlatformSubsystem: Not authorized.
Error: The client could not finish the operation with specified maximum execution timeout.
Error Failed to initialize all the egress handlers: Shared Access KeyName cannot be null or empty
Error: Exception while initializing stores, not starting partition manager
Startup Error: DerInputStream.getLength(): lengthTag=109, too big
Troubleshooting Device-Related Issues
Scenarios: Device import fails or takes too long
Scenarios: Troubleshooting AzureIotThings
Errors Caused by Device Deleted or Missing in Azure IoT
Errors: No Thing Found for name {THINGNAME} / Entity {THINGNAME} does not exist or is not yet associated with a Thing
Troubleshooting Runtime Issues
Error: The messaging entity <badconsumergroup> could not be found. Connector fails to consume ingress
Scenario: Logback is configured and file created, but nothing is written to file.
Scenario: Subscription Not Firing for Event on an Azure IoT Thing
Troubleshooting Connectivity Issues
Internet Connectivity
What happens to updates sent during loss of connectivity between a Connector and a ThingWorx Platform?
Troubleshooting File Transfers
File Transfer Event error when repository-thing=name Thing does not exist or implements wrong Thing Shape
Error: Lost connection to File Notification Queue
Error: Error retrieving file-upload notification
Error: The client could not finish the operation within specified maximum execution timeout
Error: Failed to initialize Azure IoT Hub Connector due to invalid configuration (Azure Blob Thing)
Scenario: A Configuration Change Is Not Working
Error: Service has timed out
Error: Unable to invoke service on Connection Services Hub: No Things are connected to handle request for service <serviceName>
File Upload Notification Event Handler Shutting Down
Error: Transfer did not complete within 60000 ms
ThingWorx Connection Services Extension (CSE) Reference
CSE Thing Templates
ConnectionServicesHub Thing Template
ProtocolAdapter Thing Template
ProtocolAdapterWithAvailability Thing Template
CSE Thing Shapes
CacheManager Thing Shape
ProtocolAdapterWithAvailability Thing Shape
CSE Data Shapes
CXSEvent.AuthenticationError Data Shape
CXSEvent.ClearCacheEntry Data Shape
CXSEvent.EdgeError Data Shape
CXSEvent.FileNotFoundError Data Shape
CXSEvent.InternalError Data Shape
CXSEvent.ProtocolError Data Shape
CXSEvent.ThingNotFoundError Data Shape
CXSEvent_UserError Data Shape
CXSEvent.WritePropertyError Data Shape
ProtocolAdapterAvailability Data Shape
CSE Things
ConnectionServicesHub Thing
Azure IoT Extension (AIE) Reference
ThingWorx Azure IoT Thing Templates
AzureIotHubTemplate Thing Template
AzureIotThing Thing Template
AzureBlobStorageTemplate Thing Template
ThingWorx Azure IoT Data Shapes
AzureBlobDataShape
AzureServices Thing