All Products
Search
Document Center

:Install and uninstall the CloudMonitor agent for C++

Last Updated:Nov 03, 2023

This topic describes how to automatically install, manually install, and uninstall the CloudMonitor agent for C++.

Important You can manage the CloudMonitor agent only by using an administrator account. For Linux operating systems, use the root user account. For Windows operating systems, use the Administrator account. If you use an administrator account, certain risks may occur. For example, system stability or data security issues may occur. Proceed with caution.

(Recommended) Automatically install the CloudMonitor agent for C++

We recommend that you use the related features in the CloudMonitor console to automatically install the CloudMonitor agent for C++ on Elastic Compute Service (ECS) instances and third-party hosts.

Before you automatically install the CloudMonitor agent for C++ on a third-party host, make sure that you have registered the host as an Alibaba Cloud managed instance. For more information, see Manage servers that are not provided by Alibaba Cloud.

  1. Log on to the CloudMonitor console.
  2. In the left-side navigation pane, click Host Monitoring.

  3. On the Host Monitoring page, select the ECS instances on which you want to install or upgrade the CloudMonitor agent for C++ and click Batch Install.

  4. In the message that appears, click Confirm.

    The installation or upgrade process requires about 5 minutes to complete. When the agent status changes from Installing to Running, the CloudMonitor agent for C++ is installed or upgraded.

    Note
    • For newly purchased ECS instances, you can click Install/Upgrade Agent in the upper-left corner, and then turn on Automatically Install CloudMonitor Agent on Newly Purchased ECS Instances on the Automatic Installation tab of the Install CloudMonitor Agent panel. If you turn off the switch, you must manually install the CloudMonitor agent for C++ on each ECS instance.

    • If the agent status on an ECS instance is Stopped or Failed to install, you can click Reinstall/Upgrade to reinstall the agent.

Manually install the CloudMonitor agent for C++ on a host

Manually install the CloudMonitor agent for C++ on an ECS instance

If the CloudMonitor agent for C++ fails to be automatically installed on an ECS instance, you must manually install it.

Note

If the CloudMonitor agent for C++ fails to be automatically installed or upgraded on an ECS instance, you must uninstall the CloudMonitor agent for C++ before you manually install it. For more information about how to uninstall the CloudMonitor agent for C++, see How do I uninstall the CloudMonitor agent?

  1. Log on to the CloudMonitor console.

  2. In the left-side navigation pane, click Host Monitoring.

  3. On the Host Monitoring page, click Install/Upgrade Agent in the upper-left corner.

  4. In the Install CloudMonitor Agent panel, click the Script Installation tab.

  5. On the Script Installation tab, select the region and operating system of the ECS instance. Then, copy and run the displayed commands to install the CloudMonitor agent for C++.

    Windows

    1. Download the agent package of the 32-bit version or 64-bit version based on the operating system of the host.

    2. Use an administrator account to log on to the ECS instance on which you want to install the CloudMonitor agent for C++.

    3. Create the C:\Program Files\Alibaba\cloudmonitor directory.

    4. Upload the agent package to the ECS instance and decompress the agent package to the C:\Program Files\Alibaba\cloudmonitor directory.

    5. Open the Command Prompt.

      Press Win+R. In the Run dialog box, enter cmd and click OK.

    6. Run the following commands to install the CloudMonitor agent for C++:

      cd C:\Program Files\Alibaba\cloudmonitor\bin

      argusagent_service.exe install

    7. Run the following command to start the CloudMonitor agent for C++:

      net start argusagent

    8. View the status of the CloudMonitor agent for C++.

      1. Open the Services window.

        Press Win+R. In the Run dialog box, enter services.msc and click OK.

      2. View the status of the argusagent service.

        If the status of the argusagent service is Running, the CloudMonitor agent is running properly.

    Linux

    1. Click the 复制 icon in the Installation Command section.

    2. Log on to the host on which you want to install the CloudMonitor agent for C++ as the root user.

    3. Paste and run the command to install the CloudMonitor agent for C++.

    4. Run the following command to view the status of the CloudMonitor agent:

      ps aux | grep argusagent | grep -v grep

      The following output indicates that the CloudMonitor agent is running properly:

      root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
      root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent

Manually install the CloudMonitor agent for C++ on a third-party host

Note

If the CloudMonitor agent for C++ fails to be manually installed on a third-party host or you want to upgrade the agent on the host, you must uninstall the agent before you manually install it again. For more information about how to uninstall the CloudMonitor agent for C++, see How do I uninstall the CloudMonitor agent?

  1. Log on to the CloudMonitor console.

  2. In the left-side navigation pane, click Host Monitoring.

  3. On the Host Monitoring page, click Install/Upgrade Agent in the upper-left corner.

  4. In the Install CloudMonitor Agent panel, click the Script Installation tab.

  5. On the Script Installation tab, select the region and operating system of the host. Then, copy and run the displayed commands to install the CloudMonitor agent for C++.

    Windows

    1. Download the agent package of the 32-bit version or 64-bit version based on the operating system of the host.

    2. Download the accesskey.properties configuration file.

    3. Use an administrator account to log on to the ECS instance on which you want to install the CloudMonitor agent for C++.

    4. Create the C:\Program Files\Alibaba\cloudmonitor directory.

    5. Upload the agent package to the ECS instance and decompress the agent package to the C:\Program Files\Alibaba\cloudmonitor directory.

    6. Upload the configuration file to the C:\Program Files\Alibaba\cloudmonitor\local_data\conf directory of the host.

    7. Open the command prompt window.

      Press Win+R. In the Run dialog box, enter cmd and click OK.

    8. Run the following commands to install the CloudMonitor agent for C++:

      cd C:\Program Files\Alibaba\cloudmonitor\bin

      argusagent_service.exe install

    9. Run the following command to start the CloudMonitor agent for C++:

      net start argusagent

    10. View the status of the CloudMonitor agent for C++.

      1. Open the Services window.

        Press Win+R. In the Run dialog box, enter services.msc and click OK.

      2. View the status of the argusagent service.

        If the status of the argusagent service is Running, the CloudMonitor agent is running properly.

    Linux

    • If the host is accessible over the Internet, perform the following steps:

      1. Click the 复制 icon in the Installation Command section.

      2. Log on to the host on which you want to install the CloudMonitor agent for C++ as the root user.

      3. Paste and run the command to install the CloudMonitor agent for C++.

      4. Run the following command to view the status of the CloudMonitor agent:

        ps aux | grep argusagent | grep -v grep

        The following output indicates that the CloudMonitor agent is running properly:

        root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
        root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent
    • If the host is inaccessible over the Internet, perform the following steps:

      Note

      If the CloudMonitor agent for C++ is installed on the host but the host is inaccessible over the Internet, the monitoring data cannot be reported to CloudMonitor. You must configure a proxy server in the CloudMonitor agent for C++. For more information, see Substep 2 in Step 2: Install and configure the CloudMonitor agent.

      1. Install a proxy server.

        An NGINX proxy server is used in this example. For more information, see Substep 1 to Substep 4 in Step 1: Deploy an NGINX proxy server.

      2. Click the 复制 icon in the Installation Command section.

      3. Log on to the host on which you want to install the CloudMonitor agent for C++ as the root user.

      4. Paste and run the command to install the CloudMonitor agent for C++.

        Replace the parameters in the following command with the actual values. Keep the default values of other parameters.

        CMS_HTTP_PROXY=<Address of the proxy server:Port number>
      5. Run the following command to view the status of the CloudMonitor agent:

        ps aux | grep argusagent | grep -v grep

        The following output indicates that the CloudMonitor agent is running properly:

        root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
        root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent

Uninstall the CloudMonitor agent for C++

After you uninstall the CloudMonitor agent for C++ from a host, you cannot monitor the host in real time in the CloudMonitor console. However, you can view the historical metric data.

Windows

  1. Log on to the host where the CloudMonitor agent for C++ resides as the administrator.

  2. Open the command prompt window.

    Press Win+R. In the Run dialog box, enter cmd and click OK.

  3. Run the following command to stop the CloudMonitor agent for C++:

    net stop argusagent

  4. Run the following command to uninstall the CloudMonitor agent for C++:

    "C:\Program Files\Alibaba\cloudmonitor\bin\argusagent_service.exe" uninstall

  5. Run the following commands to delete the cloudmonitor directory:

    cd C:\Program Files\Alibaba

    rd /s /q cloudmonitor

Linux

  1. Log on to the host where the CloudMonitor agent for C++ resides as the root user.

  2. Run the following command to stop the CloudMonitor agent for C++:

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop

  3. Run the following command to uninstall the CloudMonitor agent for C++:

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh uninstall

  4. Run the following commands to delete the cloudmonitor directory:

    rm -rf /usr/local/cloudmonitor

References