Updated on 2024-08-14 GMT+08:00

Installing an Agent

Install the agent on a server. Only then can the server be protected by HSS.

Installing an Agent on a Server

  1. Log in to the management console.
  2. Click in the upper left corner of the page, select a region, and choose Security > Host Security Service.
  3. In the navigation pane, choose Installation & Configuration. Click the Agents tab.
  4. Click Offline to check the servers where the agent is not installed or is offline. Table 1 describes the parameters.

    Table 1 Offline agent parameters

    Parameter

    Description

    Server Name/ID

    Server name and ID

    IP Address

    EIP or private IP address of a server

    OS

    Server OS. Its value can be:

    • Linux
    • Windows

    Agent Status

    Agent status of a server. Its value can be:

    • Offline
    • Not installed
    • Installation failed

    Agent Version

    Version of the agent installed on the target server.

    Agent Upgrade Status

    The agent status during the Agent upgrade.

  5. Click View Cause in the Operation column of a server to check why an agent is offline.
  6. Click Install Agent in the Operation column. Download the agent package suitable for your server architecture and OS. For details about how to install the agent on a Linux server, see Installing an Agent on Linux. For details about how to install the agent on a Windows server, see Installing the Agent for Windows.

Installing an Agent on Multiple Servers (with the Different Server Accounts and Passwords)

You can install the agent on multiple servers with different accounts and passwords.

Constraints

  • Currently, HSS agents can be installed on a batch of Linux servers running different accounts and passwords on the cloud.
  • All servers you want to batch install the agent must be in the same security group or security groups that are connected to each other.

Prerequisites

  • All target servers must support SSH login.
  • The correct login accounts, port numbers, and passwords of all servers have been obtained.
  • All target servers must be in the Running state.

Procedure

  1. Log in to the management console.
  2. Click in the upper left corner of the page, select a region, and choose Security > Host Security Service.
  3. In the navigation pane, choose Installation & Configuration. Click the Agents tab.
  4. Click Installation Guide and copy the batch installation command.
  5. Remotely log in to the server where you plan to install the agent.

    After logging in to the server, run the following command to check whether the expected command exists on the server. If the expected command does not exist, configure the yum repository.

    /bin/expect -v

  6. Run the following command to access the /tmp directory:

    cd /tmp/

  7. Run the following command to create the linux-host-list.txt file and add the private IP addresses of the servers you want to install the agent to the file:

    Command format: echo "IP address Portroot rootPassword" >> linux-host-list.txt

    Or echo "IP address Port user userPassword rootPassword" >> linux-host-list.txt

    Example: echo "127.8.10.8 22 root rootPassword" >> linux-host-list.txt

    Or echo "127.8.10.9 22 user userPassword rootPassword" >> linux-host-list.txt

    To specify multiple IP addresses, write multiple commands, each in a separate line.

    Example: echo "127.8.10.1 22 root rootPassword" >> linux-host-list.txt

    echo "127.8.10.8 22 user userPassword rootPassword" >> linux-host-list.txt

    echo "127.8.10.3 22 root rootPassword" >> linux-host-list.txt

  8. Press Enter to save the IP address. Run the cat linux-host-list.txt command to verify the IP addresses have been added.
  9. Paste the copied installation command and run it as user root to install the agent on the servers.

    If information similar to the following is displayed, the agent is successfully installed:

    remote_install finished. [OK]

  10. After the installation is successful, choose Installation and Configuration > Agents > Online and check the agent status of the target server. If the agent is online, the Agent is running properly.