Prerequisites – Linux Installation

ThingWorx Analytics requires the access and software listed below.

All installation and troubleshooting procedures must be run with root user permissions. To launch installation or troubleshooting commands, do one of the following:

• Open a terminal window and use an su - or su - root command to switch to the root user and load the correct environment variables.

◦ Make sure that the ThingWorx Foundation server is installed and running, preferably on a separate computer, before installing the ThingWorx Analytics functionality.

◦ Before beginning installation of ThingWorx Analytics functionality, log into ThingWorx Composer, as an Administrator, (the front end user interface for ThingWorx Foundation) and create an Application Key. For information about this process, see Application Keys in the ThingWorx Foundation Help Center.

The Application Key you provide during the ThingWorx Analytics installation must be a key created by a user with Administrator privileges.

• Java 8.x JDK 64-bit (Java SE Development Kit) – Open JDK and Oracle are both supported. The Linux distribution must use systemd and the installer must have root permissions (log in as root user or use sudo). 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.

The path to this installation can vary from one distribution of Linux to another. Common paths to check include:

• /usr/java

• /usr/share/java

• /opt/java

However, it’s possible the Java installation is not in one of these common locations.

4. Add the following line to the end of the file and save the file:

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.

For information about operating systems, web browsers, and hardware requirements, see System Requirements (also available from the Reference Documents section of the PTC eSupport Portal).