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
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!
|
Upgrade Successful with Errors
|
|---|---|
|
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.
|
If you see this screen, your ThingWorx Navigate upgrade is successful but incomplete as attribute mapping for any of the following refactored tasks has failed: View Document, View Part Properties, and View Part Structure.
The complete list of attributes with failed mapping is available at both the following locations. You can obtain the log files from either of the following locations:
• attributes-conversion_<date>.log file from the NavigateFileRepository in ThingWorx Composer. Steps to download the log file:
◦ In ThingWorx Composer, click > > . The files available in NavigateFileRepository are displayed.
◦ For attributes-conversion_<date>.log, click the ellipses under Actions and select Download. The log file is downloaded and ready for review.
• ThingWorx log files.
To resolve this issue, open the tailoring page for these tasks and manually add the missing attributes (using details obtained from the log files) to the selected attribute list. See the complete list of attributes not currently available from Windchill REST Services (WRS) here.
|
The following section provides a complete list of attributes that are not currently available from WRS. Expand the section to see the table.
List of attributes not currently available from WRS
Category | Attribute |
|---|---|
Document | Document Structure Status |
Latest Revision | |
Note Status | |
Attributes on the Document Master Object Type | |
Checked Out By | |
Share Name | |
Representation | |
Native File Name | |
Native Content | |
Source System | |
Part | Awaiting Promotion |
Assigned Item Expression | |
Contract Number | |
Inherited Domain | |
Domain Reference | |
Assigned Choices | |
Stop Effectivity Propagation | |
Built From CAD | |
minimumRequired | |
Maximum Allowed | |
Supplier ID | |
Replacement Status | |
Thumbnail | |
Team Template | |
PDM Checkout Status | |
PDM Share Status | |
Checked out PDM Version | |
Collapsible | |
Default Serviceable | |
Document Structure Status | |
Latest Revision | |
Owner | |
Part Build Status | |
Project Share Status | |
Phase | |
Resulting PDM Version | |
Reference Id | |
Service Kit | |
Predecessor View version | |
Application Tag | |
Assigned Usage Expression | |
Inclusion Option | |
Operation Allocation | |
Quantity Option | |
reference | |
Unique Id | |
componentId | |
usedBy | |
uses | |
CAD Document | ADW Access Control Data |
Incomplete Object | |
ECAD Design Item | |
Note Text | |
Out of date with Workspace configuration | |
Component Number | |
Authoring App Version Reference | |
Description | |
Checked Out by | |
ECAD Design Item | |
Format | |
Incomplete Object | |
Latest Revision | |
Neutral File | |
Modified | |
ADW Access Control Data | |
ADW Last Modification |
Next Steps
After a successful upgrade, 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.