Prerequisites – Windows Installation
ThingWorx Analytics requires the access and software listed below.
Administrator Access
All installation and troubleshooting procedures must be run with Administrator permissions. To launch the installer file, or shortcut options from the Start menu, right click and select the Run As Administrator option. To execute procedures from a command line, launch the Command Prompt window in Administrator mode.
Software
• ThingWorx Foundation 8.3
◦ Make sure that the ThingWorx Foundation server is installed and running, preferably on a separate computer, before installing the ThingWorx Analytics functionality.
◦ During installation of
ThingWorx Analytics functionality, you will need a
ThingWorx Foundation application key. So, before beginning the installation, 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 and the installer must have administrative permissions (use the Run as Administrator option). To ensure the Java environment variable is configured properly, do the following:
1. Find and note the location of your Java bin directory. It’s most likely in a path similar to the following:
C:\Program Files\Java\<jre or jdk>_<version number>
2. From the Windows start menu, navigate to Advanced System Properties. Your path to these properties will vary based on your version of Windows. (Example: > > ).
3. Click Environment Variables. An Environment Variables dialog box opens.
4. Scroll through the System variables to make sure that one of the following Java variables appears in the list:
▪ If you are using JDK: JAVA_HOME
|
|
The JAVA_HOME variable must be set in the System variables list, rather than the User variables list.
|
▪ If you are using JRE: JRE_HOME
|
|
The JRE_HOME variable must be set in the System variables list, rather than the User variables list.
|
5. Make sure the Value column shows the path you noted above.
6. If the Java variable is not listed, click New to create a new variable.
7. In the new variable dialog box, enter the following:
▪ Variable Name – Enter JAVA_HOME or JRE_HOME
▪ Variable Value – Enter the path to your Java installation (from step 1).
8. Click OK. The new Java variable is created.
• Windows Powershell version 3 or higher – The installation of the ThingWorx Analytics Worker on a Window operating system requires a small modification to both the Windows Powershell and the Windows Powershell (x86). Make the change as follows:
1. In the Windows start menu, search for powershell.
2. In the results, right click on Windows Powershell and select Run As Administrator. The Powershell window opens.
3. At the prompt in the Powershell window, enter the following command: Set-ExecutionPolicy unrestricted
4. When prompted, enter y (for Yes) and press the Enter key. The execution policy is updated and the system prompt returns.
5. Close the Powershell window and repeat steps 2 – 4 for Windows Powershell (x86).
System Requirements
