Get ready for the in-place upgrade
Before we start the upgrade, export files from the source system and prepare your system for upgrade. 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.
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 configurations
Export your ThingWorx Navigate configuration from the source system. You will need to import the configuration 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, and open to edit.
3. Under Entity Information, click Services.
4. Click Test on ExportDataToFile.
5. Under fileName enter the name of the JSON file for storing the exported configuration.
6. Click Execute Service. The message Export Completed Successfully appears. The exported file is saved to the default location: \ThingworxStorage\repository\NavigateFileRepository\.
Prepare the system for upgrade
Import the file for the latest release to prepare the system for upgrade.
• To upgrade from ThingWorx Navigate 1.6.1 to ThingWorx Navigate 1.8, import PrepareForUpgrade_Navigate-1_6_1.xml from the ThingWorx-Navigate-Upgrade-<version>-bundle.zip of ThingWorx Navigate 1.8 build.
• To upgrade from ThingWorx Navigate 1.6.0 or 1.7.x, you don’t need to import any xml files.