Help Center> Host Security Service (New)> FAQs> Agent FAQs> What Should I Do If Agent Installation Failed?
Updated on 2024-01-16 GMT+08:00

What Should I Do If Agent Installation Failed?

If this is the first time you install the agent, and the installation failed, rectify the fault by following the instructions provided in this section.


The agent fails to be installed by running commands. The server list page on the console still indicates that the agent is not installed.

Possible Causes


  1. Check whether the SELinux firewall of the server is disabled.

    • If it is, go to the next step.
    • If it is not, disable it and install the agent again.

  2. Check whether there is an EIP bound to the server.

    • If yes, go to the next step.
    • If there is not, bind an EIP to the server and reinstall the agent.

  3. Check whether the installation command is suitable for the server region and OS.

    1. Switch to the server region.
    2. Copy the installation commands suitable for your server OS.
      • Run 32-bit installation commands on a 32-bit server.
      • Run 64-bit installation commands on a 64-bit server.
    • If yes, go to the next step.
    • If the commands you used are incorrect, install the agent again with correct ones.

  4. Check whether the installation was performed by user root.

    • If yes, go to the next step.
    • If it was not, install the agent again as user root.

  5. Check whether the DNS of the server can resolve the domain name for downloading the agent.

    1. Run the following command to check the parsing result:
      • Linux server: ping -c 1
      • Windows server: ping -n 1
    2. Check the command execution result.
      • If the resolved IP address is displayed, the DNS resolution is normal. Go to the step 6.
      • If name or service not known is displayed or no IP address is resolved, the DNS resolution fails. The agent package can only be downloaded over an intranet connection. Ensure you have configured a private DNS server before downloading it. For more information, see Changing the DNS Server Address of an ECS and Private DNS Server Address of Huawei Cloud.

  6. Uninstall the agent as user root and forcibly install it.

    • If the installation is successful, no further action is required.
    • If the installation fails, contact technical support.

Agent FAQs FAQs