In-Place Upgrade for ThingWorx Navigate
We’ll upgrade ThingWorx Navigate using the ThingWorx Navigate Setup tool. In the sections below, you’ll find more information to help you set up your system.
Open the Tool for Upgrade
According to the package that you downloaded, unzip the download, and then open the installer file:
• Windows—ThingWorx-Navigate-<version>-Windows-installer.exe
• Linux—ThingWorx-Navigate-<version>-Linux-x64-installer.run
For Windows, double-click the file to open the ThingWorx Navigate Setup tool.
For Linux, make sure you run ThingWorx Navigate Setup with the root user.
Welcome to ThingWorx Navigate
Let’s begin with the ThingWorx Navigate upgrade. Click Next or Forward to begin.
Prerequisites for Upgrade
 |
This step is not applicable if you are upgrading to ThingWorx Navigate 9.3.0 using Windchill or fixed authentication.
|
Now, a reminder to make sure that you meet all the requirements for upgrade. Based on your authentication type, review the information provided in the "Prerequisites for SSO Authentication" or "Prerequisites for Fixed and Windchill Authentication" section of In-Place Upgrade.
Click Next or Forward.
License Agreement
1. Read the license agreement, and then select I accept the agreement. You can print a copy of the agreement.
2. Click Next or Forward.
Authentication
Based on your authentication type, the ThingWorx Navigate Setup tool leads you to one of the following:
• Creating and validating your ThingWorx administrator application key
• Entering your ThingWorx administrator password
|
For SSO and Windchill Authentication
|
For Fixed Authentication
|
|---|---|
|
1. Create a ThingWorx application key. Refer to the "Creating an Application Key" section in the Application Keys topic of the ThingWorx Help Center.
2. Copy the value under Key ID.
3. Back in the ThingWorx Navigate Setup tool, paste the value in the box next to Application Key and click Next or Forward.
Your application key is validated.
|
1. Enter the password for your ThingWorx Administrator account.
2. Click Next or Forward.
|
Begin Your Upgrade
Now’s the time to review your settings. If you need to change anything, click Back. When you’re ready, click Install.
The upgrade process can take several minutes.
|
|
ThingWorx Navigate is installed in the same location as your existing ThingWorx Foundation installation.
|
Upgrade Successful
Based on the status of your upgrade, you will see either of the following screens:
Success!
ThingWorx Navigate is successfully upgraded.
Configuration from your source ThingWorx Navigate version is retained after the upgrade. Proceed with configuration only if you want to make any changes to your existing configuration. For detailed configuration instructions, refer to the Configure ThingWorx Navigate topic.
Upgrade Successful with Errors
If you see this screen, your ThingWorx Navigate upgrade is successful but incomplete as attribute mapping for the View Document task has failed. For detailed information on the failure, review the ThingWorx log files. The failure log lists the attributes for which the mapping has failed. To resolve this issue, open the tailoring page for View Document and manually add the missing attributes (using details obtained from the log files) to the selected attribute list.
Refer to the Version 9.3.4 Release Notes to see details on the known issue regarding missing attributes.
Next Steps
After a successful upgrade, non-administrator users must be granted permission to access ThingWorx Navigate tasks. For more information, see the topic Modify ThingWorx Permissions: Users and Groups.
Once the required permissions are granted, you can proceed with restoring your custom tasks, reapplying your changes to the deny list, and updating project dependencies, as described in Restore Your Custom Tasks and Deny List into the Target System.