Updated on 2024-08-07 GMT+08:00

Managing the Agent

Managing the Agent (Linux)

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

  • Checking the Agent Version
    1. Log in to the 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)

    Run the following command to start the Agent:

    /usr/local/uniagent/extension/install/telescope/telescoped start
  • Restarting the Agent (New Version)

    Check the Agent PID.

    /usr/local/uniagent/extension/install/telescope/telescoped restart
    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)

    Run the following command to uninstall the Agent:

    bash /usr/local/uniagent/script/uninstall.sh

    You can manually uninstall the Agent. After that, Cloud Eye does not proactively collect monitoring data of the server. To use the Agent again, reinstall it by referring to Procedure or Procedure.

  • Checking the Agent Status (Early Version)

    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 (Early Version)

    Run the following command to start the Agent:

    /usr/local/telescope/telescoped start
  • Restarting the Agent (Early Version)

    Run the following command to restart the Agent:

    /usr/local/telescope/telescoped restart
  • Stopping the Agent (Early 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 normally. In this case, run the following command to stop the Agent:

    /usr/local/telescope/telescoped stop

  • Uninstalling the Agent (Early Version)

    Run the following command to uninstall the Agent:

    /usr/local/telescope/uninstall.sh

    You can manually uninstall the Agent. After that, Cloud Eye does not proactively collect monitoring data of the server. To use the Agent again, reinstall it by referring to Procedure or Procedure.

Managing the Agent (Windows)

In Windows, the Agent has two versions: new version and earlier version. Determine the Agent version based on the installation path.

  • The default installation path of the new Agent is C:\Program Files\uniagent\extension\install\telescope.
    • Checking the Agent Status

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

    • Starting the Agent

      In the C:\Program Files\uniagent\extension\install\telescope directory where the Agent installation package is stored, double-click the start.bat script.

    • Stopping the Agent

      In the C:\Program Files\uniagent\extension\install\telescope directory where the Agent installation package is stored, double-click the shutdown.bat script.

    • Uninstalling the Agent

      In the C:\Program Files\uniagent\script directory where the Agent installation package is stored, double-click the uninstall.bat script.

  • The default installation path of the early version of the Agent is C:\Program Files\telescope.
    • Checking the Agent Status

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

    • Starting the Agent

      In the C:\Program Files\telescope directory where the Agent installation package is stored, double-click the start.bat script.

    • Stopping the Agent

      In the C:\Program Files\telescope directory where the Agent installation package is stored, double-click the shutdown.bat script.

    • Uninstalling the Agent

      In the C:\Program Files\telescope directory where the Agent installation package is stored, double-click the uninstall.bat script.