This topic summarizes the requirements for configuring and deploying each ThingWorx Connection Service:

This topic intended for use by all ThingWorx customers and can be used to ensure system administrators understand system requirements for ThingWorx Connection Services in their organizations. This topic provides hardware, operating systems, and software components recommended for use with the Connection Services. It also provides a compatibility matrix for currently supported versions of ThingWorx Platform.

In the Software Downloads portal, PTC provides a version of each ThingWorx Connection Service that is the latest and works with the currently supported versions of ThingWorx Platform. PTC always fixes issues in the latest version of each Connection Service and replaces the older versions with the newer ones on the Software Downloads portal. This way, there is always one Connection Service version available for use with currently supported versions of the ThingWorx Platform. Unless otherwise stated, a new version is backward compatible with the versions of the platform supported by the replaced version of the Connection Service.

For example, suppose you downloaded the previous version of a Connection Service, for example, Connection Server v.8.5.x for ThingWorx Platform v.8.5.3. The Connection Server v.8.5.3 goes out of support when an updated version of the Connection Server, for example, v.8.5.4, is released.. The new 8.5.4 version replaces the v.8.5.3 Connection Server for each supported ThingWorx Platform version on the Software Downloads portal. Similarly, when version 9.0.0 is released, it replaces the 8.5.x version for each supported ThingWorx Platform. The ThingWorx Connection Server, v.9.2.0 works with ThingWorx Platform versions 8.5.2 and later, 9.0.x, 9.1.x, and 9.2.x.

If incompatibilities with previous releases of ThingWorx Platform exist for any version of the Connection Services, PTC maintains more than one branch of the same Connection Service for the life of the corresponding ThingWorx Platform.

For example, the Azure IoT Hub Connector v.3.0.x will be maintained and updated as an old line of that Connector for the life of ThingWorx Platform version 8.5.x. Fixes will be made available only in the v.4.1.x line of the Connector to support ThingWorx Platform v. 9.0.x, v.9.1.x, and v.9.2.x. Due to backward incompatibilities, you must use Azure IoT Hub Connector v.3.0.x with v.8.5.x of the ThingWorx Platform and v.4.1.x with ThingWorx Platform versions 9.0.x and 9.1.x.

ThingWorx Connection Services consist of the ThingWorx Connection Server, the ThingWorx Azure IoT Hub Connector, and the ThingWorx eMessage Connector. ThingWorx releases versioned updates to these products and certifies product quality through rigorous testing of these products with the ThingWorx Platform.

While the ThingWorx Connection Server and ThingWorx Azure IoT Hub Connector are delivered in their own distribution bundles, the ThingWorx eMessage Connector is delivered within the ThingWorx Axeda Compatibility Package.

For the Connection Server, refer to the ThingWorx Connection Services Help Center.

For the eMessage Connector, refer to version 2 of the help center for the Axeda Compatibility Package for complete information about the eMessage Connector v.2.0.x and v.2.1.x and to the version 1 help center for information about the eMessage Connector v.1.2.x, 1.3.x, and 1.4.x.

For the Azure IoT Hub Connector, refer to version 3 of the ThingWorx Azure IoT Hub Connector help center for complete information about the Azure IoT Hub Connector v.3.0.x, and to version 4 of the help center for information about the Azure IoT Hub Connector v.4.1.x.

The following table lists the software requirements for the ThingWorx Connection Services.

For the most part, the latest version of a Connection Service supports the current version of ThingWorx Platform as well as the previous versions of the platform that are still under standard PTC Support. For example, the ThingWorx Connection Server v.9.2.x supports ThingWorx Platform v.8.5.x, v.9.0.x, v.9.1.x, and v.9.2.x. However, for the ThingWorx Azure IoT Hub Connector, you must use v3.0.x with ThingWorx Platform v.8.5.x, and v.4.1.x with ThingWorx Platform 9.0.x and 9.1.x. Similarly, for the eMessage Connector, you must use v.1.2.x with version 8.5.x of the ThingWorx Platform, and v.2.1.x with v.9.1.x of the ThingWorx Platform.

The following table shows the versions of ThingWorx Platform supported by each of these products. Note that v.8.4.x, v.8.5.x, and v.9.0.x of the ThingWorx Connection Server are no longer supported. You must download and install the latest version.

If you navigated to this support matrix from a ThingWorx Axeda Compatibility Package or a ThingWorx Azure IoT Hub Connector Help Center, use the appropriate link in the table below to return to that help center.