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.

Depending on where the installation failed, not all of the steps below will be available or applicable.

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.

◦ If the install failed after the twas.bat file was created, each ThingWorx Analytics Server service that was installed will be stopped and deleted.

◦ If the install failed before the twas.bat file (or even the bin folder) was created, nothing will happen and you will need to continue with Step 4 below.

4. If the install did not create the twas.bat file before failing, execute individual commands to remove each service that was installed. The table below provides the stop and delete commands for each service. Execute both a stop and a delete command for any service that was installed.

Stop Commands	Delete Commands
sc stop twas-clustering-ms	sc delete twas-clustering-ms
sc stop twas-data-ms	sc delete twas-data-ms
sc stop twas-edge-ms	sc delete twas-edge-ms
sc stop twas-predictive-ms	sc delete twas-predictive-ms
sc stop twas-prescriptive-ms	sc delete twas-prescriptive-ms
sc stop twas-profiles-ms	sc delete twas-profiles-ms
sc stop twas-results-ms	sc delete twas-results-ms
sc stop twas-signals-ms	sc delete twas-signals-ms
sc stop twas-training-ms	sc delete twas-training-ms
sc stop twas-validation-ms	sc delete twas-validation-ms
sc stop twas-validation-ms-<number>	sc delete twas-validation-ms-<number>
sc stop twas-zookeeper	sc delete twas-zookeeper

5. If the Descriptive Analytics Microservice was part of your installation, execute both of the following commands to stop and delete the descriptive-analytics-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.