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

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

This section describes how 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. If 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.

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

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 ECS instance.
     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.

     Note If 360 Total Security is installed on your ECS instance, the CloudMonitor agent fails to be installed or the service fails to start. We recommend that you set the C:\Program Files\Alibaba\ directory as a trusted directory.
   • 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

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

     Note If 360 Total Security is installed on your ECS instance, the CloudMonitor agent fails to be installed or the service fails to start. We recommend that you set the C:\Program Files\Alibaba\ directory as a trusted directory.
   • 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 Step 2: Install and configure the CloudMonitor agent 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 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 commands to delete the cloudmonitor directory:

     rm -rf /usr/local/cloudmonitor

References

• How do I troubleshoot an abnormal stop of the CloudMonitor agent?
• How can I restart the CloudMonitor agent for C++?
• How do I uninstall the CloudMonitor agent?
• How do I troubleshoot the automatic installation failure of the CloudMonitor agent on an Alibaba Cloud instance?
• How do I troubleshoot the heartbeat check failure that is reported by the CloudMonitor agent?
• What can I do if CloudMonitor fails to identify multiple hosts that are deployed by using the same image?