All Products
Search

This Product

    CloudMonitor:Install and uninstall the CloudMonitor agent for C++

    Document Center

    CloudMonitor:Install and uninstall the CloudMonitor agent for C++

    Last Updated:May 25, 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.

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

    In most cases, we recommend that you use the CloudMonitor console to automatically install the CloudMonitor agent for C++ on Elastic Compute Service (ECS) instances.

    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 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. 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 Copy 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

    You can only 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 Copy 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 the "Step 2: Install and configure the CloudMonitor agent" section of How do I report the monitoring data of hosts that are not provided by Alibaba Cloud to CloudMonitor by using an NGINX proxy server?

        1. Install a proxy server.

          An NGINX proxy server is used in this example. For more information, see Substep 1 to Substep 4 in the "Step 1: Deploy an NGINX proxy server" section of How do I report the monitoring data of hosts that are not provided by Alibaba Cloud to CloudMonitor by using an NGINX proxy server?

        2. Click the Copy 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 by using 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 command to delete the cloudmonitor directory:

      rm -rf /usr/local/cloudmonitor

    References