ThingWorx Connection Services Support Matrix
  
ThingWorx Connection Services Support Matrix
This topic summarizes the requirements for configuring and deploying applications he ThingWorx Connection Server, ThingWorx Azure IoT Connector, and custom connectors developed using the ThingWorx Protocol Adapter Toolkit. It is intended for use by all ThingWorx customers and can be used to ensure system administrators understand system requirements for Connectors in their organizations. This topic provides hardware, operating systems, and software components suggested for use with the ThingWorx Connection Services.
Important! Only the ThingWorx Connection Server v.8.5.0, the ThingWorx Protocol Adapter Toolkit, v.1.5.1, and the ThingWorx Azure IoT Hub Connector v.3.0.0 have been certified with ThingWorx Platform 8.5.0. The older versions of the Azure IoT Hub Connector have NOT been certified with ThingWorx Platform, v.8.5.0. For information about the Azure IoT Hub Connector, v.3.0.0, refer to the ThingWorx Azure IoT Hub Connector Help Center on the PTC Support site.
Releases Covered in this Topic
ThingWorx Connection Server, v.7.2.x, v.8.2.x, v8.4.x, 8.5.0
ThingWorx Azure IoT Hub Connector, v.2.0.0, v.3.0.0
ThingWorx Protocol Adapter Toolkit, v.1.0.x, v. 1.1.2, v.1.5.0, v.1.5.1
Important! Versions 7.1 and later of ThingWorx Connection Server require a completely new installation. You cannot just perform an upgrade of the previous version. As such, these versions of the Connection Server require version 7.1 (at least) of ThingWorx Platform and are NOT compatible with previous versions of ThingWorx Platform.
General Requirements
ThingWorx Connection Services consist of the ThingWorx Connection Server, the ThingWorx Azure IoT Hub Connector, and the ThingWorx Protocol Adapter Toolkit. ThingWorx releases versioned updates to these products and certifies product quality through rigorous testing of these products with the ThingWorx Platform.
Software Requirements
The following table lists the software requirements for the ThingWorx Connection Services:
Software Requirements for ThingWorx Connection Services
Product
Java Version
Operating System
ThingWorx Extensions
ThingWorx Connection Server
Connection Server 8.5
1.8.0, u162 or later
Linux, 64-bit,
None
Connection Server 8.4
1.8.0, u162 or later
Linux, 64-bit
None
Connection Server 7.2, 8.2
1.8.0, u92 or later
Linux, 64-bit
None
Connection Server 7.1
1.8.0, u65 or later
Linux, 64-bit
None
ThingWorx Azure IoT Hub Connector
Azure IoT Hub Connector 3.0
1.8.0, u162 or later
Linux, 64-bit
Connection Services Extension (CSE) 1.5.5
AzureIotExtension 3.0
Azure IoT Hub Connector 2.0
1.8.0, u91 or later
Linux, 64-bit
Connection Services Extension (CSE) 1.4.0
AzureIotExtension 2.0
Azure IoT Hub Connector 1.0
1.8.0, u91 or later
Linux, 64-bit
Connection Services Extension (CSE) 1.0.3
AzureIotExtension 1.0
ThingWorx Protocol Adapter Toolkit
Protocol Adapter Toolkit, 1.5.1
1.8.0, u162 or later
Linux, 64-bit
Connection Services Extension (CSE) 1.5.6
Protocol Adapter Toolkit, 1.5.0
1.8.0, u162 or later
Linux, 64-bit
Connection Services Extension (CSE) 1.5.5
Protocol Adapter Toolkit, 1.1.2
1.8.0, u144 or later
Linux, 64-bit
Connection Services Extension (CSE) 1.5.1
Protocol Adapter Toolkit, 1.0
1.8.0, u92 or later
Linux, 64-bit
Connection Services Extension (CSE) 1.4.3
Compatibility with ThingWorx Platform
The following table shows the versions of ThingWorx Platform supported by each of these products. Note that none of them support v.7.10.x and earlier of ThingWorx Platform.
Compatibility with ThingWorx Platform
Product
Version
Compatible with ThingWorx Platform Releases
Connection Server
8.5
ThingWorx Platform 8.5.0
8.4
ThingWorx Platform 8.4.x and 8.5.0
8.2
ThingWorx Platform 8.2.x, 8.3.2, 8.4.x, and 8.5.0
7.2
ThingWorx Platform 7..2.x, 7.3.x, 7.4.x, 8.0.x, 8.1.x, 8.2.x, 8.3.2, 8.4.x,0
7.1
ThingWorx Platform 7.1.x, 7..2.x, 7.3.x, 7.4.x, 8.0.x, 8.1.x, 8.2.x, 8.3.2, 8.4.x
Azure IoT Hub Connector
3.0
ThingWorx Platform 8.5.0
2.0
ThingWorx Platform 7.4.x, 8.0.x, 8.1.x, 8.2.x, 8.3.2, and 8.4.x
1.0
ThingWorx Platform 7..2.x, 7.3.x, 7.4.x, 8.0.x, 8.1.x, 8.2.x, 8.3.2, and 8.4.x
Protocol Adapter Toolkit
1.5.1
ThingWorx Platform 8.2.x, 8.3.x, 8.4.x, and 8.5.0
1.5.0
ThingWorx Platform 8.2.x, 8.3.2, and 8.4.x
1.0.x, 1.1.2
ThingWorx Platform 8.0.x, 8.1.x,
* 
Due to PASSWORD-related changes in ThingWorx v.8.2.0 and later, the ReadPropertyMessage, WritePropertyMessage, and WritePropertiesMessage classes of the Protocol Adapter Toolkit (PAT) do not support properties that use the PASSWORD base type. If your model includes properties that use the PASSWORD base type and you need to read or write to these properties from your PAT-based Connector, you can accomplish this by writing services on the ThingWorx Platform.