Prerequisites

In this topic, you’ll find the prerequisites for ThingWorx Navigate. These include requirements for hardware sizing, ThingWorx Foundation, and Windchill.

Check out the Release Advisor or the ThingWorx Navigate Product Compatibility Matrix for the supported versions of Windchill, ThingWorx, web browsers, third-party software, and other required applications.

PTC plans to retire the ThingWorx Navigate Product Compatibility Matrix in the next release of ThingWorx Navigate. This document will no longer be maintained for future releases. We recommend referencing the Release Advisor for compatibility information.

c. In the Version field, select the version for which you need compatibility information.

4. The release matrix for the selected product is provided in the Release Matrix field in the Primary Product bar at the top of the page.

For additional information on using Release Advisor, see this Technical Support Article in the PTC Knowledge Base.

• Review ThingWorx Sizing Guidelines at System Requirements in the ThingWorx Help Center.

• The ThingWorx Navigate Platform Sizing Guide helps determine the hardware configuration required to successfully deploy ThingWorx Navigate.

• ThingWorx Foundation must be installed using the installer before installing ThingWorx Navigate. For help with installing ThingWorx Foundation, visit ThingWorx Foundation Installer in the ThingWorx 9 Help Center.

• If you plan to configure ThingWorx Navigate with a Single Sign-on (SSO) authentication, you must configure ThingWorx Foundation using SSL before beginning your ThingWorx Navigate installation.

• Although ThingWorx Foundation supports PingFederate, Azure Active Directory, as well as Active Directory Federation Services as central auth servers (CAS), ThingWorx Navigate only supports PingFederate in this release.

• After installing ThingWorx Foundation using the installer, run the License Configurator tool to receive a valid license with entitlement for ThingWorx Navigate.

ThingWorx Flow must be installed using the installer before installing 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.

If you have an existing installation of ThingWorx Integration Runtime, uninstall it using instructions relevant to your operating system from the following table:

Windows	Linux
1. From the Task Manager, stop the ThingWorx-IntegrationRuntime service. 2. In a command prompt, run the following command: sc delete Thingworx-IntegrationRuntime	1. In a command prompt, run the following commands: systemctl stop Thingworx-IntegrationRuntime systemctl disable Thingworx-IntegrationRuntime rm -f /etc/systemd/system/Thingworx-IntegrationRuntime.service systemctl daemon-reload

• Windchill—Ensure that you are on the minimum supported CPS version for the supported Windchill releases. Check the Release Advisor or the ThingWorx Navigate Product Compatibility Matrix for the supported versions and minimum CPS. For help with using the Release Advisor, see the Product Compatibility Information section in this topic.

• For enhanced security, we recommend configuring your Windchill server with SSL before you begin a ThingWorx Navigate installation. Refer to the Windchill Installation and Configuration Guide for instructions on how to do this.

If you plan to configure your ThingWorx Navigate using the Windchill authentication, you must configure your Windchill server with SSL before you begin the installation.

• To enable upload and download requests in Windchill, you need to configure Windchill to allow Cross-Origin Resource Sharing (CORS) using instructions in this article. Make sure that both Windchill and ThingWorx are configured using the same protocol—HTTP or HTTPS. PTC recommends using a secure connection (HTTPS).

While configuring Windchill, update the [ALLOWED_ORIGINS] parameter in the web.xml file with the web address for ThingWorx Flow. For instance, https://FlowHost:Port

◦ Downloading attachments, for instance, to retrieve graphic files existing only in Windchill replica vaults while using the View Part Structure task.

For configuring ThingWorx Navigate, you need to create KeyStore and TrustStore files. You can create these files now or before you begin with the configuration. Refer to the Create KeyStore and TrustStore Files for ThingWorx Navigate topic for detailed instructions

The files you need depend on the authentication method you choose. Go to one of these topics to review the files you require: