Prepare for Migration Upgrade
Before we start the upgrade, prepare your system for upgrade and export files from the source system. Follow the steps below. Make sure that you are not using the New Composer user interface in ThingWorx Composer:
Update the configuration manager extension
1. First, remove the extension for configuration management. In ThingWorx Composer, click Import/Export, and under EXTENSIONS, click Manage.
2. Select thingworx-navigate-configuration-manager, and then click Delete Extension.
3. Restart Apache Tomcat.
4. Next, import the ThingWorx Navigate extension for configuration management from ThingWorx-Navigate-Upgrade-<version>-bundle.zip.
5. In ThingWorx Composer, click > > .
6. In the Import Extensions window, click Browse and select thingworx-navigate-configuration-manager-<version>.zip.
7. Click Import.
Export All Non-Navigate Entities
Next, we’ll export all entities from ThingWorx:
1. In ThingWorx Composer, go to Things.
2. Search for DataConfigurationAPI.
3. Click View.
4. Under Entity Information, select Services.
5. For ExportEntities, click Test. The ExportEntities - Test Service window opens.
6. Click Execute Service. A success message appears, and the entities are exported to this location:
<Installation location>\ThingWorxStorage\repository\NavigateFileRepository\
7. Backup the files you exported: save them in a different location.
Back up your custom tasks
If you have custom tasks that were built by modifying out-of-the-box
ThingWorx Navigate extensions, make backups, so you can redeploy them after the upgrade. This prevents overwriting of these custom tasks during the upgrade process. For more information, see
ThingWorx Extension Development Guide.
Export the Configuration
Export your ThingWorx Navigate configuration from the source system. You will need to import them into the target system later.
To export the file to ThingWorx complete the following steps:
1. In ThingWorx Composer go to Things.
2. Search for DataConfigurationAPI.
3. Click View.
4. Under Entity Information, click Services.
5. Click Test on ExportDataToFile.
6. Under fileName enter the name of the JSON file for storing the exported configuration.
7. Click Execute Service. The message, Export Completed Successfully, appears. The exported file is saved to the default location: \ThingworxStorage\repository\NavigateFileRepository\
8. Backup the files you exported: save them in a different location.