Help Center/ Cloud Eye/ User Guide/ Cloud Resource Monitoring/ Server Monitoring/ Cloud Eye Plug-in (Agent)/ Managing the Agent
Updated on 2025-08-07 GMT+08:00
View PDF
Share

Managing the Agent

After the Agent is installed, you can view, start, stop, update, or uninstall it as needed. This section describes how to manage the Agent on Linux and Windows systems.

You can only manage the Agent as an administrator (root user for Linux and Administrator user for Windows). Any improper use of this account may cause system stability or data security issues. Exercise caution when using this account.

Prerequisites

  • You have installed the Agent on a server. For details, see Installing the Agent.
  • You have confirmed the Agent version. The Agent has two versions: new and old. The operations vary according to the version.
    Linux:
    1. Log in to the server as user root.
    2. 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, an early version of the Agent is used. Manage the Agent using the instructions for the early version.
      • If a particular version is returned, the new version of the Agent is used. Manage the Agent using the instructions for the early version.
      • If 0 is returned, the Agent is not installed.
    Windows: Determine the Agent version based on the installation path.
    • New version: C:\Program Files\uniagent\extension\install\telescope
    • Earlier version: C:\Program Files\telescope

Checking the Agent Status

After the Agent is installed, you can also log in to the server to check its running status.

Linux:

  1. Log in to the server as user root.
  2. Check the Agent status. 
    /usr/local/uniagent/extension/install/telescope/telescoped status
  3. Check whether the following information is displayed. If so, the Agent is running properly. 
    "Telescope process is running well."

Windows:

In the task manager, check the status of the telescope process.

  1. Log in to the server as user root.
  2. Check the Agent status. 
    service telescoped status
  3. Check whether the following information is displayed. If so, the Agent is running properly. 
    "Active (running)" or "Telescope process is running well."

Stopping the Agent

You can disable the Agent during monitoring policy changes or temporary system maintenance.

Linux:
  1. Log in to the server as user root.
  2. Stop the Agent. 
    service uniagent stop
/usr/local/uniagent/extension/install/telescope/telescoped stop
Windows:
  1. Go to the C:\Program Files\uniagent\extension\install\telescope directory for storing the Agent installation package.
  2. Double-click the shutdown.bat script to stop the Agent.
Linux:
  1. Log in to the server as user root.
  2. Stop the Agent. 
    service telescoped stop
Windows:
  1. Go to the C:\Program Files\telescope directory for storing the Agent installation package.
  2. Double-click the shutdown.bat script to stop the Agent.

Starting the Agent

If the Agent is in the Stopped state, perform the following operations to start the Agent.

Linux:
  1. Log in to the server as user root.
  2. Start the Agent. 
    /usr/local/uniagent/extension/install/telescope/telescoped start
Windows:
  1. Go to the C:\Program Files\uniagent\extension\install\telescope directory for storing the Agent installation package.
  2. Double-click the start.bat script to start the Agent.
Linux:
  1. Log in to the server as user root.
  2. Start the Agent. 
    /usr/local/telescope/telescoped start
Windows:
  1. Go to the C:\Program Files\telescope directory for storing the Agent installation package.
  2. Double-click the start.bat script to start the Agent.

Restarting the Agent

If the Agent process is faulty, restart the Agent. If the fault persists after the restart, the Agent files may be damaged. In this case, reinstall the Agent. For details, see Agent Installation and Configuration.

Linux:
  1. Log in to the server as user root.
  2. Restart the Agent. 
    /usr/local/uniagent/extension/install/telescope/telescoped restart

Windows:

The Agent cannot be restarted.

Linux:
  1. Log in to the server as user root.
  2. Restart the Agent. 
    /usr/local/telescope/telescoped restart

Windows:

The Agent cannot be restarted.

Uninstalling the Agent

If you need to log in to the server to upgrade the Agent, uninstall the Agent of an earlier version.

Linux:
  1. Log in to the server as user root.
  2. Uninstall the Agent. 
    bash /usr/local/uniagent/script/uninstall.sh
Windows:
  1. Go to the C:\Program Files\uniagent\script directory for storing the Agent installation package.
  2. Double-click the uninstall.bat script to uninstall the Agent.

    After you run the Agent uninstallation command on a Windows server, go to the C:\Program Files\uniagent directory to check whether there are residual files. If there are, manually delete this directory.

Linux:
  1. Log in to the server as user root.
  2. Uninstall the Agent. 
    /usr/local/telescope/uninstall.sh
Windows:
  1. Go to the C:\Program Files\telescope directory for storing the Agent installation package.
  2. Double-click the uninstall.bat script to uninstall the Agent.

    After you run the Agent uninstallation command on a Windows server, go to the C:\Program Files\telescope directory to check whether there are residual files. If there are, manually delete this directory.

Helpful Links

What Are Agent Statuses and Troubleshooting Methods?

Parent Topic: Cloud Eye Plug-in (Agent)