Installing a UniAgent

Installation Prerequisite

Ensure that the network between the installation host and the host where the UniAgent is to be installed is normal.

Manual Installation

When installing a UniAgent for the first time, you must install it manually.

1. Log in to the AOM 2.0 console.
2. In the navigation pane, choose Collection Management.
3. In the navigation tree on the left, choose UniAgent > VM Access. On the displayed page, click Install UniAgent in the upper right corner. Then, choose Manual.
4. On the Install UniAgent page, set parameters.

   Table 2 Parameters for manual installation

   Parameter	Description	Example
   UniAgent Version	Version of a UniAgent. This parameter is mandatory.	1.0.8
   Access Mode	There are two access modes: direct access and proxy access. Direct access: A host is directly accessed. Proxy access: Select a proxy area where a proxy has been configured and remotely install the UniAgent on a host through the proxy.	Direct access
   Installation Command	Command for installing the UniAgent. Commands for Linux and Windows are different. Click to copy the installation command. Linux set +o history; curl -k -X GET -m 20 --retry 1 --retry-delay 10 -o /tmp/install_uniagent https://aom-uniagent-xxxxxx/install_uniagent.sh;bash /tmp/install_uniagent -a xxxxxxxxxx -s xxxxxxxxxx -p xxxxxx -d https://aom-uniagent-xxxxxx -m https://uniagent.master.cnxxxxxx,https://xx.xx.xx.xx:xxxx -v 1.x.x set -o history; Windows Download the installation package from https://aom-uniagent-{region_name}.obs.{region_name}.{site domain name suffix}/ +uniagentd-{version}-win32.zip. {region_name} and {version} can be obtained from the installation page. region_name: domain name or IP address of the server where the REST service is deployed. The value varies depending on services and regions. Site domain name suffix: site domain name suffix. version: version of the installed UniAgent. Decompress the package, click uniagentd.msi, and specify path C:\uniagentd for installation. Modify the uniagentd.conf file in C:\uniagentd\conf and enter the following configuration: ak=xxxxxxxxxxxxxx sk=xxxxxxxxxxxxx master=https://uniagent.master.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx Run start.bat in the C:\uniagentd\bin directory as the administrator. NOTE: If you need to verify the SHA256 value of the Windows installation package, check the file downloaded from https://aom-uniagent-{region_name}.obs.{region_name}.{site domain name suffix}/uniagentd-{version}-win32.zip.sha256.	Copy the Linux installation command.

5. Copy the installation command and run it on the host to install the UniAgent.
6. View the information on the VM Access page.

Remote Installation

1. Log in to the AOM 2.0 console.
2. In the navigation pane, choose Collection Management.
3. In the navigation tree on the left, choose UniAgent > VM Access. On the displayed page, click Install UniAgent in the upper right corner.
4. On the Install UniAgent page, choose Remote and set parameters.

   Table 3 Parameters for remotely installing a UniAgent

   Parameter	Description	Example
   UniAgent Version	Version of a UniAgent. This parameter is mandatory.	1.0.8
   Access Mode	There are two access modes: direct access and proxy access. Direct access: A host is directly accessed. Proxy access: Select a proxy area where a proxy has been configured and remotely install the UniAgent on a host through the proxy.	Direct access
   Proxy Area	When Access Mode is set to Proxy access, you need to select a proxy area or add a proxy area. A proxy area is used to group and manage proxies. A proxy must be a host installed with a UniAgent.	-
   Installation Host	An installation host is used to execute commands for remote installation. This parameter is mandatory. If no installation host has been configured, perform the following steps: Select Configure Installation Host from the drop-down list. In the dialog box that is displayed, select the host to be set as an installation host and specify its name. Click OK.	-
   Hosts to Be Installed with UniAgents	Detailed information about the host where the UniAgent is to be installed. This parameter is mandatory. Click Add Host and enter the following information: Host IP Address: IP address of a host. OS: operating system of the host, which can be Linux or Windows. Login Account: account for logging in to the host. If Linux is used, use the root account to ensure that you have sufficient read and write permissions. Login Port: port for accessing the host. Authentication Mode: Currently, only password-based authentication is supported. Password: password for logging in to the host. Connectivity Test Result: shows whether the network between the installation host and the host where the UniAgent is to be installed is normal. Operation: Delete, Copy, or Test Connectivity. NOTE: You can click Add Host to add up to 100 hosts.	-
   Install ICAgent	An ICAgent is a plug-in for collecting metrics and logs. The Install ICAgent option is enabled by default. It is optional. Enter an AK and SK to install an ICAgent.	-

5. Click Install. After the installation is complete, you can view the UniAgent in the UniAgent list.

UniAgent Statuses

The UniAgent status can be Running, Abnormal, Installing, Installation failed, or Not installed.