---
title: "How to use SARTool"
slug: "how-to-use-sartool"
description: "EndpointProtection/StellarSeries/ready_to_release/HelpCenter"
updated: 2024-07-01T07:34:30Z
published: 2024-07-01T07:34:30Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.txone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to use SARTool

### Summary
SARTool is used to remove both Stellar Enforce (renamed to StellarProtect Legacy Mode after Stellar 2.0) and StellarProtect agents when the standard uninstallation process (Control/Programs) encounters problems or there is a request to uninstall without password.

* * *
### Details

Please reach out to TXOne support and submit a support ticket along with an activation code for SARTool and key files.  

#### <u>**Procedure**</u>
This step is executed on the machine that has the Stellar agent installed.

**Usage:**

* Download SARTool.zip and then extract it.
* Copy generated key files to the folder of SARTool.exe.
![image.png](https://cdn.document360.io/f5889a21-4b9d-49ff-a4a7-03538c6b843a/Images/Documentation/image%28283%29.png){height="" width="400"}

* Open Command Prompt as administrator and run SARTool.exe in the correct platform folder (x64-Release/x86-Release)
    * SARTool.exe [--force]
        * --force: optional, suppress the interactive confirmation (useful for automation)
![image.png](https://cdn.document360.io/f5889a21-4b9d-49ff-a4a7-03538c6b843a/Images/Documentation/image%28284%29.png){height="" width="400"}
* * *
### Troubleshooting
<table>
  <tr>
    <th>Error Message</th>
    <th>Mount Upgrade</th>
  </tr>
  <tr>
    <td>You must be a Windows administrator to perform this function</td>
    <td>Open Command Prompt as administrator</td>
  </tr>
  <tr>
    <td>Failed to read key files</td>
    <td>Check if key files are copied to the current folder</td>
  </tr>
  <tr>
    <td>Version is not supported</td>
    <td>Check if agent version is newer than tool version and use newer tool</td>
  </tr>
  <tr>
    <td>Key files are invalid</td>
    <td>Check if the customer activation code and system time meet the requirement</td>
  </tr>
  <tr>
    <td>No Agent installed</td>
    <td>
        <ol>
            <li>Check if you’re using correct SARTool on correct platform. Ex: using x86 SARTool to remove x64 platform Agent.</li>
            <li>If you’re using the correct version of SARTool and you still get this message, please help to collect SARTool debug tool and Agent debug log.</li>
        </ol>
    </td>
  </tr>
  <tr>
    <td>Failed to load modules</td>
    <td>Collect SARTool debug logs in SARTool’s “Log” folder</td>
  </tr>
  <tr>
    <td>Failed to remove installed agent</td>
    <td>Collect SARTool debug logs and Agent debug log from op_diagnostic.exe (SP) or WKSupportTool.exe (SPLM)</td>
  </tr>
</table>

:::(Info) (Collect SARTool debug log:)
* Stellar Enforce removal log
    * log\ \<DATETIME>\_wk_SARTool_debug_\<ID>\.log
* Stellar Protect removal log
    * log\TXSPRemover_\<DATETIME>.log

![image.png](https://cdn.document360.io/f5889a21-4b9d-49ff-a4a7-03538c6b843a/Images/Documentation/image%28285%29.png){height="" width="400"}

Agent Debug log:

* Agent Installed
    *     Stellar Protect: StellarProtect installed folder\op_diagnostic.exe
    *     StellarProtect Legacy Mode: StellarProtect Legacy Mode installed folder\WKSupportTool.exe
* Agent Not Installed
    * Use Single installer combined support tool in SupportTool\StellarSupport.exe

:::


    
    
* * *
<div style="margin-top:100px;margin-bottom:100px;"> For further assistance, please contact us at <u>support@txone.com </u>or your support provider. </div>