Troubleshooting Descriptive Analytics
The Linux version of ThingWorx Analytics installs and configures its components as Linux systemd services.
After the installation, several basic utility scripts and commands are available to troubleshoot the application, when necessary.
|
|
Administration of Descriptive Analytics requires installation user access (in root mode).
|
To Start, Stop, or Restart the Microservice
1. Open a terminal window as the root user.
2. Run any of the following commands on the Descriptive Analytics Microservice:
◦ Start the microservice: systemctl start descriptive-analytics-microservice.service
◦ Stop the microservice: systemctl stop descriptive-analytics-microservice.service
◦ Restart the microservice: systemctl restart descriptive-analytics-microservice.service
To Update the ThingWorx AppKey
1. Log into
ThingWorx Composer, as an Administrator, and create a new AppKey. For more information, see the
Application Keys section of the
ThingWorx Foundation Help Center.
|
|
The Application Key you provide to ThingWorx Analytics must be a key created by a user with Administrator privileges.
|
2. Add the new AppKey to the descriptive-analytics-microservice.properties file as follows:
◦ In your installation directory, open the properties file at the following path:
/opt/ThingWorxAnalytics/DescriptiveAnalytics/descriptive-analytics-config/descriptive-analytics-microservice.properties
◦ In the open file, update the thingworx.application.key property with the new AppKey and save the file.
3. Open a terminal window as the root user.
4. Restart the Descriptive Analytics Microservice:
systemctl restart descriptive-analytics-microservice.service
It might take several seconds for the Things in ThingWorx Foundation to refresh and reconnect.
To Check Component Logs
The installation log file is available at the following path:
/opt/ThingWorxAnalytics/DescriptiveAnalytics/DescriptiveAnalytics-install.log
To Resolve Executable Permissions
An installation failure can be caused when the installer file does not have the necessary executable permissions. To diagnose whether this problem is the cause of an installation failure, check the installation log, install.log, for a Permission Denied error.
To manually resolve this permissions issue, follow the steps below.
1. Open a terminal window as the root user.
2. Navigate to the location where you saved the extracted files when you downloaded the installer media and locate the DescriptiveAnalyticsInstaller at the following path:
component_installers/DescriptiveAnalyticsInstaller/DescriptiveAnalytics-<n.n.n>-linux-x64-installer.run
3. Run the following command to provide executable permission to the DescriptiveAnalytics-<n.n.n>-linux-x64-installer.run installer file:
chmod 777 DescriptiveAnalytics-<n.n.n>-linux-x64-installer.run
