Help Center/ Cloud Eye/ FAQs/ Troubleshooting/ Server Monitoring/ Troubleshooting an Agent Installation Failure
Updated on 2026-06-26 GMT+08:00
View PDF
Share

Troubleshooting an Agent Installation Failure

If the agent fails to be installed, you can refer to this section to locate the fault.

Scenario

Possible Causes

Solution

Manually installing Agents on a single host/remotely installing agents in batches

The Agent has been installed on the current host. Before the Agent is reinstalled, the uninstalled Agent has residual files.

Check whether all files in the Agent installation directory are deleted. If there are residual files, manually delete them from the following directories:

Windows:
  • New version: C:\Program Files\uniagent
  • Earlier version: C:\Program Files\telescope

Linux:

  • New version: 
    rm /usr/local/uniagent
  • Earlier version: 
    rm /usr/local/telescope

Both earlier and new versions are installed on the host, and the configuration file is lost.

Uninstall the Agent installed on the current host and install the latest Agent. For details about how to uninstall the agent, see Uninstalling the Agent.

A Windows ECS cannot obtain metadata through 169.254.169.254.
  1. Submit a service ticket to contact customer service for ECS technical support.
  2. Workaround: Add -r {region_id} to the installation command. The region ID varies depending on the region. For example, if the ECS is located in CN North-Beijing1, the region ID is cn-north-1. For details about the region IDs of other regions, see Regions and Endpoints.

The WMI service is disabled.
To enable the WMI service, perform the following:
  1. On Control Panel, choose Windows Tools.
  2. In the displayed window, double-click Services.
  3. On the Services window, change Startup type of WMI Performance Adapter to Manual or Automatic, and start the service.

The wget tool is missing.

Download and install the wget tool. For details, see https://ftp.gnu.org/gnu/wget/.

The current host is a private image.

Private images do not support Agent installation.

Installing the Agent in one-click/Manually installing the Agent

Incorrect DNS settings.

Change the DNS server address. For details, see Checking/Modifying the DNS and Security Group Configurations.
Parent topic: Server Monitoring