Upgrading the Agent

The Cloud Eye Agent collects OS-level metrics from the target host, which is valuable for server monitoring. The Cloud Eye Agent regularly updates to add new features, fix stability issues, and optimize performance. If the Agent of the early architecture cannot meet the requirements, you can upgrade the Agent. For details about the Agent version, see Agent Features per Version.

The Cloud Eye Agent will be continuously upgraded to provide you with a better monitoring experience. This section describes how to upgrade the Agent.

Constraints

You cannot upgrade the Agent in the following regions: CN South-Guangzhou-InvitationOnly, LA-Sao Paulo1, and LA-Mexico City1.

Applicable Scenarios

**Table 1** Applicable scenarios
Installation Method	Scenario	Constraints
Automatically Upgrading Agents for All Servers	Cloud Eye supports automatic Agent upgrade on the management console. If you want to upgrade the Agents of all servers to the same version, you are advised to use the fully automated upgrade function to perform the upgrade for servers that support one-click installation. After the Agent installation is complete, you can upgrade the Agents for servers that do not support one-click installation and those failed the automatic installation.	This method only applies to servers with the Agent installed and in the Running state.
Automatically Upgrading the Agents for Selected Servers	Cloud Eye supports automatic Agent upgrade on the management console. If you only need to install the Agents for some servers that support one-click installation, or upgrade the Agents to different versions for different servers, you can use related console functions to automate the process.
Manually Upgrading the Agent	For servers that do not support automatic upgrade using one-click installation or those failed the automatic upgrade, you can manually upgrade the Agents for them. For details about supported OSs, see What OSs Does the Agent Support?	None

Automatically Upgrading Agents for All Servers

Log in to the Cloud Eye console.
In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
Choose Install & Upgrade the Agent > Install and Upgrade Agent on All Servers. The Agent installation and upgrade guide will be displayed on the right.
In the Agent installation and upgrade guide, select Upgrade the Agent.
Select the target Agent edition.
- Basic edition provides basic OS monitoring metrics, including CPU, memory, file system, disk, NIC, and network metrics.
- Enhanced edition provides GPU and BMS hardware monitoring, in addition to the capabilities provided in the basic edition.
Click OK.
Check the upgrade results.
1. In the navigation pane, choose Task Center.
2. In the right pane, click the Agent Maintenance tab to view the upgrade task status.
  - If Status is Successful, the Agents are upgraded. In the server monitoring list, the Agent version of the target servers is the latest.
  - If Status is Timeout, click Retry in the Operation column.

Automatically Upgrading the Agents for Selected Servers

Log in to the Cloud Eye console.
In the navigation pane, choose Server Monitoring > Elastic Cloud Server.
In the server list, select the servers you want to upgrade.
Choose Install & Upgrade the Agent > Batch Install and Upgrade Agent. The Agent installation and upgrade guide will be displayed on the right.
On the Batch Modify Servers page, check the servers with ongoing tasks.
If any inoperable servers are identified, rectify the fault by referring to Why Cannot I Install or Upgrade Agents in Batches?
Click Next.
In the Agent installation and upgrade guidelines, select Upgrade the Agent.
Select the target Agent edition.
- Basic edition provides basic OS monitoring metrics, including CPU, memory, file system, disk, NIC, and network metrics.
- Enhanced edition provides GPU and BMS hardware monitoring, in addition to the capabilities provided in the basic edition.
Click OK.
Check the upgrade results.
1. In the navigation pane, choose Task Center.
2. In the right pane, click the Agent Maintenance tab to view the upgrade task status.
  - If Status is Successful, the Agents are upgraded. In the server monitoring list, the Agent version of the target servers is the latest.
  - If Status is Timeout, click Retry in the Operation column.

Manually Upgrading the Agent

For servers that do not support one-click installation or those failed the automatic upgrade, you must run the script to manually upgrade the Agents for them. You need to uninstall the Agent of an earlier version before installing a later one.

Log in to an ECS as user root.
Run the following command to check whether the current Agent is Uniagent or telescope:
```
if [[ -f /usr/local/uniagent/extension/install/telescope/bin/telescope ]]; then /usr/local/uniagent/extension/install/telescope/bin/telescope -v; elif [[ -f /usr/local/telescope/bin/telescope ]]; then echo "old agent"; else echo 0; fi
```
- If old agent is returned, the Agent of an earlier version (telescope) is used.
- If a version ID is returned, the Agent of the new version (Uniagent) is used.
- If 0 is returned, the Agent is not installed.
Uninstall the Agent.
- Earlier version: If old agent is returned in 2, run the command in Earlier Version.
- New version: If a version number is returned in 2, run the command in New Version.
Install the Agent of the latest version by running the command in Installing the Agent on a Single Server.

Log in to the Windows ECS as an administrator.
Determine the current Agent version based on the Agent installation path.
- New version: C:\Program Files\uniagent\extension\install\telescope
- Earlier version: C:\Program Files\telescope
Uninstall the current Agent by running the command in Uninstalling the Agent.
Install the Agent of the latest version by running the command in Installing the Agent on a Single Server.