Updated on 2024-11-20 GMT+08:00

Configuring a UniAgent

You can install, reinstall, and upgrade a UniAgent on and uninstall a UniAgent from corresponding nodes.

Scenarios

Install, reinstall, and upgrade, unstall, and synchronize status of a UniAgent on and uninstall a UniAgent from corresponding nodes on COC.

Precautions

  • Currently, you can only perform operations on UniAgent for ECSs.
  • OS usage restrictions
    Table 1 Linux operating systems and versions supported by a UniAgent

    OS

    Version

    EulerOS

    1.1 64bit

    2.0 64bit

    CentOS

    7.1 64bit

    7.2 64bit

    7.3 64bit

    7.4 64bit

    7.5 64bit

    7.6 64bit

    7.7 64bit

    7.8 64bit

    7.9 64bit

    8.0 64bit

    Ubuntu

    16.04 server 64bit

    18.04 server 64bit

    20.04 server 64bit

    22.04 server 64bit

    • For Linux x86_64 servers, all the listed OSs and versions are supported.
    • For Linux Arm servers, CentOS 7.4, 7.5, 7.6, EulerOS 2.0, and Ubuntu 18.04 are supported.

Procedure

  1. Log in to COC.
  2. In the navigation pane on the left, choose Resources > Application and Resource Management. On the displayed Resources tab page, above the resource list, select the desired instances and choose UniAgent > Install.

    Figure 1 Installing a UniAgent

    When installing a UniAgent for ECSs in the same VPC, you need to manually install a UniAgent for the first ECS and set this ECS as the installation node. For details, see Installing a UniAgent for the First Time.

  3. On the displayed Install UniAgent page, specify required information by referring to Table 2 and click Submit to trigger the automated installation process. Wait until the installation is complete.

    Figure 2 Setting parameters

  4. In the navigation pane on the left, choose Resources > Application and Resource Management. Click the Resources tab, select the instances whose UniAgent status is Abnormal, Not installed, or Uninstalled, and choose UniAgent > Reinstall. For an instance whose UniAgent status is uninstalled, locate the instance, and click Reinstall in the UniAgent Status column.

    Figure 3 Reinstalling a UniAgent

  5. In the navigation pane on the left, choose Resources > Application and Resource Management. On the displayed Resources tab page, above the resource list, select the instances with UniAgents installed and choose UniAgent > Upgrade.

    Figure 4 Upgrading a UniAgent

  6. In the drawer that is displayed on the right, select the UniAgent to be upgraded and click OK to trigger the automatic upgrade process. Wait until the operation is complete.

    Figure 5 Parameters for upgrading a UniAgent

  7. In the navigation pane on the left, choose Resources > Application and Resource Management. On the displayed Resources tab page, above the resource list, select the instances with UniAgents installed and choose UniAgent > Uninstall.

    Figure 6 Uninstalling a UniAgent

  8. In the drawer that is displayed, click OK to trigger the automatic uninstallation process. Wait until the operation is complete.
  9. In the navigation pane on the left, choose Resources > Application and Resource Management. On the displayed Resources tab page, above the resource list, select the instances with UniAgents installed and choose UniAgent > Synchronize Status.

    Figure 7 Status synchronization
    Table 2 UniAgent parameters

    Parameter

    Description

    Example Value

    UniAgent Version

    (Mandatory) Version of a UniAgent. Currently, version 1.0.9 is supported.

    1.0.9

    Host Access Mode

    There are three access modes: Direct access (private network), Direct access (public network), and Proxy access.

    • Direct access (intranet): 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 the UniAgent on a host through the proxy.

    Direct access (intranet)

    Proxy Area

    When Proxy access is selected, you need to select a proxy area.

    An agent area is used to manage agents by category. A proxy is a Huawei Cloud ECS purchased and configured on Huawei Cloud to implement network communication between multiple clouds.

    -

    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:

    1. Select Configure Installation Host from the drop-down list.
    2. Access the AOM service to configure the installation host.

    -

    Hosts About to Accommodate UniAgents

    Detailed information about the host where the UniAgent is to be installed. This parameter is mandatory.

    Specify 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. 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.
    • Connection Test Result: shows whether the network between the installation host and the host where the UniAgent is to be installed is normal.
    • Operation: Test Connection
    NOTE:

    The hosts that run Windows do not support connectivity tests.

    -