Upgrading ThingWorx High Availability Clustering
Upgrading from a Single Server to a ThingWorx High Availability Cluster
If you want to upgrade your ThingWorx single-server instance to operate in a high availability environment in cluster mode after you upgrade to ThingWorx 9.x.x, see Overview of ThingWorx High Availability Clustering for configuration details.
Upgrading from an Earlier ThingWorx 9.x.x Version of ThingWorx High Availability Clustering
If you are upgrading from an earlier ThingWorx high availability cluster to a newer version of high availability clustering, use the following tables to determine which type of upgrade you can perform:
 |
Before upgrading ThingWorx High Availability Clustering, refer to Release Advisor to determine if a specific upgrade version is supported.
|
|
To ThingWorx 9.0.1
|
To ThingWorx 9.0.2
|
To ThingWorx 9.0.3
|
To ThingWorx 9.0.4
|
To ThingWorx 9.0.5
|
To ThingWorx 9.0.6
|
To ThingWorx 9.0.7
|
To ThingWorx 9.0.8
|
To ThingWorx 9.0.9
|
To ThingWorx 9.0.10
|
To ThingWorx 9.0.11
|
To ThingWorx 9.0.12
|
To ThingWorx 9.0.13
|
To ThingWorx 9.0.14
|
To ThingWorx 9.0.15
|
|
|
From ThingWorx 9.0.0
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.1
|
N/A
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.2
|
N/A
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.3
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.4
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.5
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.6
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.7
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.8
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.9
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.10
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.11
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.12
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.13
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.0.14
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling
|
|
From ThingWorx 9.0.15
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
|
From ThingWorx 9.0.16
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
|
From ThingWorx 9.0.817
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
|
To ThingWorx 9.1.0
|
To ThingWorx 9.1.1
|
To ThingWorx 9.1.2
|
To ThingWorx 9.1.3
|
To ThingWorx 9.1.4
|
To ThingWorx 9.1.5
|
To ThingWorx 9.1.6
|
To ThingWorx 9.1.7
|
To ThingWorx 9.1.8
|
To ThingWorx 9.1.9
|
To ThingWorx 9.1.10
|
|
|
From ThingWorx 9.0.x
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.0
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.1
|
N/A
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.2
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.3
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.4
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.5
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.6
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.7
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.8
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.9
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Full cluster upgrade
|
|
From ThingWorx 9.1.10
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
|
To ThingWorx 9.2.0
|
To ThingWorx 9.2.1
|
To ThingWorx 9.2.2
|
To ThingWorx 9.2.3
|
To ThingWorx 9.2.4
|
To ThingWorx 9.2.5
|
To ThingWorx 9.2.6
|
|
|
From ThingWorx 9.0.x
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.x
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.2.0
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.2.1
|
N/A
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.2.2
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.2.3
|
N/A
|
N/A
|
N/A
|
N/A
|
Rolling upgrade
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.2.4
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.2.5
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
Full cluster upgrade
|
|
From Thingworx 9.2.6
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
N/A
|
|
To ThingWorx 9.3.0
|
To ThingWorx 9.3.1
|
|
|
From ThingWorx 9.0.x
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From ThingWorx 9.1.x
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.2.x
|
Full cluster upgrade
|
Full cluster upgrade
|
|
From Thingworx 9.3.0
|
N/A
|
Full cluster upgrade
|
|
From Thingworx 9.3.1
|
N/A
|
N/A
|
• Full cluster upgrade
First, determine if the above matrix supports a full cluster upgrade for your from/to versions.
Then, you must perform a full cluster upgrade if either of the following is true:
◦ There are changes to the data classes used by Apache Ignite, which can cause hydration issues when reading data from the cache.
◦ Data migration is required. Therefore, old systems may not be able to access certain data.
To perform a full cluster upgrade, do the following:
1. Stop all ThingWorx servers.
Allow the servers to shut down completely and drain their data queues.
2. Shut down all Ignite servers.
3. Once the Ignite cluster is shut down, perform the required data migration and schema changes to the persistence provider database(s). For more information, see the Upgrading ThingWorx section.
4. Restart Ignite. For more information, see Installing and Configuring Ignite for ThingWorx HA.
5. Upgrade or migrate the ThingWorx servers as appropriate. For more information, see the Upgrading ThingWorx section.
6. Restart the ThingWorx servers
• Rolling upgrade
If the above matrix supports a rolling upgrade for your from/to versions and the above points under the Full cluster upgrade section are not true, you can perform a rolling upgrade. A rolling upgrade allows you to keep the cluster running and take only one server offline at a time.
To perform a rolling upgrade, do the following:
1. Stop one of the ThingWorx servers in the cluster, allowing it to shut down completely and drain its data queue.
2. After the ThingWorx server has been shut down; upgrade the server to ThingWorx 9.x.x. For more information, see the Upgrading ThingWorx section.
3. Restart the upgraded ThingWorx server.
4. Repeat the upgrade and restart steps for each ThingWorx server in the cluster.