Backup and Restore Instructions for ThingWorx Flow Using the Installer
Follow the instructions below to back up and restore installed ThingWorx Flow using installer.
Back up
Follow the instructions below to backup ThingWorx Flow application:
1. Write and save the following information at an accessible location:
a. The latest version number of your installed or upgraded ThingWorx Flow.
b. All parameters set via the installer:
i. The installation location (ThingWorx Flow root directory)
ii. ThingWorx Flow hostname and port ( for example, if you point to LB or a local machine)
iii. ThingWorx Foundation host name and port
c. Database credentials details such as the database host name, port, username and password, schema (in case of MSSQL)
2. Back up the entire ThingWorx Flow root directory to a safe location (you can zip the files, if needed).
 |
In Linux, make sure all permissions are stored in the backup.
|
3. Back up the ThingWorx Flow database from the PostgreSQL or MSSQL.
4. Find the nginx installation location (/etc/nginx on Linux, C:\Program Files\nginx-<version no> on Windows) and backup the vhost-flow.conf configuration file located under conf.d folder.
5. If you changed the rabbitmq configurations, back up definitions.json and rabbitmq.config:
◦ /etc/rabbitmq on Linux
◦ <root installation dir>\modules\rabbitmq on Windows
6. Back up the platform-settings.json located in the ThingWorx Foundation installation folder under the ThingworxPlatform folder
7. Back up the keystore.pfx file located in the ThingWorx Foundation installation folder under the ThingworxStorage folder
Restore
Prerequisite
1. Validate that ThingWorx Foundation must be up and running.
2. This process assumes that you do not have a current ThingWorx Flow installation. Otherwise, the installer will identify your new installation as an upgrade. In such case, uninstall the faulty installation.
3. Download and install the same version of ThingWorx Flow to the same root directory using the same input used for the first installation.
During the installation, set the same host name as the one set in the first installation.
Make sure you follow all installation instructions, including prerequisites, mentioned in help center.
Skip “Verification and Testing” in the installation documentation. This activity will be performed after ThingWorx Flow is restored.
4. Stop Nginx, RabbitMQ, and ThingWorx Flow services
5. Delete the root installation directory, and replace with the backup directory. In Linux, make sure all permissions are set as stored in the backup. In Windows, in the Security tab under the folder properties, make sure that ThingWorx Flow folder has NETWORK SERVICE as a group in the Groups or usernames section with Full control permissions. Add the group and the permissions, if necessary.
6. Remove the ThingWorx Flow database & schemas created manually as part of the prerequisite installation process, and restore the backup database and schemas.
7. Copy the backup configuration files (vhost-flow, RabbitMQ configurations and the platform-settings on the ThingWorx Foundation installation). It is recommended to compare the files first. If no manual changes were made, files must be the same.
8. Copy the keystore.pfx file in the ThingWorx Foundation folder.
9. Start the services stopped in Step 2.
10. Restart ThingWorx Foundation service.