Help Center/ Host Security Service/ User Guide/ Accessing HSS/ Installing the Agent on Servers/ Installing the Agent on Huawei Cloud Servers
Updated on 2024-08-02 GMT+08:00
View PDF

Installing the Agent on Huawei Cloud Servers

Scenario

You can enable HSS for servers only after installing the agent. This section describes how to install the agent on Huawei Cloud servers.

If you have enabled CBH, you can use CBH to quickly install the agent on servers. For details, see Installing the HSS Agent Using CBH.

Prerequisites

Constraints

The HSS agent will be automatically installed on Workspace 23.6.0 or later. If your Workspace version is earlier than 23.6.0, you can manually install the agent by referring to this section.

Agent Installation Methods

HSS provides two installation methods. For details about their differences, see the following table.

Table 1 Installation methods

Agent Installation Method

Description

Installing the Agent on Huawei Cloud Servers on the HSS Console

This method is convenient and more efficient than installing the agent using commands. You need to provide HSS with the server account password or key for installing the agent. HSS does not save the password file you upload.

Using Commands to Install the Agent on Huawei Cloud Servers

You need to log in to the server and run commands or a script to install the agent. This method is more complex and slower than installation on the GUI.

Installing the Agent on Huawei Cloud Servers on the HSS Console

You can install the agent on the HSS console. Various installation methods are as follows.

Using the Account and Password to Install the Agent on a Single Huawei Cloud Server

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: GUI
    • Server Authentication Mode: Account and password
    • Scale: Single

  8. Select a server and click Next.
  9. Enter the account information and password as prompted.

    • Linux
      Choose whether to allow direct connection with the root permission, and configure corresponding parameters.
      • If Allow direct connection with root permissions is selected:

        Enter the root password and login port of the server.

      • If Allow direct connection with root permissions is deselected:

        Enter the login username, password, server root password, and server login port.

      Figure 1 Entering the account and password (Linux)
    • Windows

      Enter the username and password.

      Figure 2 Entering the account and password (Windows)

  10. Confirm the information and click OK.

    You can view the Agent Status column to check the agent installation progress. If the Agent Status is Online, the agent has been installed.

Using the Account and Password to Install the Agent on Muptiple Huawei Cloud Servers

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: GUI
    • Server Authentication Mode: Account and password
    • Scale: Batch

  8. Upload the installation template.

    1. Click Download Template to download the batch installation template to your local PC.
      Figure 3 Downloading the batch installation template
    2. Open the downloaded importTemplate.xlsx file, fill in server information as required, and save the file.
    3. Click Select File and upload the importTemplate.xlsx file.

      HSS will automatically parse the file and identify the servers you entered. If the parsing fails, you can click View Failed Servers and check the failure cause.

  9. Confirm the information and click OK.

    You can view the Agent Status column to check the agent installation progress. If the Agent Status is Online, the agent has been installed.

Using DEW to Install the Agent on One or More Huawei Cloud Servers

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: GUI
    • Server Authentication Mode: Key
    • Key Source: DEW

  8. Select servers and click OK.

    The list of available servers only shows the servers that have been bound to DEW.

    Figure 4 Selecting servers

  9. Locate the row that contains the target server and check the agent installation progress in the Agent Status column.

    If the Agent Status is Online, the agent has been installed.

Installing the Agent on One or More Huawei Cloud Servers Using a User-created Key (Linux Only)

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: GUI
    • Server Authentication Mode: Key
    • Key Source: User-created key (Linux only)

  8. Upload the installation template.

    1. Click Download Template to download the batch installation template to your local PC.
      Figure 5 Downloading the batch installation template
    2. Open the downloaded importTemplate.xlsx file, fill in server information as required, and save the file.
    3. Click Select File and upload the importTemplate.xlsx file.

      HSS will automatically parse the file and identify the servers you entered. If the parsing fails, you can click View Failed Servers and check the failure cause.

  9. Confirm the information and click OK.
  10. Locate the row that contains the target server and check the agent installation progress in the Agent Status column.

    If the Agent Status is Online, the agent has been installed.

Using Commands to Install the Agent on Huawei Cloud Servers

The HSS agent can be installed using commands. You can install the agent on different OSs. Various installation methods are as follows.

Using Commands to Install the Agent on a Single Huawei Cloud Linux Server

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: Commands
    • Server OS: Linux
    • Scale: Single

  8. (Optional) Select the servers that need to be connected to the current HSS region and click Next.

    • Perform this operation only in the CN East 2 and CN Southwest-Guiyang 1 regions. HSS will automatically create a VPC endpoint, which occupies an IP address of your VPC subnet. Only one VPC endpoint will be created for each of your VPCs to ensure the communication between your servers and HSS.
    • In other regions, ensure the security groups of your servers allow outbound traffic through port 10180 of the 100.125.0.0/16 CIDR block. This port is used to communicate with HSS.

  9. Perform the following operations to install the agent.

    For CN East 2 and CN Southwest-Guiyang 1 regions, wait until the network communication succeeds (that is, the VPC endpoint is created) before performing the following operations.

    1. Click to copy the installation command.
      Figure 6 Copying the installation command
    2. Log in to the server as the root user and paste the installation command.

      If the command output shown in Figure 7 is displayed, the agent has been installed.

      Figure 7 Agent installed

Using Commands to Install the Agent on Multiple Huawei Cloud Linux Servers

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: Commands
    • Server OS: Linux
    • Scale: Batch
    • Server Authentication Mode: Select Account and password or Key as needed.

  8. (Optional) Select the servers that need to be connected to the current HSS region and click Next.

    • Perform this operation only in the CN East 2 and CN Southwest-Guiyang 1 regions. HSS will automatically create a VPC endpoint, which occupies an IP address of your VPC subnet. Only one VPC endpoint will be created for each of your VPCs to ensure the communication between your servers and HSS.
    • In other regions, ensure the security groups of your servers allow outbound traffic through port 10180 of the 100.125.0.0/16 CIDR block. This port is used to communicate with HSS.

  9. Perform the following operations to install the agent.

    • For CN East 2 and CN Southwest-Guiyang 1 regions, wait until the network communication succeeds (that is, the VPC endpoint is created) before performing the following operations.
    • Perform the following operations on any server.
    1. Click linux-host-list.csv to download the template.
      Figure 8 Downloading linux-host-list.csv
    2. Fill in the server information based on the requirements in the linux-host-list.csv template and save it.

      Ensure that the entered server verification information is consistent with the verification mode selected in 7.

    3. Use the root account to remotely log in to any target server.
    4. Use the SSH client to upload the template file linux-host-list.csv to the /tmp directory on the server.
    5. Return to the HSS console and click to copy the installation command.
      Figure 9 Copying the installation command
    6. Paste and run the installation command on the server to install the agent.

      If the command output shown in Figure 10 is displayed, the agent has been installed.

      Figure 10 Agent installed

Using the Script to Install the Agent on a Single Huawei Cloud Windows Server

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: Commands
    • Server OS: Windows
    • Scale: Single

  8. (Optional) Select the servers that need to be connected to the current HSS region and click Next.

    • Perform this operation only in the CN East 2 and CN Southwest-Guiyang 1 regions. HSS will automatically create a VPC endpoint, which occupies an IP address of your VPC subnet. Only one VPC endpoint will be created for each of your VPCs to ensure the communication between your servers and HSS.
    • In other regions, ensure the security groups of your servers allow outbound traffic through port 10180 of the 100.125.0.0/16 CIDR block. This port is used to communicate with HSS.

  9. Perform the following operations to install the agent.

    For CN East 2 and CN Southwest-Guiyang 1 regions, wait until the network communication succeeds (that is, the VPC endpoint is created) before performing the following operations.

    1. Click installAgent.ps1 to download the installation script.
      Figure 11 Downloading installAgent.ps1
    2. Copy the installAgent.ps1 file to C:\Users\Administrator.
    3. Right-click installAgent.ps1 and choose Run with PowerShell.
    4. (Optional) In the dialog box that is displayed, enter Y to run the script to install the agent.

      If no dialog box is displayed, skip this step.

      Figure 12 Changing the execution policy
    5. After the execution, open the Task Manager and check whether hostguard.exe and hostwatch.exe exist. If they do, the agent has been installed.
      Figure 13 Agent installed

Using the Script to Install the Agent on Multiple Huawei Cloud Windows Servers

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security & Compliance > HSS.
  3. In the navigation pane, choose Installation & Configuration > Server Install & Config.

    If your servers are managed by enterprise projects, you can select the target enterprise project to view or operate the asset and detection information.

  4. Click the Agents tab.
  5. In the upper right corner of the page, click Install HSS Agent.
  6. Select ECS and click Configure Now.
  7. Select an installation method.

    • Install Mode: Commands
    • Server OS: Windows
    • Scale: Batch

  8. (Optional) Select the servers that need to be connected to the current HSS region and click Next.

    • Perform this operation only in the CN East 2 and CN Southwest-Guiyang 1 regions. HSS will automatically create a VPC endpoint, which occupies an IP address of your VPC subnet. Only one VPC endpoint will be created for each of your VPCs to ensure the communication between your servers and HSS.
    • In other regions, ensure the security groups of your servers allow outbound traffic through port 10180 of the 100.125.0.0/16 CIDR block. This port is used to communicate with HSS.

  9. Perform the following operations to install the agent.

    • For CN East 2 and CN Southwest-Guiyang 1 regions, wait until the network communication succeeds (that is, the VPC endpoint is created) before performing the following operations.
    • Perform the following operations on any server.
    • To install the agent, the server where the script is executed needs to access the port 5985 on other servers. Modify the inbound rules of the security groups on those servers to allow such access, or HSS will temporarily modify their security group rules while installing the agent. After the agent is installed, the modified settings will be deleted.
    1. Click windows-host-list.xlsx to download the template to the local PC.
      Figure 14 Downloading windows-host-list.xlsx
    2. Enter server information based on the requirements in the windows-host-list.xlsx template and save it.
    3. Return to the HSS console and click BatchInstallAgent.ps1 to download the installation script.
      Figure 15 Downloading BatchInstallAgent.ps1
    4. Copy the windows-host-list.xlsx and BatchInstallAgent.ps1 files to C:\Users\Administrator.
    5. Right-click BatchInstallAgent.ps1 and choose Run with PowerShell.
    6. (Optional) In the dialog box that is displayed, enter Y to run the script to install the agent.

      If no dialog box is displayed, skip this step.

      Figure 16 Changing the execution policy
    7. After the script is executed successfully, check whether the BatchInstallAgent.log file exists in C:\Users\Administrator.

      If the BatchInstallAgent.log file exists, the agent has been installed.

Parent Topic: Installing the Agent on Servers