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.
Update the configuration manager extension
• Upgrading from ThingWorx Navigate 1.6.x and 1.7.x to 8.5.x
|
|
Upgrading from ThingWorx Navigate 1.6.x and 1.7.x to 8.5.8 is not supported. You can only upgrade to ThingWorx Navigate 8.5.0, 8.5.1, and 8.5.3 from these versions. Refer to the ThingWorx Navigate Upgrade Support Matrix to determine supported upgrade paths. |
Import the ThingWorx Navigate extension for configuration management from the upgrade folder of the extracted ThingWorx-Navigate-Release-<version>-bundle.zip using the following steps:
1. In ThingWorx Composer, click > .
2. In the Import window, click Browse and select thingworx-navigate-configuration-manager-upgrade<version>.zip.
3. Click Import.
• Upgrading from ThingWorx Navigate 1.8.x and 1.9.x to 8.5.x
1. First, remove the extension for configuration management. In
ThingWorx Composer, click
Manage, and then click
EXTENSIONS.
2. Select
thingworx-navigate-configuration-manager, and then click
.
3. Restart Apache Tomcat.
4. Now, import the ThingWorx Navigate extension for configuration management from the upgrade folder of the extracted ThingWorx-Navigate-Release-<version>-bundle.zip using the following steps:
a. In ThingWorx Composer, click > .
b. In the Import window, click Browse and select thingworx-navigate-configuration-manager-upgrade<version>.zip.
c. Click Import.
Export all non-Navigate entities
Next, we’ll export all entities from ThingWorx:
1. In ThingWorx Composer, search for and open DataConfigurationAPI. The General Information page opens.
2. Click Services.
3. For ExportEntities, click Execute service. The Execute Service: ExportEntities window opens.
4. For Inputs, under filename, enter a name for the file storing the exported entities.
5. Click Execute. A success message appears, and the entities are exported at this location: <Installation location>\ThingWorxStorage\repository\NavigateFileRepository\.
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, search for and open DataConfigurationAPI. The General Information page opens.
2. Click Services.
3. For ExportDataToFile, click Execute service. The Execute Service: ExportDataToFile window opens.
4. For Inputs, under filename, enter a name for the file storing the exported configuration.
5. Click Execute. A success message appears, and the entities are exported at this location: <Installation location>\ThingWorxStorage\repository\NavigateFileRepository\.
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.
Back up and uninstall existing ThingWorx Navigate
If you installed your existing ThingWorx Navigate using the installer, before performing a migration upgrade on the same system, back up and uninstall existing ThingWorx Navigate using the following steps:
| It is not required to uninstall your existing ThingWorx Navigate if you are performing a migration upgrade on a different system. |
1. Back up the following folders:
◦ ThingworxPlatform
◦ ThingworxStorage
◦ <Tomcat Home>\webapps\Thingworx
