Upgrading ThingWorx Flow
If the ThingWorx Flow installer detects a fresh installation of ThingWorx Flow on your machine, it guides you through an automated ThingWorx Flow upgrade. This automated upgrade process is supported from a fresh installation of ThingWorx Flow 8.5.x and later.
You cannot use this upgrade installer to upgrade from a fresh installation of 8.4.x. Even if you have manually upgraded ThingWorx Flow from a fresh installation of 8.4.x to an 8.5.x version, you cannot use this automated upgrade installer. In this case, you must migrate ThingWorx Flow.
 |
If you have installed ThingWorx Flow on Red Hat Enterprise Linux, and plan to upgrade to ThingWorx Flow 9.1 or 9.0.2 and later, then you must upgrade your RHEL version to 8.2 before you upgrade ThingWorx Flow.
|
ThingWorx Foundation Upgrade Considerations
From ThingWorx 9.3.5 and later and ThingWorx 9.2.9 and later, to upgrade ThingWorx Foundation that does not match a ThingWorx Flow version, follow these steps:
1. Upgrade ThingWorx Foundation and ThingWorx Flow to the same version.
2. Upgrade ThingWorx Foundation to the latest version.
For example, to upgrade ThingWorx Foundation to the 9.3.8 version, upgrade ThingWorx Foundation and ThingWorx Flow to the 9.3.7 version, and then upgrade ThingWorx Foundation to 9.3.8.
Prerequisites
Before you upgrade ThingWorx Flow, ensure that you meet the following prerequisites:
• Back up of your database. The installer does not perform a backup of the database.
• Note the ThingWorx Flow database login user name and password.
• Upgrade ThingWorx Foundation to the exact version that you are upgrading ThingWorx Flow.
• If you have ThingWorx Flow 8.5.0, 8.5.1, 8.5.2, or 8.5.3, run the ThingWorx Upgrade Ready Utility.
• If you had installed ThingWorx Flow 8.5.0, 8.5.1, 8.5.2, or 8.5.3 on a different machine than ThingWorx Foundation, copy the ThingWorxFoundation.xml file from the following location in the ThingWorx Foundation machine to the same location in the ThingWorx Flow machine.
Windows: <Path to Users\username folder>\.ptc_ccif\ThingWorxFoundation.xml
Linux: ~/.ptc_ccif/ThingWorxFoundation.xml
• Your ThingWorx Flow installation folder should not be in use by any application, except ThingWorx Flow services.
Download the Installer
Download the appropriate ThingWorx Flow installer according to your operating system and database combination from the PTC Support Site.
• ThingWorx Flow installers for PostgreSQL— > > > > > .
• ThingWorx Flow installers for Microsoft SQL Server— > > > > > .
The installer for installing ThingWorx Flow and upgrading ThingWorx Flow is the same. The installer detects whether you are performing a fresh installation of ThingWorx Flow or upgrading ThingWorx Flow.
Upgrade Process
According to your database, use the ThingWorx Flow for PostgreSQL Installer or ThingWorx Flow for MSSQL Installer to upgrade ThingWorx Flow on your operating system.
|
|
Before upgrading, note the following points:
• On Windows, it is recommended that you disable your antivirus temporarily during ThingWorx Flow installation.
• On Red Hat Enterprise Linux, before you start installing ThingWorx Flow, verify that the releasever file does not exist under the /etc/yum/vars directory. If the releasever file exists, remove the file. If you need to use this file later, you can copy the file to the /etc/yum/vars directory after you finish ThingWorx Flow installation.
|
Open the installation tool
1. Log in to the system where you want to install ThingWorx Flow as administrator.
2. According to the installation package that you downloaded, unzip the download and then open the installer file.
For Windows, run the installation tool as administrator.
For Linux, run the installation tool with the root user.
Welcome to ThingWorx Flow
Once the installer detects that you are upgrading ThingWorx Flow, click Next.
Getting ready to upgrade
Click Next once you are sure that you have set all prerequisites required for the upgrade.
PostgreSQL Connection Information/ SQL Server Connection Information
1. To connect to your existing ThingWorx Flow database, enter the following details:
▪ ThingWorx Flow Database Login Username—Enter the user name of the PostgreSQL/ SQL Server database owner.
▪ ThingWorx Flow Database Login Password—Enter the password of the PostgreSQL/ SQL Server database owner.
2. Click Next.
(Optional) Deploy Custom Connectors
1. Select the Deploy Custom Connectors check box.
2. In the Path to root directory of custom connector, provide the root directory path of your custom connector, or if you have multiple custom connectors, provide their parent folder.
Installation Information
This screen provides information about your existing ThingWorx Flow installation.
1. Review the information about your existing installation.
2. If you need to change anything, click Back. When you are ready, click Next.
Begin Upgrade
This screen provides information about your ThingWorx Flow upgrade.
1. Review the information about your upgrade.
2. If you need to change anything, click Back. When you are ready, click Next.
The entire setup takes about 20 minutes depending on the host hardware configuration.
|
|
During the final stages of upgrade, a console window is launched. Do not close or right-click the console window. The window closes automatically after the upgrade is complete.
|
3. Click Finish to close the installation window.
You have successfully upgraded ThingWorx Flow.
Verification and Testing
• To verify that ThingWorx Flow is upgraded correctly, start Command Prompt as administrator and execute the following command:
pm2 ls
The status of the following ThingWorx Flow components must be ‘online’:
◦ flow-api
◦ flow-engine
◦ flow-exchange
◦ flow-lookup
◦ flow-oauth-server
◦ flow-trigger
• Verify that RabbitMQ/ rabbitmq.service, ThingWorx-Foundation, thingworxflow.exe/ ThingWorx-Flow and ThingWorxFlowNginx/ nginx services are running.
• Test functionality in ThingWorx Foundation and ThingWorx Flow to verify that they are working as expected. Verify that you can compose workflows in ThingWorx Composer and the Workflow Editor. For example, you can perform the following tasks:
◦ Log in to the ThingWorx Flow dashboard. To know how to access ThingWorx Flow and ThingWorx Composer, see Accessing ThingWorx Flow and ThingWorx Composer.
◦ Create connectors for every service or utility that you want to use.
◦ Create and test a trigger in the workflow, if required.
Troubleshooting
If you face any issues during or after upgrading ThingWorx Flow, see Troubleshooting your installation.