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:
Update the configuration manager extension
Upgrading ThingWorx Navigate from 1.6.x and 1.7.x to 1.9
1. First, remove the extension for configuration management. In
ThingWorx Composer, click
Manage, and then click
EXTENSIONS. The
Manage Extensions page opens.
2. Select
thingworx-navigate-configuration-manager, and then under
Actions, click
to delete the extension.
3. Restart Apache Tomcat.
4. Next, import the ThingWorx Navigate extension for configuration management from ThingWorx-Navigate-Upgrade-<version>-bundle.zip of Navigate 1.9.
5. In ThingWorx Composer, click > > .
6. In the Import Extensions window, click Browse and select thingworx-navigate-configuration-manager-<version>.zip.
7. Click Import.
Upgrading ThingWorx Navigate from 1.8.x to 1.9
1. When the thingworx-navigate-configuration-manager.zip already exists on the source server, there is no need to remove it.
2. When the thingworx-navigate-configuration-manager.zip is not on the source server, follow the steps below:
b. Expand Release APPS, ThingWorx Navigate 1.9, and Most Recent Datecode.
c. Download the ThingWorx-Navigate-Upgrade-<version>-bundle.zip and extract it.
d. In ThingWorx Composer, click > > .
e. In the Import Extensions window, click Browse and select thingworx-navigate-configuration-manager-<version>.zip.
f. 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, click
Browse, and then under
MODELING, click
Things.
2. Search for DataConfigurationAPI and click to open it.
3. Click Services. The services open.
4. For
ExportDataToFile, under
Execute, click
to execute the service.
5. Under fileName enter the name of the JSON file where you’ll store the exported configuration.
6. Click Execute. A confirmation message appears, and the exported file is saved to this 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.9, import PrepareForUpgrade_Navigate-1_6_1.xml from the ThingWorx-Navigate-Upgrade-<version>-bundle.zip of ThingWorx Navigate 1.9 build.
• To upgrade from ThingWorx Navigate 1.6.0, 1.7.x, or 1.8.x, you don’t need to import any XML files.