Handling a Failed Installation
If an error occurs that prevents the ThingWorx Analytics Server or the Descriptive Analytics Microservice installations from completing successfully, the software will roll back the failed installation. It will remove the various installed components and leave behind the installation directory containing the log files for further investigation. You can perform the manual steps below to ensure the product is completely removed before running a fresh installation.
|
|
The procedures below assume that you have already consulted the install.log or the DescriptiveAnalytics-install.log and fixed whatever problem caused the installation to end.
|
Follow these steps to remove components:
|
|
Depending on where the installation failed, not all of the steps below will be available or applicable.
|
1. Open a terminal window as the root user.
2. Navigate to the installation directory (for example: /opt/ThingWorxAnalytics/ThingWorxAnalyticsServer)
|
|
If your installation directory is different, for example because you’ve upgraded from a previous release, adjust your navigation accordingly. For more information, see Upgrade from an Earlier Version. |
3. If the bin/twas.sh utility is available, execute the following commands:
◦ ./twas.sh stop
◦ ./twas.sh disable
If for some reason, the bin/twas.sh utility script is not available, execute the following commands, in the specified order:
◦ systemctl list-unit-files “twas*” | awk ‘{print $1}’ | grep “twas” | xargs systemctl stop
◦ systemctl list-unit-files “twas*” | awk ‘{print $1}’ | grep “twas” | xargs systemctl disable
4. Execute the following commands, in the specified order:
◦ rm -rf /usr/local/nginx
◦ rm -rf /etc/nginx
◦ rm -rf /etc/systemd/system/twas*
5. If the Descriptive Analytics Microservice was part of your installation, execute all of the following commands to stop, disable, and remove the descriptive-analytics-service:
◦ systemctl stop descriptive-analytics-microservice.service
◦ systemctl disable descriptive-analytics-microservice.service
◦ rm /etc/systemd/system/descriptive-analytics-microservice.service
6. Before attempting a new installation, check the memory and hard disk space on the host server. For more information, see the Hardware section of
System Requirements (also available from the
Reference Documents section of the PTC eSupport Portal).
