Help Center> Host Security Service (New)> User Guide> Accessing HSS> Installing an Agent> Checking the Installation Environment
Updated on 2024-06-28 GMT+08:00
View PDF

Checking the Installation Environment

Agent installation has restrictions on security group outbound ports, DNS server addresses, and third-party security software. Before installing it, perform the operations in Checking the Installation Environment to ensure the installation requirements are met.

Checking the Installation Environment

  1. Ensure your server OS is supported by the agent. For more information, see the table in Supported OSs.

    The agent cannot be installed on the OSs that are not in the table.

  2. Ensure the server is running properly.

    The agent cannot be installed if the server is not running.

  3. Ensure the capacity of the disk where the agent is to be installed is greater than 300 MB.

    If the available space is less than 300 MB, the agent will fail to be installed. The agent installation path cannot be customized. The following default paths are used:

    • Linux: /usr/local/hostguard/
    • Windows: C:\Program Files\HostGuard

  4. Ensure the outbound rule of your security group allows access to the port 10180 on the 100.125.0.0/16 CIDR block. (This is the default setting.)

    This port is used to communicate with the HSS server. For details about how to view and modify an outbound security group rule, see Modifying a Security Group.

  5. Ensure the DNS address of the server is a private DNS server address on the Huawei Cloud.

    The agent cannot be downloaded to a private DNS server address outside Huawei Cloud.

    For details about how to view and change the DNS server address, see Modifying the DNS (on the Server) or Modifying the DNS Server Address (on the Console).

  6. Close or uninstall third-party security software.

    If any third-party security software is installed on the server, the HSS agent may fail to be installed.

  7. (Optional) For a Linux server, disable the SELinux firewall.

    The SELinux firewall may disrupt agent installation. You can enable it after the agent is successfully installed.

Modifying a Security Group

To install the agent, ensure the security group of the server allows outbound access to port 10180 of the 100.125.0.0/16 CIDR block. This section describes how to view and modify ECS security group rules.

  1. Log in to the management console.
  2. In the upper left corner, select a region and a project.
  3. In the upper left corner of the management console, click and choose Compute > Elastic Cloud Server.

    The Elastic Cloud Server page is displayed.

  4. In the ECS list, click the name of an ECS.
  5. On the ECS details page, click the Security Groups tab and click Manage Rule.

    The security group details page is displayed.

  6. Click the Outbound Rules tab and add a rule, as shown in Table 1.

    Table 1 Security group rules

    Priority

    Action

    Type

    Protocol & Port

    Destination

    Description

    1

    Allow

    IPv4

    TCP

    10180

    100.125.0.0/16

    Communicates with the HSS server.

Modifying the DNS (on the Server)

When installing the agent, ensure the DNS server address is the Huawei Cloud private DNS server address. This section describes how to view and change the DNS server address on the server.

  • Linux server

    The following describes how to add the DNS server address to the resolv.conf file using Linux command lines.

    1. Log in to the server as user root.
    2. Run the following command to open the resolv.conf file:

      vi /etc/resolv.conf

    3. Run the following commands to add the DNS address:

      nameserver Huawei_Cloud_Private_DNS_server_address

      The private DNS server addresses vary depending on regions. For details, see Private DNS Server Address of Huawei Cloud.

      Take CN North-Beijing1 as an example. The complete commands are nameserver 100.125.1.250 and nameserver 100.125.21.250.

      Figure 1 Adding the DNS server address
    4. Enter wq and press Enter to save the settings and exit.
  • Windows server

    The following describes how to use the Windows GUI to add the DNS server address.

    1. Log in to the server as the administrator.
    2. Choose Control Panel > Network and Sharing Center, and click Change adapter settings.
    3. Right-click the network in use and choose Properties from the shortcut menu.
    4. Double-click Internet Protocol Version 4 (TCP/IPv4).
    5. Select Use the following DNS server addresses and enter the Huawei Cloud private DNS server address.

      The private DNS server addresses vary depending on regions. For details, see Private DNS Server Address of Huawei Cloud.

Modifying the DNS Server Address (on the Console)

When installing the agent, ensure the DNS server address is the Huawei Cloud private DNS server address. This section uses an ECS as an example to describe how to log in to the console to view and modify DNS configurations.

  1. Log in to the management console.
  2. In the upper left corner, select a region and a project.
  3. In the upper left corner of the management console, click and choose Compute > Elastic Cloud Server.

    The Elastic Cloud Server page is displayed.

  4. In the ECS list, click the name of an ECS.
  5. On the ECS details page, click the value of the VPC parameter.

    The Virtual Private Cloud page is displayed.

  6. Locate the VPC and click the number in the Subnets column.

    The Subnets page is displayed.

  7. Click the name of the subnet.

    In the Gateway and DNS Information area, view the DNS server addresses used by the ECS.

  8. In the Gateway and DNS Information area, click next to DNS Server Address.
  9. Change the DNS server addresses to the Huawei Cloud private DNS server addresses.

    The private DNS server addresses vary depending on regions. For details, see Private DNS Server Address of Huawei Cloud.

Parent Topic: Installing an Agent