How Do I Uninstall the Agent?

Scenario

• The agent was installed using an incorrect package and you need to uninstall it.
• The agent was installed using incorrect commands and you need to uninstall it.
• If the agent fails to be upgraded, uninstall the agent.

Prerequisites

When you uninstall the agent on the management console, the Agent Status of the server is Online.

Uninstalling the Agent on the Console in One-Click

You can uninstall an HSS agent from the HSS console.

After the agent is uninstalled from a server, HSS will not provide any protection for the server.

1. Log in to the management console.
2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
3. In the navigation pane, choose Installation & Configuration > Server Install & Config.
4. In the Operation column of the target server, click Uninstall Agent.

   If you need to uninstall agents in batches, you can select servers and click Uninstall Agent above the list.

5. In the displayed dialog box, click OK.

   In the server list, if Agent Status of the server is Not installed, its agent is successfully uninstalled.

Uninstalling the Agent from the Server

You can manually uninstall an agent on a server when you no longer use HSS or need to reinstall the agent.

After the agent is uninstalled from the target server, HSS will not provide any protection for the server.

• Uninstalling the Linux agent
  1. Log in to the server from which you want to uninstall the agent and run the following command to switch to user root:

     su - root

  2. Perform the following operations to stop HSS:
     1. Run the following command to stop the service:

        /etc/init.d/hostguard stop

     2. (Optional) Enter the verification code displayed in the command output. See Figure 1.
        This operation is required only for servers where HSS self-protection is enabled.

        Figure 1 Verification code
        
  3. In any directory, run the following command to uninstall the agent:
     

     Do not run the uninstallation command in the /usr/local/hostguard/ directory. You can run the uninstallation command in any other directory.

     • For EulerOS, CentOS and Red Hat, or other OSs that support RPM installation, run the rpm -e hostguard command.
     • For Ubuntu and Debian OSs, or other OSs that support DEB installation, run the dpkg -P hostguard command.

     If information similar to the following is displayed, the agent has been successfully uninstalled. If the uninstallation fails, go to the step 3.

     Stopping Hostguard...
     Hostguard stopped
     Hostguard uninstalled.

  4. (Optional) If the agent fails to be uninstalled in step 2, perform the following operations to uninstall the agent:
     • For OSs that support RPM installation, such as EulerOS, CentOS, and Red Hat,
       1. Run the following command to delete the installation record:

          rpm -e --justdb hostguard

       2. Run the following command to check whether there are hostguard processes:

          ps -ef | grep hostguard

          If there are residual processes, run the kill -9 PID command to stop all residual processes.

       3. Run the following command to check whether the /usr/local/hostguard directory exists:

          ll /usr/local/hostguard

          If the directory exists, run the rm -rf /usr/local/hostguard command to delete it.

       4. Run the following command to check whether the /etc/init.d/hostguard file exists:

          ll /etc/init.d/hostguard

          If the file exists, run the rm -f /etc/init.d/hostguard command to delete the file.

     • For OSs that support DEB installation, such as Ubuntu and Debian.
       1. Run the following command to check whether there are hostguard processes:

          ps -ef | grep hostguard

          If there are residual processes, run the kill -9 PID command to stop all residual processes.

       2. Run the following command to check whether the /usr/local/hostguard directory exists:

          ll /usr/local/hostguard

          If the directory exists, run the rm -rf /usr/local/hostguard command to delete it.

       3. Run the following command to check whether the /etc/init.d/hostguard file exists:

          ll /etc/init.d/hostguard

          If the file exists, run the rm -f /etc/init.d/hostguard command to delete the file.

• Uninstalling the Windows agent
  1. (Optional) Disable HSS self-protection.

     If HSS self-protection is enabled, disable it before uninstalling the agent, or the uninstallation will fail. For more information, see What Do I Do If HSS Self-Protection Cannot Be Disabled?

  2. Log in to the server that you want to uninstall the agent.
  3. Click Start and choose Control Panel > Programs. Then select HostGuard and click Uninstall.
     

     • Alternatively, go to the C:\Program File\HostGuard directory and double-click unins000.exe to uninstall the program.
     • If you have created a folder for storing the agent shortcut under the Start menu when installing the agent, you can also choose Start > HostGuard > Uninstall HostGuard to uninstall HostGuard.
  4. In the Uninstall HostGuard dialog box, click Yes.
  5. (Optional) Restart the server.
     • If you have enabled WTP, you need to restart the server after uninstalling the agent. In the Uninstall HostGuard dialog box, click Yes to restart the server.
     • If you have not enabled WTP, you do not need to restart the server. In the Uninstall HostGuard dialog box, click No to skip server restart.