No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

eSight V300R010C00 Operation Guide 07

Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Managing Host Agent

Managing Host Agent

Overview

Agent is a host agent component provided by eSight. Connecting hosts in Agent mode enables central management of host data, performance monitoring, and alarm report. In addition, connecting Agent to hosts using HTTPS ensures the security of operating system accounts and makes it easy and convenient for eSight to manage the hosts.

Installation Scenarios

  • Monitoring host performance and alarms
  • Using HTTPS to connect hosts

installation Requirements

  • The following host operating systems support the agent:
    • SUSE Linux Enterprise Server 12 SP2/SP1 64-bit
    • Red Hat Enterprise Linux 7 WS, ES, AS 7.4/7.3/7.2/7.1 64-bit
    • Red Hat Enterprise Linux 6 WS, ES, AS 6.8/6.6/6.5/6.4/6.2/6.1/6.0 64-bit
    • CentOS 7.4/7.1/7.0 64-bit
    • CentOS 6.8/6.5 64-bit
    • Oracle Linux 7.4/6.8/6.7 64-bit
    • NeoKylin 6.5/6.0 64-bit
    • EulerOS 2.0/2.3 64-bit
  • You must add TCP port 43156 to the host firewall exception list.

    For details, see eSight Cannot Discover Hosts After the Agent Is Deployed.

Installation Mode

  • Install the agent one by one using the installation package.
  • Install the agent in batches using eSight.

Impact on the System

The agent operation has the following impact on the system.

Table 10-26

Indicator

Value

CPU usage

1% to 2%

Occupied physical memory capacity

20 MB

Occupied virtual memory capacity

200 MB

NOTE:

The impact varies slightly depending on operating system.

Installing Agent One by One Using the Installation Package

Deploying the Agent to a Managed Host

Agent is used to ensure normal transfer of performance and alarm data between managed hosts and eSight. The agent must be deployed on each host managed by eSight.

Prerequisites
  • You have obtained the agent installation package eSight_IT_HostAgent_x.x.x.zip.
    • For enterprise users:
      1. Log in to http://support.huawei.com/enterprise.
      2. Search for eSight. In the search result, choose Vertical Industries Solution > eSight Solution > eSight.
      3. On the Downloads tab page, download the eSight software and digital signature files.
    • For carrier users:
      1. Log in to http://support.huawei.com/carrier.
      2. Search for eSight VxxxRxxxCxxSPCxxx.
      3. On the Software tab page, download the eSight software and digital signature files.
    • After the software is downloaded, use the digital certificate and verification tool available on Huawei technical support website to verify the digital signature.
      1. Download the .asc digital signature file with the same name as the installation package on the eSight software download page.
      2. Use the digital certificate and verification tool provided on the website to verify the digital signatures of the software packages.

        You can obtain the digital certificate, verification tool, and usage guide from the following address:

        Support-E: http://support.huawei.com/enterprise/toolsinfo?lang=zh&idAbsPath=0602_ROOT|8221819&pid=8221819&show=showVDetail&toolId=TL1000000054

        Support: http://support.huawei.com/carrier/digitalSignatureAction

        NOTE:

        The name of the obtained agent installation package may be different from the description. The actual installation package name prevails.

  • Time on the managed host must be the current time and consistent with the time on the eSight server.
  • You have logged in to the managed host.
    NOTE:

    Resources added in the host mode are used for storage network analysis.

Procedure
Deploying the agent to a host running the Linux operating system
  • The root user must be used for installing the agent on a host running the Linux operating system.
  • The following uses the SUSE 11.1 operating system as an example.
  1. Decompress the agent installation package eSight_IT_HostAgent_x.x.x.zip, and obtain the HostAgent.zip package in the Suse11 directory.
  2. Use FTP or other methods to upload HostAgent.zip to a directory in the Linux operating system, for example, /opt.
    • The upload directory cannot contain Chinese characters.
    • The upload directory of HostAgent.zip must be greater than 100 MB.
    • If the upload directory does not exist, you need to log in to the operating system as the root user and create an upload directory, for example:

    # mkdir /opt

  1. Run the following commands to decompress HostAgent.zip to the current directory:

    # cd /opt

    # unzip HostAgent.zip -d HostAgent

    NOTE:

    In the commands, /opt indicates the directory where the HostAgent.zip package is stored. Change it based on the site requirements.

  2. Run the following commands to enable HostAgent to automatically start with the operating system and install the agent service:

    # cd /opt/HostAgent

    # ./install.sh

  3. Run the following command to start the agent service:

    # ./startup.sh

Follow-up Procedure

Batch Installing Agent Using eSight

Managing Agent Packages

Before installing or upgrading the host agent, you need to add the host agent package to be installed. This section describes how to add and delete agent packages.

Procedure
  1. On the menu bar, choose Resource > Storage Subnet.

  1. Choose Host Agent Management > Package Management from the navigation tree on the left.
  2. In the information display area on the right, view information about the host agent. The following table describes the parameters.

    Parameter

    Description

    Name

    Name of the host agent package, for example, eSight_IT_HostAgent_2.1.1.zip.

    Agent Package Version

    Version of the agent package.

    Size

    Size of the agent package.

    Upload Time

    Time when the agent package is uploaded.

    NOTE:
    • Click Add to upload the agent package and its digital certificate file. To obtain the digital certificate file, perform the following operations:
      • For enterprise users:
      1. Log in to http://support.huawei.com/enterprise as an enterprise user.
      2. Search for eSight. In the search result, choose Vertical Industries Solution > eSight Solution > eSight.
      3. On the Downloads tab page, download the eSight software and digital signature files.
      • For carrier users:
      1. Log in to http://support.huawei.com/carrier.
      2. Search for eSight VxxxRxxxCxxSPCxxx.
      3. On the Software tab page, download the eSight software and digital signature files.
    • After the software is downloaded, use the digital certificate and verification tool available on Huawei technical support website to verify the digital signature.
    • Select a host agent package and click Delete to delete the host agent package.

Installing and Upgrading the Host Agent

This section describes how to install or upgrade the host agent.

Prerequisites
  • The host has been connected in agentless mode.
  • No agent is installed on the host.
Procedure
  1. On the menu bar, choose Resource > Storage Subnet.

  2. Choose Host Agent Management > Installation and Upgrade from the navigation tree on the left.
  3. In the information display area on the right, query information about the host agent.

    • Select a subnet to be queried in the Subnet area and click Search to query information about the host agent of the subnet.
    • Enter the name of a Huawei storage system in the Name text box and click Search to query information about the corresponding host agent.
    • Enter the IP address to be queried in the IP address text box and click Search to query information about the host agent corresponding to the IP address.
    NOTE:

    Select a host from the host list and click Install, Upgrade, or Uninstall to install, upgrade, or uninstall the host agent.

  4. In the information display area on the right, view information about the host agent. The following table describes the parameters.

    Parameter

    Description

    Name

    Name of the host where the agent is installed.

    IP Address

    IP address of the management network port on the host where the agent is installed.

    Agent Package Version

    Agent package version on the host.

    Last Refresh At

    Time when the host agent package is refreshed last time.

    Progress

    Installation progress of the host agent.

    Operation

    Operation on the host agent.

    Result

    Host agent operation result.

    Details

    Host agent operation details.

    NOTE:

    During the upgrade and uninstallation of the host agent, pay attention to the following:

    • Upgrade
      • An upgrade can be performed only between different versions of the host agent.
      • In the Linux operating system, use the lftp tool to upgrade the host agent. If the lftp tool is not installed, you need to manually install the tool. For details, see How Can I Manually Install the lftp Tool of the Agent Software Package.

        Run the rpm –qa | grep lftp command to check whether the lftp tool is installed.

        The following information indicates that the tool is not installed.

      • During the upgrade, the host agent involves periodic tasks. If the periodic service is disabled, the upgrade plug-in will automatically enable the periodic service.
      • After the host agent is upgraded, the backup file of the original version will be generated in the upper-layer directory of the installation directory. For example, if the installation directory of the original version is /opt/HostAgent/eSight_IT_HostAgent_2.1.1 in the Linux operating system, the eSight_IT_HostAgent_2.1.1.zip backup file will be generated in the /opt/HostAgent directory. Check the directory based on the site requirements.
    • Uninstallation

      When uninstalling the host agent in the Linux operating system, there may be some files in the installation directory (for example, /opt/HostAgent/eSight_IT_HostAgent_2.1.1). You need to manually delete these files.

Checking Whether the Agent Is Normally Started

If the agent cannot be started, eSight cannot communicate with the host. As a result, eSight cannot obtain performance data of the host.

Procedure
Check the agent status on the Linux operating system.
  1. Use a remote login tool to log in to the host.
  2. Run the following command to check whether the HostAgent process has started:

    ps -ef | grep "HostAgent" | grep -v "grep"

    • If the following information is displayed, the agent has been normally started:
      root     22157     1  0 10:10 pts/1    00:00:00 sh ./HostAgentTimedTask.sh
      root     31060     1  0 08:38 pts/1    00:00:08 ./HostAgent
    • If no information is displayed, the agent is not started. Go to Step 3.
  3. Run the following commands to start the agent service:
    NOTE:

    In the commands, /opt/HostAgent indicates the directory where the script related to the agent service is located. Change it based on the site requirements.

    # cd /opt/HostAgent

    # ./startup.sh

  4. Run the following command to check whether the HostAgent process works properly:

    # lsof -i:43156

    NOTE:

    The HostAgent process uses port 43156. If the port is occupied by another process, the HostAgent process cannot work properly.

    • If the following information is displayed, the HostAgent process uses port 43156 and works properly.
      COMMAND     PID USER   FD   TYPE   DEVICE SIZE NODE NAME
      HostAgent 31060 root    6u  IPv4 52660506       TCP *:43156 (LISTEN)
    • If the character string below COMMAND is not HostAgent, port 43156 is occupied by another process. Stop the process and perform 3 to restart the HostAgent process.
    • If no information is displayed, go to 2.

----End

Uninstalling Agent

Stopping the Agent Service on a Host

This section describes how to stop the agent service on a host. After the agent service is stopped, performance data and alarms of the managed host cannot be reported to eSight.

Prerequisites
  • You have deployed the agent on the host.

    For details, see Deploying the Agent to a Managed Host.

  • Time on the managed host must be the current time and consistent with the time on the eSight server.
  • You have logged in to the managed host.
Procedure
Stop the agent service on the Linux operating system.
  1. Log in to the host operating system as the root user.
  2. Run the following commands to stop the agent service:
    NOTE:

    In the command, /opt/HostAgent indicates the installation directory of the agent program. Change it based on the site requirements.

    # cd /opt/HostAgent

    # ./shutdown.sh

----End

Uninstalling the Agent on a Host

This section describes how to uninstall the agent on a host.

Prerequisites
  • You have deployed the agent on the host.

    For details, see Deploying the Agent to a Managed Host.

  • Time on the managed host must be the current time and consistent with the time on the eSight server.
  • You have logged in to the managed host.
Procedure
Uninstall the agent on the Linux operating system.
NOTE:

The following assumes that /opt/HostAgent is the installation directory of the agent program. Change the directory based on the site requirements.

  1. Execute shutdown.sh to stop the agent service. For details, see Stopping the Agent Service on a Host.
  2. Run the following commands to uninstall the dynamic library related to the agent:

    # cd /opt/HostAgent

    # ./uninstall.sh

  3. Run the following command to delete the installation directory of the agent program:

    The rm –rf command is a risky. When using the command, ensure that the agent installation directory is correct.

    # rm -rf /opt/HostAgent/*

----End

Reference

eSight Cannot Discover Hosts After the Agent Is Deployed
Symptom

eSight cannot automatically discover hosts through single addition after the agent is deployed on the hosts.

Possible Causes

On the operating system of a target host, port 43156 used by the agent is not added as a firewall exception.

Fault Diagnosis

Add a firewall exception for port 43156.

Procedure
  • Add a firewall exception for port 43156 in Red Hat 6.x and earlier versions.
    1. Log in to the host operating system as the root user.
    2. Run the following command to check whether the iptables file exists in /etc/sysconfig:

      # ls -l /etc/sysconfig | grep iptables

      • If yes, perform 3 to 7.
      • If no, perform 8.
    3. Run the following command to open the iptables file:

      # vi /etc/sysconfig/iptables

    4. Press i to enter the editing mode and add rules.
      • If RH-Firewall-1-INPUT is displayed in the rule list, enter rules shown in Figure 1.
        Figure 10-19 Rule list of iptables
      • If INPUT is displayed in the rule list, enter rules shown in Figure 2.
        Figure 10-20 Rule list of iptables
    1. Press Esc to exit the text input mode.
    2. Enter :wq to save the iptables file and exit.
    3. Run the following command to restart the firewall:

      # /etc/init.d/iptables restart

    4. Run the following command to add a firewall exception for TCP port 43156:

      # /sbin/iptables -I INPUT -p tcp --dport 43156 -j ACCEPT

    5. Run the following command to save the configuration:

      # /etc/rc.d/init.d/iptables save

    6. Run the following command to restart the firewall:

      # /etc/init.d/iptables restart

  • Add a firewall exception for port 43156 in Red Hat 7.x.
    1. Log in to the host operating system as the root user.
    2. Run the following command to add a firewall exception for TCP port 43156:

      firewall-cmd --zone=public --permanent --add-port=43156/tcp

    3. Run the following command to restart the firewall:

      firewall-cmd --reload

    4. Run the command to check the addition result:

      firewall-cmd --zone=public --list-all

  • Add a firewall exception for port 43156 in the SUSE Linux operating system.
    1. Log in to the host operating system as the root user.
    2. Run the following command to open the SuSEfirewall2 file:

      # vi /etc/sysconfig/SuSEfirewall2

    3. Press i to enter the editing mode, enter the following content, and add port number 43156, as shown in Figure 3.

      FW_SERVICES_EXT_TCP="43156"

      Figure 10-21 Port
    1. Press Esc to exit the text input mode.
    2. Enter :wq to save the SuSEfirewall2 file and exit.
    3. Run the following commands to make the firewall configurations take effect:

      # rcSuSEfirewall2 restart

      # /sbin/SuSEfirewall2 start

Host Alarms Cannot Be Reported to eSight After the Agent Is Deployed
Symptom

After a host is connected in agent mode and the firewall is enabled, alarms of the host cannot be reported to the eSight.

Possible Causes

On the operating system of a target host, port 10165 is not added as a firewall exception.

Fault Diagnosis

Add a firewall exception for port 10165.

Procedure
  • Add a firewall exception for port 10165 in Red Hat 6.x and earlier versions.
    1. Log in to the host operating system as the root user.
    2. Run the following command to check whether the iptables file exists in /etc/sysconfig:

      # ls -l /etc/sysconfig | grep iptables

      • If yes, perform 3 to 7.
      • If no, perform 8.
    3. Run the following command to open the iptables file:

      # vi /etc/sysconfig/iptables

    4. Press i to enter the editing mode and add rules.
      • If RH-Firewall-1-INPUT is displayed in the rule list, enter rules shown in Figure 1.
        -A RH-Firewall-1-INPUT -m udp -p udp -dport 10165 -j ACCEPT
        Figure 10-22 Rule list of iptables
      • If INPUT is displayed in the rule list, enter rules shown in Figure 2.
        -A INPUT -m udp -p udp --dport 10165 -j ACCEPT
        Figure 10-23 Rule list of iptables
    5. Press Esc to exit the text input mode.
    6. Enter :wq to save the iptables file and exit.
    7. Run the following command to restart the firewall:

      # /etc/init.d/iptables restart

    8. Run the following command to add a firewall exception for UDP port 10165:

      # /sbin/iptables -I INPUT -p udp --dport 10165 -j ACCEPT

    9. Run the following command to save the configuration:

      # /etc/rc.d/init.d/iptables save

    10. Run the following command to restart the firewall:

      # /etc/init.d/iptables restart

  • Add a firewall exception for port 10165 in Red Hat 7.x.
    1. Log in to the host operating system as the root user.
    2. Run the following command to add a firewall exception for UDP port 10165:

      firewall-cmd --zone=public --permanent --add-port=10165/udp

    3. Run the following command to restart the firewall:

      firewall-cmd --reload

    4. Run the command to check the addition result:

      firewall-cmd --zone=public --list-all

  • Add a firewall exception for port 10165 in the SUSE Linux operating system.
    1. Log in to the host operating system as the root user.
    2. Run the following command to open the SuSEfirewall2 file:

      # vi /etc/sysconfig/SuSEfirewall2

    3. Press i to enter the editing mode, enter the following content, and add port number 10165, as shown in Figure 3.
      FW_SERVICES_EXT_UDP="10165"
      Figure 10-24 Port
    4. Press Esc to exit the text input mode.
    5. Enter :wq to save the SuSEfirewall2 file and exit.
    6. Run the following commands to make the firewall configurations take effect:

      # rcSuSEfirewall2 restart

      # /sbin/SuSEfirewall2 start

Translation
Download
Updated: 2019-06-30

Document ID: EDOC1100044378

Views: 58011

Downloads: 264

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next