This topic describes how to automatically install, manually 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

Notice 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 Monitor Install Guide 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++.
    • WindowsWindows ECS instance
      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 properly running.

    • LinuxLinux ECS instance
      1. Click the Copy icon in the Installation Command section.
      2. Log on to the ECS instance 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 properly running:
        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 host that is not provided by Alibaba Cloud

Notice If you fail to manually install the CloudMonitor agent for C++ on a host that is not provided by Alibaba Cloud or you want to upgrade the CloudMonitor agent for C++ on the host, you must uninstall the CloudMonitor agent for C++ 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 Monitor Install Guide 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++.
    • WindowsWindows host
      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 properly running.

    • Linux
      • If the host is accessible over the Internet, perform the following steps:Linux host 1
        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 properly running:
          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.
        Linux host 2
        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 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 properly running:
          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. Use an administrator account to log on to the host where the CloudMonitor agent for C++ resides.
    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