Help Center> Application Operations Management> User Guide> Connecting Resources to AOM> Installing the ICAgent (HUAWEI CLOUD Host)
View PDF

Installing the ICAgent (HUAWEI CLOUD Host)

ICAgent is used to collect metrics, logs, and application performance data. For servers that are directly purchased on the Elastic Cloud Server (ECS) or Bare Metal Server (BMS) console, manually install the ICAgent. For hosts purchased through Cloud Container Engine (CCE), the ICAgent is automatically installed.

Prerequisites

  • Before installing the ICAgent, ensure that the time and time zone of the local browser are consistent with those of the server. If multiple servers are deployed, ensure that the local browser and multiple servers use the same time zone and time. Otherwise, metric data of applications and servers displayed on the UI may be incorrect.
  • The ICAgent process needs to be installed and run by the root user.

Installation Methods

There are two methods to install the ICAgent. Note that the two methods are not applicable to container nodes created using ServiceStage or CCE. For container nodes, you do not need to manually install the ICAgent. Instead, you only need to perform certain operations when creating clusters or deploying applications.

For details, see Table 1.

Table 1 Installation methods

Method

Scenario

Initial installation

This method is used when the following conditions are met:

  1. An Elastic IP Address (EIP) has been bound to the server.
  2. The ICAgent has never been installed on the server.

Inherited installation

This method is used when the following conditions are met:

You have multiple servers with ICAgent installed. One server is bound to an EIP, but others are not. The ICAgent has been installed on the server bound to an EIP by using the initial installation method. You can use the inherited method to install the ICAgent on the remaining servers.

See Inherited Installation.

Initial Installation

After you apply for a server and install the ICAgent for the first time, perform the following operations:

  1. Obtain an Access Key ID/Secret Access Key (AK/SK).

    • If you have obtained the AK/SK, skip this step.
    • If no AK/SK are available, obtain them first.

  2. In the navigation pane, choose Configuration Management > Agent Management.
  3. Click Install ICAgent.
  4. (Optional) To prevent your AK/SK from being disclosed, select the check box shown in the following figure to disable historical record collection.

    Figure 1 Copying the ICAgent installation command

  5. Generate the ICAgent installation command, and copy and run it to install the ICAgent.
  6. After the ICAgent is installed, run the following command to enable historical record collection:

    set -o history

    • If the message ICAgent install success is displayed, the ICAgent has been installed in the /opt/oss/servicemgr/ directory. After the ICAgent has been installed, choose Configuration Management > Agent Management to view the ICAgent status.
    • If the ICAgent fails to be installed, uninstall the ICAgent according to Uninstalling the ICAgent by Logging In to the Server and then install it again. If the problem persists, contact technical support.

Follow-up Operations

For more information about how to install, upgrade, and uninstall the ICAgent, see ICAgent Management (HUAWEI CLOUD Host).