Installing an ICAgent (Huawei Cloud Host)

ICAgents collect metrics, logs, and application performance data in real time. For hosts purchased from the ECS or BMS console, you need to manually install the ICAgent. For hosts purchased from the CCE console, the ICAgent is automatically installed.

Prerequisites

Before installing an 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.
An ICAgent process needs to be installed and run by the root user.

Installation Methods

There are two methods to install an 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 an 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 condition is met: An ICAgent has never been installed on your server.
Inherited installation	This method is used when the following conditions are met: You have multiple servers where an ICAgent is to be installed. One server is bound to an EIP, but others are not. An 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 an ICAgent on the remaining servers. See Inherited Installation.

Initial Installation

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

Obtain an Access Key ID/Secret Access Key (AK/SK).
- If you have obtained the AK/SK, skip this step.
- If you have not obtained an AK/SK, obtain them first.
In the navigation pane, choose Configuration Management > Agent Management.
Select Other: custom hosts, and click Install ICAgent.
(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
Generate the ICAgent installation command, and copy and run it to install an ICAgent.
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 is successfully installed, choose Configuration Management > Agent Management in the navigation pane on the left, and select Other: custom hosts to view the ICAgent status of the server.
- 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.