Help Center/ Bare Metal Server/ Best Practices/ Monitoring/ Installing and Configuring the Agent for an Existing BMS/ Installing the Agent
Updated on 2023-03-30 GMT+08:00
View PDF

Installing the Agent

This section describes how to install the Agent for an existing BMS. The procedure is as follows:

  1. Adding the Resolved Domain Names: Add the resolved domain names of regions to the /etc/resolv.conf file on the BMS.
  2. Configuring the Security Group: Download the Telescope package, send metrics, and collect logs.
  3. Procedure: Manually install the Agent on the BMS.

Adding the Resolved Domain Names

  1. Log in to the BMS as user root.
  2. Enter vi /etc/resolv.conf to open the /etc/resolv.conf file.
  3. Add nameserver 100.125.1.250 and nameserver 100.125.21.250 to the file, as shown in Figure 1.
    Figure 1 Adding the resolved domain names
  4. Press Esc and enter :wq! to save the configuration.

Configuring the Security Group

  1. On the page showing the BMS details, click the Security Groups tab.
  2. Click to expand the security group details, showing the configured security group rules.
  3. In the upper right corner of the rule list, click the security group ID to go to the Security Groups page.
    Figure 2 Security group rules
  4. In the Operation column, click Manage Rule. On the Outbound Rules tab page, click Add Rule to add a rule based on Table 1.
    Table 1 Security group rules

    Direction

    Protocol

    Port

    Destination IP address

    Description

    Outbound

    TCP

    80

    100.125.0.0/16

    Used to download the Agent installation package from the OBS bucket to the BMS and obtain the metadata and authentication information of the BMS.

    Outbound

    TCP and UDP

    53

    100.125.0.0/16

    Used by DNS to resolve domain names, for example, resolve the OBS domain name when users are downloading the Agent installation package, and resolve the Cloud Eye endpoint when the Agent is sending monitoring data to Cloud Eye.

    Outbound

    TCP

    443

    100.125.0.0/16

    Used to collect monitoring data that will be sent to Cloud Eye.

Procedure

  1. Log in to the BMS as user root.
  2. Run the following command to install the Agent:
    The Agent is installed successfully if the command output similar to the following figure is displayed.
    Figure 3 Successful installation
  3. After the installation is complete, configure the Agent by referring to (Optional) Manually Configuring the Agent (Linux).
  4. Run the following command to delete the installation script:

    if [[ -f /usr/local/uniagent/extension/install/telescope/bin/telescope ]]; then rm /usr/local/agent_install.sh; else rm /usr/local/agentInstall.sh; fi