Upgrading to ThingWorx Navigate 8.5.8
Follow the steps in this topic for upgrading to ThingWorx Navigate 8.5.8 from any of the following versions: 8.5.0, 8.5.1, and 8.5.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 Apache Tomcat and Integration Runtime for your current ThingWorx Navigate version.
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
Install a PTC Windchill Patch. Alternatively, you can update the Windchill CPS compatible with the
ThingWorx Navigate version you want to upgrade to.
4. Update
ThingWorx: Follow the upgrade instructions in the section “Maintenance Release/Service Pack Upgrade Process” in the
Upgrading to ThingWorx 8.5 guide.
5. Now, remove the existing configuration management extension using the following steps:
a. In
ThingWorx Composer, click
Manage, and then click
EXTENSIONS.
b. Select
thingworx-navigate-configuration-manager, and then click
.
c. Restart Apache Tomcat.
6. From the
PTC Software Download page, download
ThingWorx-Navigate-Release-<version>-bundle.zip. See detailed download instructions below:
a. Select PTC SMART CONNECTED APPLICATIONS and then expand Release APPs, ThingWorx Navigate 8.5, and Most Recent Datecode.
b. Select ThingWorx-Navigate-Release-<version>-bundle.zip and extract the bundle.
7. In ThingWorx Composer, import the thingworx-navigate-configuration-manager-upgrade8_5.zip file from the upgrade folder of the extracted bundle using the following steps:
a. In ThingWorx Composer, click > .
b. In the Import window, select Extension from the Import Option list.
c. In the File Name field, click Browse and select thingworx-navigate-configuration-manager-upgrade8_5.zip.
d. Click Import.
8. Clear Apache Tomcat cache and restart Apache Tomcat.
9. Execute the PrepareForUpgrade service using the following steps:
a. In ThingWorx Composer, search for DataConfigurationAPI, and then open it. The General Information page opens.
b. Click Services.
c. For PrepareForUpgrade, click Execute service. The Execute Service: PrepareForUpgrade window opens.
d. Click Execute.
e. Restart Apache Tomcat.
10. In ThingWorx Composer, import the PTCNavigate_All-<version>-all_inclusive_bundle.zip extension from the extracted bundle using the following steps:
a. In ThingWorx Composer, click > .
b. In the Import window, select Extension from the Import Option list.
c. In the File Name field, click Browse and select PTCNavigate_All-<version>-all_inclusive_bundle.zip.
d. Click Import.
11. Restart Apache Tomcat.
12. Execute the PostUpgradeConfiguration service using the following steps:
a. In ThingWorx Composer, search for DataConfigurationAPI, and then open it. The General Information page opens.
b. Click Services.
c. For PostUpgradeConfiguration, click Execute service. The Execute Service: PostUpgradeConfiguration window opens.
d. Click Execute.
e. Restart Apache Tomcat.
13. Extract Integration Runtime from the upgrade folder and then perform the following steps:
a. Stop Integration Runtime.
b. Copy integration-runtime-8.0.7-b870.jar to the integration-runtime folder of your ThingWorx Navigate installation.
c. Back up your existing integration-runtime-<version>.jar (source version) and then rename it.
d. Now, rename the copied integration-runtime-8.0.7-b870.jar to integration-runtime-<version>.jar (source version).
▪ If you are upgrading from ThingWorx Navigate 8.5.0, rename this file to integration-runtime-8.0.5-b651.jar.
▪ If you are upgrading from ThingWorx Navigate 8.5.1 or 8.5.3, rename this file to integration-runtime-8.0.6-b676.jar.
e. Start Integration Runtime.
14. 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.
| If you are updating to Windchill 11.2.1.4, ensure your Windchill administrator has configured a whitelist property for URL redirects. If this property is not configured, you will not be able to access ThingWorx Navigate. See this technical support article for more information on this issue. |
You have successfully upgraded ThingWorx Navigate. Time to get started using the new version.
| Configuration settings from your previous ThingWorx Navigate version are automatically preserved. If you wish to make any changes to the configuration, see the following information: • If you installed ThingWorx Navigate using the installer, extract the ThingWorxNavigateConfigurator-8.5.8.zip from the upgrade folder of the release bundle, copy the configurator and place it in the NavigateConfigurator folder of your installation location, and then run the configurator. |