Upgrade ThingWorx Navigate > In-Place Upgrade
  
In-Place Upgrade
The in-place upgrade path is only applicable for upgrading from ThingWorx Navigate versions 9.1, 9.0, and 8.5.x installed using the installer. The ThingWorx Navigate Setup tool identifies your previous ThingWorx Navigate installation and guides you through the upgrade.
* 
If you installed ThingWorx Navigate manually (without using the installer), migrate your ThingWorx Navigate to an instance that is installed using the installer. This will enable future in-place upgrades.
Before you begin with the upgrade, ensure that you have completed the steps in this topic.
Prepare for In-Place Upgrade
Before you begin upgrading, back up your custom tasks and save a copy of any changes you made to the deny list, formerly known as the blacklist. The sections that follow provide instructions for performing these steps.
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 Best Practices for Developing Solutions in the ThingWorx Help Center.
If you are upgrading from ThingWorx Navigate 9.0 and 9.1, your custom tasks that were created using components will be automatically upgraded. It is not required to back up your custom tasks. However, it is a good practice to back up your custom tasks and custom component implementations. Review them after the upgrade and, if required, redeploy them.
* 
All BETA components used in custom mashups will be removed when you upgrade to ThingWorx Navigate 9.2. Plan to update your mashups after the upgrade with the 9.2 version of those components.
Save Your Changes to the Deny List
If you made any changes to the deny list, save a copy of your changes so you can reapply them after the upgrade. See the Add Attributes to the Deny List topic for more information.
Prerequisites for In-Place Upgrade
Upgrade ThingWorx Foundation
Before upgrading to ThingWorx Navigate 9.2, ensure that you have upgraded to the compatible ThingWorx Foundation version using the installer. Refer to the following steps:
1. Determine the compatible ThingWorx Foundation version using the Release Advisor or the ThingWorx Navigate Product Compatibility Matrix.
2. If you are upgrading from ThingWorx Navigate 8.5.8, you need to perform some additional steps before upgrading ThingWorx Foundation.
Version Upgrading From
Required Steps
Previously upgraded from ThingWorx Navigate 8.5.x to 8.5.8, now upgrading to ThingWorx Navigate 9.2
If you previously upgraded from ThingWorx Navigate 8.5.x to 8.5.8, and are now upgrading to ThingWorx Navigate 9.2, perform the following steps:
a. Run the ThingWorx Upgrade Ready Utility. For more information, see the "B.) Run the ThingWorx Upgrade Ready Utility" section in Installer Upgrade topic of the ThingWorx Help Center.
b. In the ThingWorxFoundation.xml file that is created after running this utility, modify the <applicationVersion> property value to 8.5.8.
* 
The ThingWorxFoundation.xml file is saved in the .ptc_ccif folder in your user profile (for example, on Windows: C:\Users\Administrator\.ptc_ccif; on Linux: ~/.ptc_ccif/).
Upgrading from ThingWorx Navigate 8.5.8 to 9.2
While upgrading from ThingWorx Navigate 8.5.8 (installed using the installer) to 9.2, the required ThingWorxFoundation.xml file is not created in the .ptc_ccif folder. As a workaround for this known issue, you need to manually create the ThingWorxFoundation.xml file and verify some property values in the file.
a. Create the ThingWorxFoundation.xml file. You can use the following example and update it based on your requirement.
<?xml version="1.0" encoding='utf-8'?>
<installationInfo>

<projectFlavor>PostgreSQL</projectFlavor>
<applicationName>ThingWorxFoundation</applicationName>
<applicationVersion>8.5.8</applicationVersion>
<applicationInstallDir>C:\Program Files
(x86)\ThingWorxFoundation</applicationInstallDir>
</installationInfo>
b. Verify the following property values in the ThingWorxFoundation.xml file in your user profile:
a. Validate that the <applicationVersion> property value is your current version.
b. Validate that the <applicationInstallDir> property value is your current ThingWorx Foundation installation location.
3. Upgrade to the compatible ThingWorx Foundation version using the installer. For help with upgrade, refer to the Using the Installer to Upgrade ThingWorx Foundation topic from the ThingWorx Help Center.
* 
ThingWorx Foundation 9.2 requires JAVA 11. If you are upgrading from a version deployed with JAVA 8, install JAVA 11, import the relevant certificates from JAVA 8 into JAVA 11, and then proceed with upgrading ThingWorx Foundation.
Install ThingWorx Flow
ThingWorx Flow must be installed using the installer before upgrading ThingWorx Navigate. For help with installing ThingWorx Flow, visit the Installing ThingWorx Flow topic in the ThingWorx Help Center.
* 
ThingWorx Foundation, ThingWorx Flow, and ThingWorx Navigate must be installed on the same system.
While installing ThingWorx Flow, if you did not already update the extra.crt file with the self-signed certificates required for your applications, ensure that you update it before installing ThingWorx Navigate. For detailed instructions, refer to step 7 in the Post-Installation Steps for ThingWorx Flow topic of the ThingWorx Help Center.
Review Windchill Requirements
Ensure you meet the Windchill requirements before you begin upgrading ThingWorx Navigate.
See the "Windchill Requirements" section in the Prerequisites topic for details.