yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
c1d4f578e796abdf88145ac664bf12da18eefe2a
doc-exports/docs/ces/umn/ces_01_0036.html
qiujiandong1 c1d4f578e7 CES UMN 20250530 version 
Reviewed-by: Rumpler, Mihály <mihaly.rumpler@t-systems.com>
Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com>
Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
2025-11-18 06:22:57 +00:00

13 KiB
Raw Blame History

Managing the Agent (Linux)

This section describes how to view, start, stop, restart, uninstall, or upgrade the Agent on the Linux platform.

To view, start, stop, restart, or uninstall the Agent, you need to log in to the server as user root.

Viewing the Agent Version

  1. Log in to an ECS as user root.
  2. Run the following command to check the Agent version:

    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 earlier version of the Agent is used. Manage the Agent based on its version.
    • If a version is returned, the new version of the Agent is used. Manage the Agent based on its version.
    • If 0 is returned, the Agent is not installed.

      The new version of the Agent consists of two processes: Telescope and UniAgent. The Telescope process is used to collect and report metrics, and the UniAgent process is used to manage the Telescope lifecycle.

Checking the Agent Status (New Version)

Log in to an ECS or BMS as user root and check the Agent status.

service ces-uniagent status

  • If the command output contains active (running), the UniAgent is running properly and can manage the Telescope lifecycle.
  • If the command output contains inactive (dead), the UniAgent is not running and cannot manage the Telescope lifecycle.

/usr/local/uniagent/extension/install/telescope/telescoped status

  • If the following information is displayed, the Telescope is running properly and can collect and report metrics.
    Telescope process is running well.
  • If the following information is displayed, the Telescope stops working and cannot collect or report metrics.
    Telescope process is not running.

Starting the Agent (New Version)

Start the Agent.

service ces-uniagent start

/usr/local/uniagent/extension/install/telescope/telescoped start

Restarting the Agent (New Version)

Restart the Agent.

service ces-uniagent stop

service ces-uniagent start

/usr/local/uniagent/extension/install/telescope/telescoped restart

Stopping the Agent (New Version)

Log in to an ECS or BMS and stop the Agent.

service ces-uniagent stop

/usr/local/uniagent/extension/install/telescope/telescoped stop

Uninstalling the Agent (New Version)

You can manually uninstall the Agent. After the uninstallation, Cloud Eye does not support monitoring by seconds for ECSs or BMSs. To use the Agent again, reinstall it by referring to Installing and Configuring the Agent on a Linux ECS or BMS.

Uninstall the Agent.

cd /usr/local/uniagent/script/

./uninstall.sh

Before reinstalling the Agent, run the following command to manually remove the original Agent installation package:
rm /usr/local/uniagent_install_amd64.sh

Checking the Agent Status (Earlier Version)

Log in to an ECS or BMS as user root and check the Agent status.

service telescoped status

The following message indicates that the Agent is running properly:

"Active (running) or "Telescope process is running well."

Starting the Agent (Earlier Version)

Start the Agent.

/usr/local/telescope/telescoped start

Restarting the Agent (Earlier Version)

Restart the Agent.

/usr/local/telescope/telescoped restart

Stopping the Agent (Earlier Version)

Log in to an ECS or BMS and run the following command to stop the Agent:

service telescoped stop

If the Agent installation fails, it may be impossible to stop the Agent. In this case, run the following command to stop the Agent:

/usr/local/telescope/telescoped stop

Uninstalling the Agent (Earlier Version)

Uninstall the Agent.

/usr/local/telescope/uninstall.sh

You can manually uninstall the Agent. After the uninstallation, Cloud Eye does not support monitoring by seconds (60s by default) for ECSs or BMSs. To use the Agent again, reinstall it by referring to Installing and Configuring the Agent on a Linux ECS or BMS. Before reinstalling the Agent, manually delete the previous Agent installation package.

Upgrading the Agent

If the current Agent version is not the desired one, you can upgrade the Agent. The Cloud Eye Agent will be continuously upgraded to provide you with a better monitoring experience.

  1. Uninstall the Agent of the current version.
  2. Install the Agent of the latest version by running the command in Installing the Agent on a Linux Server.
Parent topic: Managing the Agent