Armor Knowledge Base  /  Armor Anywhere 

Uninstall the Agent

The uninstall command uninstalls the Armor Anywhere agent, subagents, and user accounts.

If you uninstall the agent, the armoradmin user account will simply be disabled, and not removed from your system. The armoradmin user account continues to be in your system in case you need Armor's assistance to reinstall the agent or to troubleshoot other issues.

When you uninstall the agent, the corresponding virtual machine (or server) will be displayed in the Armor Management Portal (AMP) in a disabled status. As an optional step, after you uninstall the agent, you can remove the disabled virtual machine (or server) from your AMP account. 

Step 1: Stop the service and uninstall the agent

Windows Users

The agent installation file is located at: C:\.armor\
  1. Stop the service: C:\.armor\opt\armor stop
  2. Uninstall the agent: C:\.armor\opt\armor uninstall

Linux Users

The agent installation file is located at: /opt/armor/
  1. Stop the service:/opt/armor/armor stop
  2. Uninstall the agent:/opt/armor/armor uninstall

Step 2: Remove the agent from the Armor Management Portal (AMP)

You can remove the instance through AMP or through an API call

Method 1: Remove the agent through AMP

When you uninstall the agent, the corresponding virtual machine (or server) will be displayed in AMP in a disabled status.

Before you can remove the agent, the agent must be in a Needs Attention state.

  1. In the Armor Management Portal (AMP), in the left-side navigation, click Infrastructure.
  2. Click Virtual Machines.
  3. Locate and hover over the desired virtual machine. 
  4. Click the vertical ellipses. 
  5. Click Delete
  6. Mark Delete now
  7. Click Delete VM

Method 2: Remove the agent through an API call

You can use the DELETE /vms/core/{coreInstanceId} API call to remove an instance.

Delete an agent

To learn more about the Armor API system, see Armor API Guide.

Step 3: Verify Disconnection 

After you uninstall the agent, Armor recommends that you test the connection for each previously configured firewall rule.

To verify a disconnection to an Armor service endpoint, use the telnet command.

The following example tests connectivity to over 443/tcp:Troubleshooting:

telnet 443

For Windows systems without the telnet feature installed, you can also use PowerShell:

new-object System.Net.Sockets.TcpClient('', 443)

Was this helpful?
Your Rating:
1 Star2 Star3 Star4 Star5 Star
2 rates