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

What Should I Do If Agent Installation Failed?

If you have used HSS of an earlier version, and installed the agent on the new version HSS, but the page still displays that agent is not installed, see What Can I Do If the Agent Status Is Still "Not installed" After Installation?

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.

Symptoms

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

Solution

  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 hss-agent.region code.myhuaweicloud.com
      • Windows server: ping -n 1 hss-agent.region code.myhuaweicloud.com

        Each region has a unique region code. For details about the region code, see Regions and Endpoints.

        Take CN North-Beijing1 as an example. The complete command is as follows: ping -c 1 hss-agent.cn-north-1.myhuaweicloud.com

    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.

Parent topic: Agent FAQs

Agent FAQs FAQs

more