Upgrading to ThingWorx Navigate 8.5.1
Follow the steps in this topic to upgrade to a maintenance release of ThingWorx Navigate (for example, 8.5.0 to 8.5.1).
|
Before you begin with the upgrade, note your existing OData Connector configuration details as they will not be retained after the upgrade.
|
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 Tomcat for 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
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. 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.
6. In ThingWorx Composer, import the PrepareForUpgrade_Navigate-8_5_0.xml file from the upgrade folder of the extracted bundle.
7. In ThingWorx Composer, import the PTCNavigate_All-<version>-all_inclusive_bundle.zip extension from the extracted bundle.
See the note below describing files not to import. You can ignore warning messages that may appear.
The following occurs after installing these extensions:
◦ Existing ptc-windchill-extension, ptc-navigate-framework-extension, and ThingWorx-Navigate-View-PLM-App-Extension-Bundle are overwritten.
◦ Configuration settings and tailoring from the previous version of ThingWorx Navigate are preserved in the upgrade process.
◦ Configuration settings and tailoring from the OData Connector are not retained; they need to be configured manually, as described in step 12.
|
• 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 will overwrite the connector configurations and tailoring, and you will need to configure the integration connector again.
• You do not need to import the file ptc-sample-mashup-<version>.xml.
|
8. Clear Tomcat cache and restart Tomcat for ThingWorx Navigate.
9. Extract the Integration Runtime from the upgrade folder and then perform the following steps:
◦ Stop Integration Runtime.
◦ Copy integration-runtime-8.0.6-b676.jar to the integration-runtime folder of your ThingWorx Navigate installation.
◦ Back up your existing integration-runtime-8.0.5-b651.jar and then rename it.
◦ Now, rename the copied integration-runtime-8.0.6-b676.jar to integration-runtime-8.0.5-b651.jar.
◦ Start Integration Runtime.
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.
You have successfully upgraded ThingWorx Navigate. Time to get started using the new version.