Updated on 2022-02-21 GMT+08:00

Uninstalling the ICAgent

If the ICAgent on a server is uninstalled, server O&M will be affected, making topology and tracing functions unavailable. Exercise caution when performing this operation.

You can uninstall the ICAgent using the following methods:

Uninstalling the ICAgent Through the Console

  1. Log in to the Application Performance Management (APM) console.
  2. In the navigation pane, choose Agent > Management.
  3. Select Other: user-defined nodes from the drop-down list on the right of the page.
  4. Select one or more servers where the ICAgent is to be uninstalled, and click Uninstall ICAgent. In the Uninstall ICAgent dialog box, click Yes.

    The ICAgent begins to be uninstalled. This operation takes about 1 minute to complete. When the ICAgent status changes from Uninstalling to Uninstall, the ICAgent is successfully uninstalled.

Uninstalling the ICAgent Through Logging In to a Server

  1. Log in to the server from which the ICAgent is to be uninstalled as the root user.
  2. Run the following command to uninstall the ICAgent:

    bash /opt/oss/servicemgr/ICAgent/bin/manual/uninstall.sh;

  3. Wait until the message "ICAgent uninstall success" is displayed.

Remotely Uninstalling the ICAgent

In addition to the preceding method, you can use a method similar to Inherited Installation to remotely uninstall the ICAgent.

  1. Run the following command (x.x.x.x indicates the server IP address) on the server where the ICAgent has been installed:

    bash /opt/oss/servicemgr/ICAgent/bin/remoteUninstall/remote_uninstall.sh -ip x.x.x.x

  2. Enter the password of the root user of the server where the ICAgent is to be uninstalled as prompted.

    • If both the expect tool and the ICAgent have been installed on the server, the ICAgent will be uninstalled from the remote server after the preceding command is executed. If the ICAgent has been installed on the server, but the expect tool has not, enter the information as prompted.
    • Ensure that the root user can run the SSH and SCP commands on the server where the ICAgent has been installed to communicate with the remote server where the ICAgent is to be uninstalled.
    • If the message "ICAgent uninstall success" is displayed, the ICAgent is successfully uninstalled. After the ICAgent is successfully uninstalled, choose Agent > Management in the navigation pane to view the ICAgent status.

Uninstalling the ICAgent in Batches

If the ICAgent has been installed on a server and the installation package ICProbeAgent.zip exists in the /opt/ICAgent/ directory of the server, use this method to uninstall the ICAgent from multiple remote servers in batches with a few clicks.

The servers must belong to the same Virtual Private Cloud (VPC) and network segment.

Prerequisites

The IP addresses and passwords of all servers where the ICAgent is to be uninstalled have been collected, sorted in the iplist.cfg file, and uploaded to the /opt/ICAgent/ directory on the server where the ICAgent has been installed. The following is an example of the iplist.cfg file, where IP addresses and passwords are separated by spaces.

192.168.0.109 password (Set the password as required.)

192.168.0.39 password (Set the password as required.)

  • Because the iplist.cfg file contains sensitive information, you are advised to clear the information after using it.
  • If the passwords of all servers are the same, you only need to list IP addresses in the iplist.cfg file and enter the password once during execution. If the password of an IP address is different from those of other IP addresses, you need to list both passwords and IP addresses in the iplist.cfg file.

Procedure

  1. Run the following command on the server where the ICAgent has been installed:

    bash /opt/oss/servicemgr/ICAgent/bin/remoteUninstall/remote_uninstall.sh -batchModeConfig /opt/ICAgent/iplist.cfg

    Enter the default password of the root user of the server where the ICAgent is to be uninstalled as prompted. If the passwords of all IP addresses have been configured in the iplist.cfg file, press Enter to skip this step. Otherwise, enter the default password.

    batch uninstall begin
    Please input default passwd:
    send cmd to 192.168.0.109
    send cmd to 192.168.0.39
    2 tasks running, please wait...
    End of uninstall agent: 192.168.0.109
    End of uninstall agent: 192.168.0.39
    All hosts uninstall icagent finish.

    Wait until the message "All hosts uninstall icagent finish." is displayed, which indicates that the ICAgent has been successfully uninstalled from all the hosts listed in the configuration file.

  2. After the ICAgent is successfully uninstalled, choose Agent > Management in the navigation pane to view the ICAgent status.