ThingWorx Analytics Installation > ThingWorx Analytics Linux Installation
ThingWorx Analytics Linux Installation
Prerequisites – Linux Installation
Components in both the Analytics Server and the Platform Analytics installations require specific access and specific software. See the appropriate sections below to view the requirements for installing in a Linux environment.
System requirements, including operating systems, web browsers, and third-party software, are stored in the PTC Release Advisor. For more information, see Using Release Advisor.
For information about hardware requirements, see Hardware Requirements.
Root Access 
All installation and troubleshooting procedures must be run with root user permissions. To launch installation or troubleshooting commands, do one of the following:
Log in as the root user, or
Open a terminal window and use an su - or su - root command to switch to the root user and load the correct environment variables.
ThingWorx Server 
Make sure that a compatible version of the ThingWorx server is installed and running, preferably on a separate computer, before installing Analytics components.
If you plan to access ThingWorx Analytics from a FactoryTalk Analytics DataFlowML pipeline, installation of the ThingWorx server is optional. Additionally PTC does not support the DataFlowML integration for any version of ThingWorx Analytics.
Before beginning installation of Analytics components, log into ThingWorx Composer, as an Administrator, (the front end user interface for ThingWorx) and create an Application Key. For information about this process, see Application Keys in the ThingWorx Help Center.
The Application Key you provide during installation of Analytics components must be a key assigned to a user with Administrator privileges. After installation, the Application Key can be reassigned to a non-administrator user who has the appropriate permissions. See ThingWorx Application Key Permission Levels.
The same key can be used for both Analytics Server and Platform Analytics.
If you are installing the Analytics Server and you plan to include installation of the Analytics Extension, a set of Extension import permissions must be enabled in the platform-settings.json file. These permissions might already have been enabled during ThingWorx installation and configuration. However, without the following minimum parameters, the Analytics Server installation will not be able to import Analytics Extension into ThingWorx:

"PlatformSettingsConfig": {
"ExtensionPackageImportPolicy": {
"importEnabled": true,
"allowEntities": true,
"allowExtensibleEntities": true,
"allowJarResources": true,
"allowJavascriptResources": true,
"allowCSSResources": true
For information about configuring parameters in the platform-settings.json file, see Configure the platform-settings.json File or platform-setting.json Configuration Details in the ThingWorx Help Center.
ThingWorx Application Key Permissions Levels
A ThingWorx Application Key must be provided during the ThingWorx Analytics installation. This Application Key must be created in ThingWorx Composer before you start the ThingWorx Analytics installation. In addition, that Application Key must be created by a user with Administrative permissions in ThingWorx.
However, after the ThingWorx Analytics installation is complete, you can enable permissions so that the Application Key used for running ThingWorx Analytics components can be reassigned to a non-administrator user. To enable these permissions for a non-administrator user, follow the steps below to add the user to the necessary User Groups and reassign the Application Key:
1. Log into ThingWorx Composer as an Administrator.
2. If the non-administrator user has not been created yet, navigate to SECURITY > Users and create the non-administrator user.
3. Navigate to SECURITY > User Groups and add the user to the following User Groups:
4. Navigate to SECURITY > Application Keys and open the key you want to reassign to the non-administrator user.
5. In the User Name Reference field, select the non-administrator user and Save the reassigned Application Key.
Required Versions
ThingWorx Analytics requires the following versions of Java:
ThingWorx Analytics Release
Java Version
9.2 and later
Java 11 – Oracles or Open JDK (Amazon Corretto)
Java 8 – Oracle or Open JDK (8u141 64-bit)
Java 11 – Oracles or Open JDK (Amazon Corretto)
Java 8 – Oracle or Open JDK (8u141 64-bit)
The Linux distribution must use systemd and the installer must have root permissions (log in as root user or use sudo).
Environment Variable Configuration
To ensure the Java environment variable is configured properly, do the following:
1. In a terminal window, enter the following command to check for the necessary Java environment variable:
If a valid path to your Java installation is returned, the variable is configured properly. If not, continue with the steps below to configure the variable.
2. Locate the directory of your Java installation.
The path to this installation can vary from one distribution of Linux to another. Common paths to check include:
However, it’s possible the Java installation is not in one of these common locations.
3. Open the following file in a text editor: /etc/profile
4. Add the following line to the end of the file and save the file:
export JAVA_HOME=<java_path>
Where <java_path> is the path to your JDK installation.
5. Log out of the terminal window and log back in.
6. To verify that the Java variable is configured properly, re-enter the following command:
If a valid path to your Java installation is returned, the variable is configured properly.
Was this helpful?