Network Management

Remove an Agent from Linux- or AIX-based devices in Orion

This article describes how to remove Orion agents from Linux- or AIX-based devices.

First published date

10/30/2018 2:21 PM

Last published date

7/22/2022 12:18 PM

Overview

When an Agent is acting strange and stops functioning as expected, this article includes instructions on how to remove agents from Linux- or AIX-based devices manually.

Product section

Orion Platform

Resolution

  1. Before removing the agent from the device, try to remove it through the Manage Agents page. This will remove it from the Orion database.

    The agent is removed from the Agents grid. If the agent is connected to the Orion server, it also removes the agent, the swiagent service account, and removes all files from the /opt/SolarWinds directory.

    1. Log in as an administrator and click Settings > All Settings > Manage Agents. 

    2. Select the agent, and click Delete.

  2. Log on to the remote node.

  3. Verify that the agent has been removed using your package manager.

    • For RedHat-based Linux or IBM AIX distributions, you can use yum or rpm. For example:

      yum info swiagent or rpm -q swiagent

    • For Debian-based Linux distributions, you can use dpkg. For example: 

      dpkg -s swiagent

  4. If the agent has not been removed, use your package manager to remove it.

    This may take several minutes to complete. The agent attempts to connect to the Orion server to remove it from the database.
    • For RedHat-based Linux or IBM AIX distributions, you can use yum or rpm. For example:  
      rpm -e swiagent or rpm -e --noscripts swiagent

    • For Debian-based Linux distributions, you can use dpkg. For example: 

      dpkg -r swiagent

The agent, the swiagent service account, and all files from the /opt/SolarWinds directory are deleted.

 

Uninstall the agent - Based on distro 

rpm -e swiagent or if the agent is connected you can delete using the ui 
yum remove swiagent 
apt-get remove swiagent ( or  apt-get remove purge --auto-remove swiagent) (or say snmp)
rm /tmp/taskProperties.* 

 

Reference Information

See Linux Agent Deployment on the SolarWinds THWACK site for additional details.