Welcome to ThingWorx Azure IoT Hub Connector 3 Help Center
What's New in This Help Center
ThingWorx Azure IoT Hub Connector Release Notes, v. 3.0.2
ThingWorx Azure IoT Hub Connector Release Notes, v. 3.0.1
ThingWorx Azure IoT Hub Connector Release Notes, v. 3.0.0
ThingWorx Azure IoT Hub Connector Release Notes, v. 2.0.0
ThingWorx Azure IoT Hub Connector
Features of the ThingWorx - Azure IoT Integration
What is the ThingWorx Azure IoT Hub Connector?
Azure IoT Hub Connector — Device Twin Support
Azure IoT Edge Module Twin
Security and the Azure IoT Hub Connector
Upgrading the Azure IoT Hub Connector from v.2.0.x to 3.0.0
Connecting an Azure IoT Hub Connector and an eMessage Connector to the Same ThingWorx Platform
Getting an Azure IoT Hub Connector Up and Running
Step 1. Create and Configure Items in Azure IoT
Step 2. Download and Install 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
Configuring Metrics Reporting
Creating a TrustStore
Step 7. Set Up Encryption for Azure IoT Hub Credentials
Step 8. Encrypt the Configuration File
Step 9. Set the Environment Variables for the Azure IoT Hub Connector
Step 10. Run the Service to Grant Permissions and Visibility to the Connector
Step 11. Start the Azure IoT Hub Connector
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
Using the Demo Applications
Edge Device Demo Client
Device Twin Demo — Change Events
Appliance Demo
Device Jobs Demo
Firmware Demo
Interacting with Azure Edge Devices through ThingWorx
Importing Device Information from an Azure IoT Hub
Setting Up Azure IoT Device Lifecycle Events
Updating 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 Device Methods from ThingWorx
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
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 Failed to initialize all the egress handlers: Shared Access KeyName cannot be null or empty
Error: Exception while initializing stores, not starting partition manager
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
Troubleshooting Runtime Issues
Error: The messaging entity <badconsumergroup> could not be found. Connector fails to consume ingress
Errors: No Thing Found for name {THINGNAME} / Entity {THINGNAME} does not exist or is not yet associated with a Thing
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
Error: Entity <name> does not exist or is not yet associated with a Thing
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>
Error: Transfer did not complete within 60000 ms
ThingWorx Azure IoT Extension Reference
ThingWorx Azure IoT Thing Templates
AzureIotHubTemplate Thing Template
AzureIotThing Thing Template
AzureBlobStorageTemplate Thing Template
ThingWorx Azure IoT Data Shapes
AzureBlobDataShape
AzureServices Thing
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
ConnectionServicesHub Thing
ProtocolAdapterSubsystem
Welcome to ThingWorx Azure IoT Hub Connector 3 Help Center
ProtocolAdapterSubsystem
This site works best with JavaScript enabled