Help Center/ Cloud Eye/ User Guide/ Server Monitoring/ Managing the Agent/ Managing the Agent (Linux)
Updated on 2023-02-27 GMT+08:00
View PDF

Managing the Agent (Linux)

To view, start, stop, update, and uninstall the Agent, you must log in as user root.

Viewing the Agent Version

  1. Log in to the target 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 early version of the Agent is used. Manage the Agent based on the Agent version.
    • If a version is returned, the new version of the Agent is used. Manage the Agent based on the Agent version.
    • If 0 is returned, the Agent is not installed.

Checking the Agent Status (New Version)

Log in to an ECS or BMS as user root and run the following command to check the Agent status:

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

The following message indicates that the Agent is running properly:

"Telescope process is running well."

Starting the Agent (New Version)

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

Restarting the Agent (New Version)

Check the Agent PID.

ps -ef |grep telescope

After the process is forcibly stopped, wait for 3 to 5 minutes for the Agent to automatically restart. Figure 1 shows an operation example.

kill -9 PID

Figure 1 Restarting the Agent

Stopping the Agent (New Version)

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

service 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 collect the ECS or BMS monitoring data every one minute. To use the Agent again, reinstall it by referring to Installing and Configuring the Agent on a Linux ECS or BMS.

Run the following command to uninstall the Agent:

cd /usr/local/uniagent/script/

./uninstall.sh

Before reinstalling the Agent, manually delete the previous Agent installation package. The installation package of the new version of the Agent is stored in /usr/local/uniagent_install_amd64.sh.

Checking the Agent Status (for the Early Version of the Agent)

Log in to an ECS or BMS as user root and run the following command to 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 (for the Early Version of the Agent)

/usr/local/telescope/telescoped start

Restarting the Agent (for the Early Version of the Agent)

/usr/local/telescope/telescoped restart

Stopping the Agent (for the Early Version of the Agent)

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 normally. In this case, run the following command to stop the Agent:

/usr/local/telescope/telescoped stop

Uninstalling the Agent (for the Early Version of the Agent)

Run the following command to uninstall the Agent:

/usr/local/telescope/uninstall.sh

You can manually uninstall the Agent. After the uninstallation, Cloud Eye does not collect the ECS or BMS monitoring data every one minute. 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.

Parent topic: Managing the Agent