What Should I Do If the Agent Installation Fails?
Symptom
- If the one-click Agent installation fails, the DNS configuration may be incorrect. Check and modify the DNS configuration by referring to Checking/Modifying the DNS and Security Group Configurations. If the DNS configuration is correct but the installation still fails, submit a service ticket to contact O&M personnel.
- If you fail to log in to the server or manually install the Agent by clicking Install Remotely, locate the fault by referring to Figure 1.
Incorrect DNS Configuration
Change the DNS server address. For details, see Checking/Modifying the DNS and Security Group Configurations.
Both Earlier and New Versions of the Agent Are Installed
Both earlier and new versions of the Agent are installed on the server, causing configuration file loss. Log in to the server and check whether the manifest.json configuration file exists. The path of the configuration file is:
- Linux:
/usr/local/uniagent/extension/holder/telescope/manifest.json
- Windows:
C:\Program Files\uniagent\extension\holder\telescope\manifest.json
If the configuration file cannot be found in the path, uninstall the Agent and install the latest Agent. For details about how to uninstall the agent, see Uninstalling the Agent.
Residual Files Exist After the Agent Is Uninstalled
The Agent has been installed on the current server. 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
- New version:
The Wget Tool Is Missing on the Linux Server
Wget is an open-source command-line network download tool used to download files from HTTP, HTTPS, FTP, and other protocols. The installation of the Agent on a Linux server depends on Wget to pull the installation script. If Wget is not installed, the error message "command not found" is displayed, the download fails, and the installation process is interrupted.
- Run the following command. If the message "command not found" is displayed, Wget is not installed on the server.
wget --version
- Download and install the wget tool. For details, see https://ftp.gnu.org/gnu/wget/.
The WMI Service Is Disabled in Windows
The Windows Management Instrumentation (WMI) service provides unified system management APIs for Windows. It allows you to locally and remotely query and manage system resources such as hardware, OSs, applications, services, processes, and performance counters. After this service is disabled, the Agent that depends on it cannot collect Windows metrics such as CPU, memory, disk, process, and network metrics. As a result, monitoring data is missing.
Search for services.msc in the search box and open it. Check the status of Windows Management Instrumentation. If the status is Disabled, perform the following steps to start the WMI service:
- Right-click Windows Management Instrumentation and choose Properties from the shortcut menu.
- Set the startup type to Automatic.
- Click OK.
- Right-click Windows Management Instrumentation and choose Start from the shortcut menu.
The Windows OS Cannot Obtain Metadata
A Windows ECS cannot obtain metadata through 169.254.169.254.
- Submit a service ticket to contact customer service for ECS technical support.
- 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.
Submitting a Service Ticket
If the problem persists, submit a service ticket.
What is your overall rating for this page?
Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot
