Prerequisites
In this topic, you’ll find the prerequisites for ThingWorx Navigate. These include requirements for hardware sizing, ThingWorx Foundation, and Windchill.
Product Compatibility Information
Check out the Release Advisor for the supported versions of Windchill, ThingWorx, web browsers, third-party software, and other required applications.
Using the Release Advisor
To view a release matrix in Release Advisor:
1. Log into the Release Advisor.
2. On the Primary Product page, perform the following steps:
a. In Product Family field, select ThingWorx.
b. In the Product field, select ThingWorx Navigate.
c. In the Version field, select the version for which you need compatibility information.
d. Click Add.
3. Click Next.
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.
Hardware Sizing
• 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 Requirements and ThingWorx Navigate Licensing
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.
Uninstall ThingWorx Integration Runtime
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 Requirements
These are the requirements for Windchill:
• Windchill—Ensure that you are on the minimum supported CPS version for the supported Windchill releases. Check the Release Advisor 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. |
• Enable TLS 1.2 as per instructions provided in the "Enabling TLS 1.2" section of the TLS 1.3 Support for Windchill topic from the Windchill Help Center. This configuration is required for the Windchill connection to work as expected, especially while setting up ThingWorx Navigate with Windchill authentication.
• 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).
Configure Windchill to allow CORS enables the following:
◦ Uploading attachments to the Report a Problem task.
While configuring Windchill, update the [ALLOWED_ORIGINS] parameter in the web.xml file with the web address for ThingWorx. For instance, https://ThingWorxHost:Port
◦ Downloading attachments, for instance, to retrieve graphic files existing only in Windchill replica vaults while using the View Part Structure task.
• Prerequisites for the e-signature capability:
Windchill requirements: Ensure that you meet the requirements stated in the Electronic Signatures topic of the Windchill Help Center before configuring e-signature in ThingWorx Navigate. For the single sign-on configuration, you also need to perform some additional steps described in eSignature Validation for SSO Configurations.
• To ensure that correct data is fetched from Windchill, ensure that the ThingWorx Navigate language value matches with that of Windchill. Refer to Adding a New Language which is not Supported by ThingWorx for help with setting languages in ThingWorx.
KeyStore and TrustStore Files
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: