Graphical Mode Installation
This procedure documents installation for the 8.5.x release. If you need installation information for one of the following earlier releases, use the links below to open earlier PDF installation guides maintained on the PTC eSupport Portal:
* 
This procedure represents the graphical installation mode, typically used in a Windows environment. For launch information using the Silent installation mode, see Silent Mode Installation
Before Installation
Make sure all of the prerequisites have been met.
Download the appropriate installer files for your operating system.
Extract the downloaded files to a location on your host system.
Installation Steps
1. Navigate to the extracted Windows installer file, ThingWorxAnalytics-<n.n.n>-windows-installer.exe, right click the file, and select the Run as Administrator option.
* 
An advanced option is available if you want to override the default user account during the installation. For more information about launching the installer with this option, see Change the User Account.
2. Accept the license agreement and click Next.
3. Select the ThingWorx Analytics components you want to install.
The components available for installation include the following:
Analytics Server
Click the + icon to expand the option and select either one or both of the following:
Async Microservice
Installs the Asynchronous Microservice along with other necessary components, including ZooKeeper and Analytics Common Workers. During the installation, three Workers are installed but the number of Workers can be scaled up when the installation is complete. For information, see Scale the Number of Workers.
Sync Microservice
Installs only the Synchronous Microservice.
Integration with ThingWorx
The following components involve integration with ThingWorx:
ThingWorx Adapter for Analytics Server
This adapter generates the Analytics Things that can be accessed in ThingWorx Composer. It is selected by default if you have selected the Integration with ThingWorx parameter. If you plan to interact with ThingWorx Analytics via ThingWorx, this parameter is required.
Analytics Extension
Must be selected if you plan to use Analytics Builder or Analytics Manager. Analytics Extension can only be used if both the Async and the Sync Microservices are installed.
4. Specify an installation directory. You can accept the default or provide a different location.
* 
If the installer detected a previous version of the ThingWorx Analytics Server, and you want to upgrade, the old installation directory is preselected and you will not be able to change it. For more information, see Upgrade from an Earlier Version.
5. Enter ThingWorx connection information, including the following parameters:
* 
If you opt not to select the ThingWorx Adapter for installation, ThingWorx connection information will not be requested.
Parameter
Description
ThingWorx IP Address or Host Name
Enter the IP address or host name of your ThingWorx server, which must already be installed and running.
* 
If you are using SSL for your connection to ThingWorx, this IP Address or Host Name must match the SAN address or host used to create the ThingWorx SSL certificate.
* 
Use of the server’s primary, outward-facing IP address or host name is preferable for configuring the ThingWorx server connection. Even if ThingWorx and Analytics Server are hosted on the same server, using local host can cause problems when the SaveJobResult service is run to access saved results from outside of the server.
ThingWorx Port
Enter the port for communicating with your ThingWorx server.
ThingWorx AppKey
Enter the value from the Key ID field of the application key you created in ThingWorx.
Analytics Server Thing Name
Enter a name for the AnalyticsServer Thing that is created in ThingWorx during the Analytics Server installation. This full name is attached as a prefix to each microservice name. This Thing name must be unique within the server deployment.
SSL for ThingWorx Connection
Select this check box in order to require the use of SSL when connecting to ThingWorx. By default, this check box is not selected.
* 
In order to enable SSL support for the connection with ThingWorx, a signed SSL certificate must already be in place before installation can begin. See SSL Support for ThingWorx.
If you do not opt to use SSL for the connection to ThingWorx, continue with Step 6. If you enable SSL for the ThingWorx connection, complete the remaining parameters in this step.
Upload a Self-signed ThingWorx SSL Certificate
Select this check box if you are using a self-signed ThingWorx SSL certificate and you want to allow the installer to upload it automatically. By default, this check box is not selected, but you will need to import the certificate manually if you do not select it. For more information, see Import a Self-signed SSL Certificate Manually.
SSL Certificate File
Click the icon to the right of the field and navigate to the location where the SSL certificate file is stored. This file is either a PEM or CER file.
ThingWorx Certificate Alias Name
Enter an alias name that is assigned to the SSL certificate. Alias names are converted automatically to all lower case.
Java Truststore Password
Enter the password for the Java Truststore, a file where trusted SSL certificates are stored. The Truststore is created automatically, with a default password, when Java is installed. For more information about Java Truststore passwords, see Working with Certificates and SSL on the Oracle website.
6. Enter SSL connection information for the ThingWorx Analytics microservices, including the following parameters:
Parameter
Description
Use SSL for Analytics Microservices
By default, this check box is selected. You can accept the default or clear it. When SSL authentication support is enabled for the microservices, communication is protected between the ThingWorx Adapter and the Analytics APIs. Communication between the APIs is also secured.
* 
In order to enable SSL support for the microservices, a signed SSL certificate must already be in place before installation can begin. See SSL Support for Analytics Server APIs.
SSL Keystore file
Click the icon to the right of the field and navigate to the location where the SSL Keystore file is stored. This file contains the signed SSL certificate.
SSL Keystore Password
Enter the password for the SSL Keystore.
Certificate Alias Name
Enter the alias name that is assigned to the signed SSL certificate. Alias names are converted automatically to all lower case.
Host IP Address or Fully Qualified Domain Name to access Analytics microservices
Enter either an IP address or a fully qualified domain name for the primary network adapter on your ThingWorx Analytics Server. The value must match the SAN value provided on the SSL certificate.
Java Truststore Password
Enter the password for the Java Truststore, a file where trusted SSL certificates are stored. The Truststore is created automatically, with a default password, when Java is installed. For more information about Java Truststore passwords, see Working with Certificates and SSL on the Oracle website.
When you complete this step, the installation begins. Depending on your operating system, several windows may open and then close while the process unpacks and installs the necessary libraries and settings.
7. When the installation process is complete, a final page is displayed. Click Finish. An Installation Summary page is displayed with a list of the components that were installed.
8. Review the Installation Summary page and then click OK to close it.
9. To test the product installations, see:
* 
The Analytics Extension installation is not complete until you perform the necessary post-installation configuration steps. For information about these steps, see Perform Post Installation Configuration for Analytics Builder or for Analytics Manager.
Was this helpful?