HP Insight Management Agents 8.40 Managing ProLiant Servers with Linux HOW TO Whitepaper

ManualsBrandsHP ManualsSoftwareHP Insight Management Agents for HP ProLiant 100 Series Servers

Abstract .......................................................................................................................................... 2

1 Software architecture ..................................................................................................................... 2

1-1 System Health Application and Command Line Utilities (hp-health) ................................................ 2

1-1-1 Health Monitor .................................................................................................................. 4

1-1-2 Console messages ............................................................................................................. 7

1-1-3 HP Integrated Management Logging Utility (hplog) ................................................................ 7

1-1-4 HP Unique Identifier Utility (hpuid) ....................................................................................... 8

1-1-5 HP management CLI (hpasmcli) ........................................................................................... 8

1-1-6 hp ProLiant boot configuration utility (hpbootcfg) ................................................................... 8

1-2 Insight Management SNMP Agents for HP ProLiant (hp-snmp-agents) ............................................. 9

1-2-1 Server Agent ..................................................................................................................... 9

1-2-2 Storage Agent ................................................................................................................. 10

1-2-3 NIC Agent (cmanic) ......................................................................................................... 12

1-2-4 Performance Agent (cmaperfd) .......................................................................................... 12

1-2-5 Data Collection Agent ...................................................................................................... 12

1-2-6 Lights-Out Agent .............................................................................................................. 12

1-2-7 Using the HP ProLiant BL Rack Upgrade Utility .................................................................... 13

1-3 HP OpenIPMI Driver (hp-OpenIPMI) ......................................................................................... 14

1-4 HP ProLiant Channel Interface Device Driver for iLO/iLO2/iLO3 (hp-ilo) ...................................... 14

1-5 HP System Management Homepage (hpsmh) ............................................................................ 14

1-6 HP System Management Homepage Templates (hp-smh-templates) .............................................. 15

1-7 Systems Insight Manager ........................................................................................................ 15

2 Manual Installation ...................................................................................................................... 15

2-1 Prerequisite: Installing package dependencies .......................................................................... 16

2-1-1 Installing the HP OpenIPMI Driver (hp-OpenIPMI) ................................................................ 16

2-1-2 Installing the HP System Health Application and Command Line Utilities (hp-health) ................. 16

2-1-3 Installing the HP ProLiant Channel Interface Device Driver for iLO/iLO2/iLO3 (hp-ilo) ............. 17

2-1-4 Installing the Insight Management SNMP Agents for HP ProLiant Systems ............................... 17

2-2 Uninstalling drivers and agents ............................................................................................... 18

2-3 Transitioning from hpasm, hprsm, and cmanic packages ............................................................ 18

2-4 Updating drivers and agents ................................................................................................... 19

3 Customization ............................................................................................................................. 19

3-1 Configuration files ................................................................................................................. 20

3-2 Starting and stopping agents and services ................................................................................ 21

3-3 Parameters ........................................................................................................................... 21

Appendix A – Error messages .......................................................................................................... 23

Appendix B – Troubleshooting ......................................................................................................... 27

Appendix C – hp-snmp-agents command lines and arguments ............................................................. 32

Call to action ................................................................................................................................. 35

Managing ProLiant Servers with Linux

HOWTO

Summary of content (36 pages)

PAGE 1
Managing ProLiant Servers with Linux HOWTO Abstract .......................................................................................................................................... 2 1 Software architecture ..................................................................................................................... 2 1-1 System Health Application and Command Line Utilities (hp-health) ................................................ 2 1-1-1 Health Monitor ..................................
PAGE 2
Managing ProLiant Servers with Linux – HOWTO v8.40 Abstract This HOWTO provides instructions to help system administrators install, upgrade, and remove Version 8.4.
PAGE 3
Managing ProLiant Servers with Linux – HOWTO v8.40 Channel Interface Device Driver for iLO/iLO 2 (hp-ilo) package to provide secure remote management of the server including IML management and graphical remote console. The hp-health Version 8.4.0 includes four applications (listed in Table 1). One of these modules is automatically selected at startup depending on the HP ProLiant Advanced System Management hardware available and the base packages installed.
PAGE 4
Managing ProLiant Servers with Linux – HOWTO v8.40 alternate set of IPMI drivers, provides no additional benefit on this class of severs. hp-OpenIPMI is neither tested nor supported by HP on 100 series ProLiants. * The hpasmxld application is more efficient than the hpasmlited application as a result of leveraging the high performance hpOpenIPMI package, which includes support for IPMI 2.0 OEM message channels and messages.
PAGE 5
Managing ProLiant Servers with Linux – HOWTO v8.40 The Health Monitor augments the hardware features built into ProLiant servers. Basic features, such as temperature, fan, power supply, and memory monitoring are standard on almost all ProLiant servers. On some ProLiant servers, the Health Monitor supports features such as variable speed fans, server lights that give a visual indication of a possible error condition, and Advanced Memory Protection (AMP).
PAGE 6
Managing ProLiant Servers with Linux – HOWTO • • v8.40 Makes an entry in the system health log and the operating system log Shuts down the system (optionally) to avoid hardware damage Use RBSU to control the shutdown option.
PAGE 7
Managing ProLiant Servers with Linux – HOWTO • • • v8.40 A software or kernel application consumes all available memory, including the virtual memory space (for example, swap). This can cause the operating system scheduler to cease functioning. A critical operating system component, such as a file system, fails and causes the operating system scheduler to cease functioning. Any event other than an ASR timeout causes a Non-Maskable Interrupt (NMI) to be generated.
PAGE 8
Managing ProLiant Servers with Linux – HOWTO v8.40 1-1-4 HP Unique Identifier Utility (hpuid) The HP Unique Identifier Utility (hpuid) allows local manipulation of the ProLiant Unique Identifier (UID) blue light on selected ProLiant servers. The hpuid utility allows the light to be turned on and off and displays the current status of the light (Table 4).
PAGE 9
Managing ProLiant Servers with Linux – HOWTO v8.40 1-2 Insight Management SNMP Agents for HP ProLiant (hpsnmp-agents) The ProLiant Insight Management Agents provide proactive notification of server events through the HP Systems Insight Manager console. Alternatively, the ProLiant Insight Management Agents allow the status of the server to be monitored or checked using a standard Web browser.
PAGE 10
Managing ProLiant Servers with Linux – HOWTO • v8.40 Standard peripheral information (serial ports, diskette drives, and so on) The Standard Equipment Agent executable is /opt/hp/hp-snmp-agents/server/bin/cmastdeqd. System Health Agent (cmahealthd) The System Health Agent gathers data for the Health MIB. The data collected includes critical (NMI) errors, correctable memory (ECC) errors, system hang/panic detection, temperature conditions, and fan failures.
PAGE 11
Managing ProLiant Servers with Linux – HOWTO • v8.40 IDA physical drive information The IDA Agent is located in /opt/hp/hp-snmp-agents/storage/bin/cmaidad. The suggested poll_time is 15 seconds (default). The minimum recommended poll_time is 5 seconds. IDE Agent (cmaidad) The IDE Agent gathers data for the IDE MIB. The data includes: • IDE host controller information • ATA disk information • ATAPI device information The IDE Agent is located in /opt/hp/hp-snmp-agents/storage/bin/cmaided.
PAGE 12
Managing ProLiant Servers with Linux – HOWTO v8.40 1-2-3 NIC Agent (cmanic) The NIC Agent collects information from network interface controllers at periodic intervals, makes the collected data available to the SNMP agent, and provides SNMP alerts. The NIC Agent gathers data for the NIC MIB from supported NIC device drivers. The data includes: • • Physical mapping and configuration data for each network interface. Network statistics for Ethernet interfaces. Information is provided for HP controllers.
PAGE 13
Managing ProLiant Servers with Linux – HOWTO v8.40 microprocessor on the power enclosure. Rack Infrastructure Information Service Daemon (cpqriisd) The Rack Infrastructure Information Service Daemon (cpqriisd) enables communication through the Integrated Lights-Out Management component to the rack infrastructure. The daemon opens and sustains communication with the Integrated Lights-Out management controller.
PAGE 14
Managing ProLiant Servers with Linux – HOWTO • • v8.40 Lights-Out User Guide located at http://h18013.www1.hp.com/manage/ilo-description.html When updating enclosure management controllers in more than one enclosure, the new image must be transmitted twice (first to the local enclosure and second to the remote enclosures using broadcast mode). The update process can take 10 minutes or more. The update process notifies the user if the update succeeded or failed.
PAGE 15
Managing ProLiant Servers with Linux – HOWTO v8.40 System Management Homepage, previously called ProLiant Management Agents, installed using a standard Web browser. The HP System Management Homepage responds to port 2381 (if the installed browser supports SSL encryption). For example, point the browser to https://192.1.1.20:2381 or https://localhost:2381 (the "https://" portion of the address is required).
PAGE 16
Managing ProLiant Servers with Linux – HOWTO v8.40 2-1 Prerequisite: Installing package dependencies The software described in this HOWTO is distributed in standard package formats that provide prerequisite information internally. If you attempt to install a component that does not have its prerequisites fulfilled, the installation will abort and you will be given a list of missing prerequisites.
PAGE 17
Managing ProLiant Servers with Linux – HOWTO v8.40 # rpm –Uvh hp-health-...rpm For more information about this component, see the online documentation by entering: $ man hp-health Note: The version number for the RPM file varies depending on the supported systems and functionality. The distribution refers to the Linux distribution supported by the RPM. The platform refers to the processor architecture the RPM was built to support.
PAGE 18
Managing ProLiant Servers with Linux – HOWTO 1. v8.40 To configure and activate agents, execute the following command as root: # /sbin/hpsnmpconfig Provide basic Simple Network Protocol (SNMP) information, when prompted. The drivers and agents are inserted immediately. 2. To start hp-snmp-agents, execute the following command as root: # /etc/init.d/hp-snmp-agents start Or # service hp-snmp-agents start 3. To check if the agents are loaded properly, enter the following command: $ /etc/init.
PAGE 19
Managing ProLiant Servers with Linux – HOWTO v8.40 If you have any local customizations to the /etc/hpasmrc file, save a copy of that file before removing the hpasm component. After installing hpsnmp-agents, you can make the same modifications to the /etc/hp-snmpagents.conf file. To determine if these components are loaded, enter the command listed in the To verify installation column in Table 11. To remove the component, enter the command shown in the To remove column.
PAGE 20
Managing ProLiant Servers with Linux – HOWTO v8.40 3-1 Configuration files The ProLiant Management Agents Configuration file /opt/hp/hp-snmp-agents/cma.conf is shared by all HP ProLiant Management Agents. Currently, exclude directives, taint directives, trap interface, trap email notification configuration, and base socket number (used by cmaX) are supported. The agents are capable of sending email notifications in addition to SNMP traps. The trapemail entries in /opt/hp/hp-snmpagents/cma.
PAGE 21
Managing ProLiant Servers with Linux – HOWTO v8.40 You can also manipulate the /opt/hp/hp-snmp-agents/cma.conf file which contains one or more exclude directives. Any string after the exclude keyword is interpreted as an agent name that should not be started. Examples include: exclude cmahealthd exclude cmastdeqd These two lines exclude two agents from the startup: the Health Agent (cmahealthd) and the Standard Equipment Agent (cmastdeqd).
PAGE 22
Managing ProLiant Servers with Linux – HOWTO v8.40 Agent is not allowed to send traps. For example, to set the poll interval to 30 seconds and prevent traps, change PFLAGS= to PFLAGS="- p30 -t NOT_OK" in the /opt/hp/hp-snmp-agents/nic/etc/cmanicd script. Traps are configured using the standard SNMP configuration file (snmpd.conf). See the snmpd.conf manual page for the most current configuration information. When the snmpd.conf or snmpd.local.
PAGE 23
Managing ProLiant Servers with Linux – HOWTO v8.40 Appendix A – Error messages Messages logged if an ASR event occurs are listed in Table 14. Table 14: Error messages Message Number Details Message 1 NMI-Automatic Server Recovery timer expiration – Hour %d-%d/%d/%d Message 2 Message 3 Message 4 Description This message indicates that the Health Monitor detected an ASR timeout and is attempting to gracefully shut down the Operating System.
PAGE 24
Managing ProLiant Servers with Linux – HOWTO v8.40 The cpqriisd service acts as an enabler for other ProLiant value-add software, such as the Rack Agent and the Rack Upgrade Utility. This service is only applicable for p-Class blade systems. If the service goes away after a few seconds, there is a failure to initiate communication with the iLO management controller. The failure reason is logged in the message log.
PAGE 25
Managing ProLiant Servers with Linux – HOWTO Recommended action Message 6 Message 7 Message 8 Message 9 v8.40 No action is required, since this message is informational. Alert only seems to reach %d out of %d client applications Description The alerts coming from the infrastructure seem to be dispatched to a subset of registered clients only. Most likely a client terminated suddenly without properly deregistering itself.
PAGE 26
Managing ProLiant Servers with Linux – HOWTO Description Recommended action Message 11 Message 12 Message 13 Message 14 v8.40 These messages indicate a problem that occurred during initialization of the service.
PAGE 27
Managing ProLiant Servers with Linux – HOWTO v8.40 Appendix B – Troubleshooting This section describes common problems that might occur during installation and operation of the HP ProLiant Management Software for Linux. Table 16 describes issues and workarounds for the hp-health and hp-snmp-agents packages. Any problems reported to HP should include the following files: • • • • • /var/log/messages /var/log/boot.
PAGE 28
Managing ProLiant Servers with Linux – HOWTO v8.40 # Don’t log private authentication messages! * . info;mail .none;news .none;authpriv.
PAGE 29
Managing ProLiant Servers with Linux – HOWTO v8.40 Table 17 describes common problems that might occur during installation and operation of the Host OS Agent, the Standard Equipment Agent, the SCSI Agent, the System Health Agent, the Threshold Agent, and the Peer Agents. In most cases, a workaround is available.
PAGE 30
Managing ProLiant Servers with Linux – HOWTO v8.40 Workaround Issue 5 Missing or 0-value SCSI hard drive serial number or capacity Workaround Issue 6 • The SCSI agent process “cmascsid” might not be running • The SCSI controller might have been disabled by the System Configuration Utility • This might be an unsupported controller Check the Mass Storage Agent status with the Linux command “ps –ef | grep cma”. See the entries for cmaidad, cmafcad, cmascsid, cmasasd and cmaided.
PAGE 31
Managing ProLiant Servers with Linux – HOWTO v8.40 • Issue 10 The Remote Insight Agent cmasm2d might not be running Unable to change any values on the managed server or no SNMP traps/alarms are received Workaround To work around this issue, complete the following steps: 1. Be sure that the SNMP agent, the Peer agent and the agent processing the set are all running 2. Check the agent command line arguments in the agent start script files 3.
PAGE 32
Managing ProLiant Servers with Linux – HOWTO v8.40 2. Start the Threshold agent using the following command: # /opt/hp/hp-snmp-agents/server/etc/cmasthreshd start Issue 12 Disabling SNMP sets for a specific agent Workaround Issue 13 Disabling SNMP traps for a specific agent Workaround Issue 14 Stop the agent associated with the desired MIB. Change the agent command line argument set switch to “-s NOT_OK” in the corresponding /opt/hp/hp-snmpagents//etc/ file.
PAGE 33
Managing ProLiant Servers with Linux – HOWTO v8.
PAGE 34
Managing ProLiant Servers with Linux – HOWTO v8.40 -t trap_state Specifies whether SNMP trap commands are allowed for this agent. A trap_state of OK (default) means that SNMP trap commands are allowed. A trap_state of NOT_OK means that SNMP trap commands are not allowed.
PAGE 35
Managing ProLiant Servers with Linux – HOWTO v8.40 Call to action Send comments about this paper to TechCom@hp.com. © Copyright 2010 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty.
PAGE 36
Managing ProLiant Servers with Linux – HOWTO v8.