Maintenance Release Upgrade

Follow the steps in this topic to upgrade to a maintenance release (for example, 1.6.1 to 1.6.2, 1.6.2 to 1.6.3, or 1.6.1 to 1.6.3).

1. Back up custom tasks: If you have custom tasks that were built by modifying ThingWorx Navigate out-of-the-box 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.

2. Stop the Integration Runtime of your current version of ThingWorx Navigate.

3. On your Windchill version, install the Enablement patch compatible with the maintenance release version of ThingWorx Navigate you want to upgrade to. For more information, see the “Install PTC Windchill Patches” section in Import ThingWorx Navigate related extensions.

4. Update ThingWorx: Follow the upgrade instructions in the section “Maintenance Release/Service Pack Upgrade Process” in the Upgrading to ThingWorx 8.3 guide.

5. Define allowable file download types in the <installation directory>\ThingworxPlatform\platform-settings.json file. Refer to Set File Download Types for details.

6. From the PTC Software Download page, download ThingWorx-Navigate-Upgrade-<version>-bundle.zip. See detailed download instructions below:

a. Select PTC SMART CONNECTED APPLICATIONS and then expand Release APPs, ThingWorx Navigate 1.8, and Most Recent Datecode.

b. Select ThingWorx-Navigate-Upgrade-<version>-bundle.zip and extract the bundle.

7. In ThingWorx Composer, import the extensions listed below. Refer to the Platform Support Matrix for extensions compatible with the maintenance release version you want to upgrade to.

See the note below describing files not to import. You can skip importing extensions you already installed and ignore warning messages that may appear.

◦ Existing extensions: ptc-windchill-extension, ptc-navigate-framework-extension, and ptc-windchill-extension are overwritten.

◦ Configuration settings and tailoring from the previous version of ThingWorx Navigate are preserved in the upgrade process.

• You do not need to import ThingWorx-Navigate-Example-<version>.xml because it is the same as in the ThingWorx Navigate version you upgraded from. If you import it, it overwrites the connector configurations and the tailoring, and you will need to configure the integration connector again.

• You do not need to import the file ptc-sample-mashup-<version>.xml.

9. Start Integration runtime. Check the Platform Support Matrix for the version of Integration Runtime to use.

10. Redeploy your custom tasks: If you have custom tasks built by modifying ThingWorx Navigate out-of-the-box extensions, reimport those custom tasks you backed up earlier.

11. If you selected the Windchill authentication method, a few extra configuration steps are required. The steps are in the section “Add servlet filters to the Apache Tomcat configuration” in Required Configuration Steps for Windchill Authentication.

You have successfully upgraded ThingWorx Navigate. Time to get started using the new version.