Handling a Failed Analytics Server Installation
If an error occurs that prevents the component 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 relevant Installation Logs 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 the Windows PowerShell (or the Command Prompt window) in Administrator mode.
2. Navigate to the bin folder of the installation directory for a specific installed component.
For example: C:\Program Files (x86)\ ThingWorxAnalytics\Thingworx_Analytics_Server\bin
|
|
If your installation directory is different, for example because you’ve upgraded from a previous release, adjust your navigation accordingly.
|
3. Execute the following command: .\twas.bat abort.
One of the following will happen:
◦ 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 component that was installed. The table below provides the stop and delete commands for each component. Execute both a stop and a delete command for any of the following components that were installed.
|
Stop Commands
|
Delete Commands
|
|---|---|
|
sc stop twas-async-ms
|
sc delete twas-async-ms
|
|
sc stop twas-sync-ms
|
sc delete twas-sync-ms
|
|
sc stop twas-twx-adapter
|
sc delete twas-twx-adapter
|
|
sc stop twas-zookeeper
|
sc delete twas-zookeeper
|
|
sc stop twas-analytics-worker-<n>
|
sc delete twas-analytics-worker-<n>
|
5. 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.