Installing UniAgent on a Host

Constraints

• Currently, you can only perform UniAgent-related operations on ECSs and BMSs on COC.
• You can install UniAgent tools on a maximum of 100 ECSs in batches.
• Currently, only Linux OSs are supported. For Windows OSs, you need to manually install UniAgent. For details, see Installing UniAgent on an ECS.
  • For Linux x86_64 servers, all OSs and versions listed in Table 1 are supported.
  • For Linux Arm servers, CentOS 7.4/7.5/7.6, EulerOS 2.0, and Ubuntu 18.04 are supported.

    Table 1 Linux operating systems and versions supported by UniAgent

    OS	Version
    EulerOS	1.1 64-bit	2.0 64-bit
    CentOS	7.1 64-bit	7.2 64-bit	7.3 64-bit	7.4 64-bit	7.5 64-bit
    	7.6 64-bit	7.7 64-bit	7.8 64-bit	7.9 64-bit	8.0 64-bit
    Ubuntu	16.04 server 64-bit	18.04 server 64-bit	20.04 server 64-bit	22.04 server 64-bit

Installing UniAgent

1. Log in to COC.
2. In the navigation pane, choose Resources > Application and Resource Management.
3. On the Resources page, select the target instances and choose UniAgent > Install.
   When UniAgent is installed in a VPC for the first time, you need to manually install UniAgent and set the first host with UniAgent installed as the installation host. For details, see How Do I Install UniAgent for the First Time?

   Figure 1 Installing UniAgent
   

4. Set the parameters for installing UniAgent.

   Table 2 Parameters for installing UniAgent

   Parameter	Description
   UniAgent Version	Select a UniAgent version from the drop-down list.
   Host Access Mode	There are three access modes: Direct access (private network), Direct access (public network), and Proxy access. Direct access (private network): intended for Huawei Cloud hosts. Direct access (public network): intended for non-Huawei Cloud hosts. Proxy access: Select a proxy area where a proxy has been configured and remotely install UniAgent on a host through the proxy.
   Proxy Area	When Proxy access is selected, you need to select a proxy area. A proxy area is used to manage proxies by category. A proxy is a Huawei Cloud Elastic Cloud Server (ECS) purchased and configured on Huawei Cloud to enable network communication between multiple clouds.
   Installation Host	Select an installation host from the drop-down list. Select a host where UniAgent has been installed. The installation host helps install UniAgent on other hosts in the same VPC.
   Hosts About to Accommodate UniAgent	Enter detailed information about the host where UniAgent needs to be installed. Host Name: host name. 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. For the Linux OS, using the root account is recommended so 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. O&M Test Result: shows whether the network between the installation host and the host where UniAgent needs to be installed is normal. Operation: Test Network The Windows OS does not support connection tests. Delete

5. (Optional) Perform batch operations.
   • Test Connection: Select multiple hosts to be installed and click Test Connection to perform O&M connection tests on the selected hosts in batches.
   • Batch Specify Data
     • Manual batch parameter settings: Login accounts, login ports, and passwords can be filled in batches.
       Figure 2 Manual input
       
     • Importing data in batches using an Excel file: You can click Download Template, manually enter data based on the template, and import data in batches using an Excel file.
       Figure 3 Importing data in batches
       
   • Batch export: Export all data of the hosts to be installed in batches.

6. Click OK.

   Wait until the installation is complete.

Reinstalling UniAgent

1. Log in to COC.
2. In the navigation pane, choose Resources > Application and Resource Management.
3. Select the instances with the UniAgent status of Abnormal, Uninstalled, or Installation failed, then choose UniAgent > Reinstall or click reinstall in the UniAgent Status column.
   Figure 4 Reinstalling UniAgent
   

4. The parameters are almost the same as those for installing UniAgent. For details, see Table 3.

   Table 3 Parameters for installing UniAgent

   Parameter	Description
   UniAgent Version	Select a UniAgent version from the drop-down list.
   Host Access Mode	There are three access modes: Direct access (private network), Direct access (public network), and Proxy access. Direct access (private network): intended for Huawei Cloud hosts. Direct access (public network): intended for non-Huawei Cloud hosts. Proxy access: Select a proxy area where a proxy has been configured and remotely install UniAgent on a host through the proxy.
   Proxy Area	When Proxy access is selected, you need to select a proxy area. A proxy area is used to manage proxies by category. A proxy is a Huawei Cloud Elastic Cloud Server (ECS) purchased and configured on Huawei Cloud to enable network communication between multiple clouds.
   Installation Host	Select an installation host from the drop-down list. Select a host where UniAgent has been installed. The installation host helps install UniAgent on other hosts in the same VPC.
   Hosts About to Accommodate UniAgent	Enter detailed information about the host where UniAgent needs to be installed. Host Name: host name. 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. For the Linux OS, using the root account is recommended so 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. O&M Test Result: shows whether the network between the installation host and the host where UniAgent needs to be installed is normal. Operation: Test Network The Windows OS does not support connection tests. Delete

5. Click OK.

   Wait until the reinstallation is complete.

Upgrading UniAgent

1. Log in to COC.
2. In the navigation pane, choose Resources > Application and Resource Management.
3. Select the instances where UniAgent has been installed and choose UniAgent > Upgrade.
   Figure 5 Upgrading UniAgent
   

4. Set parameters for upgrading UniAgent.

   Table 4 Parameters for upgrading UniAgent

   Parameter	Description
   UniAgent Version	(Mandatory) Version of UniAgent.

5. Click OK.

   Wait until the upgrade is complete.

Uninstalling UniAgent

1. Log in to COC.
2. In the navigation pane, choose Resources > Application and Resource Management.
3. Select the instances where UniAgent has been installed and choose UniAgent > Uninstall.
   Figure 6 Uninstalling UniAgent
   

4. Click OK.

   Wait until the uninstallation is complete.

Synchronizing the UniAgent Status

1. Log in to COC.
2. In the navigation pane, choose Resources > Application and Resource Management.
3. Select the instances where UniAgent is installed and choose UniAgent > Synchronize Status.
   Figure 7 Synchronizing the UniAgent status
   

Viewing UniAgent Operation Logs

1. Log in to COC.
2. In the navigation pane, choose Resources > Application and Resource Management.
3. Click UniAgent Operation Logs to view historical UniAgent operation records.
   Figure 8 Synchronizing the UniAgent status
   

4. Click UniAgent FAQs to view the problems frequently encountered and their solutions when performing UniAgent-related operations.
   Figure 9 Synchronizing the UniAgent status