Managing ProLiant servers with Linux HOWTO

ManualsBrandsHP ManualsSoftwareHP System Management Homepage Software

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................................................................................................................ 6

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

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

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

1-2-1 Server Agent ....................................................................................................................... 7

1-2-2 Storage Agent ..................................................................................................................... 8

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

1-2-4 Data Collection Agent ........................................................................................................ 10

1-2-5 Lights Out Agent ................................................................................................................ 10

1-2-6 Using the HP ProLiant BL Rack Upgrade Utility ....................................................................... 10

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

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

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

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

1-7 Systems Insight Manager........................................................................................................... 12

2 Manual Installation ......................................................................................................................... 13

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

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

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

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

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

2-2 Uninstalling drivers and agents .................................................................................................. 15

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

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

3 Customization ................................................................................................................................ 16

3-1 Configuration files .................................................................................................................... 16

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

3-3 Parameters .............................................................................................................................. 18

Appendix A – Error messages ............................................................................................................. 19

Appendix B – Troubleshooting............................................................................................................. 22

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

Managing ProLiant servers with Linux

HOWTO

Summary of content (30 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
Abstract This HOWTO provides instructions to help system administrators install, upgrade, and remove Version 8.1.
PAGE 3
hp-health Version 8.1.0 includes three applications (listed in Table 1). One of these modules is automatically selected at startup depending on the HP ProLiant Advanced System Management hardware available. Note: To determine the type of HP ProLiant Advanced System Management hardware installed, check the ProLiant server specifications located on www.hp.com. Table 1: hp-health Version 8.1.
PAGE 4
These man pages include detailed information on error messages and possible action that the administrator can take. Additional information about the Insight Management SNMP Agents for HP ProLiant Systems is available at the following locations: • www.hp.com/servers/manage • http://h18000.www1.hp.com/products/servers/management/agents.html 1-1-1 Health Monitor The Health Monitor augments the hardware features built into ProLiant servers.
PAGE 5
1-1-1-2 System fan monitoring A ProLiant server can contain fan sensors. On ProLiant servers with intelligent fan sensors, check the status of the fans by running hplog -f. If a cooling fan fails and there is no secondary redundant fan, the Health Monitor does the following: • Displays a message on the console stating the problem • 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 6
Events that can contribute to the operating system locking up include: • A peripheral device, such as a Peripheral Component Interconnect Specification (PCI) adapter, generates numerous spurious interrupts when it fails. • A high priority software application consumes all the available central processing unit (CPU) cycles and does not allow the operating system scheduler to run the ASR timer reset process.
PAGE 7
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 3). Table 3.
PAGE 8
Sub-agent Standard Equipment Agent (cmastdeqd) Description The Standard Equipment Agent gathers data for the Standard Equipment MIB. The data includes: • PCI slot information. • Processor and coprocessor information. • 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.
PAGE 9
Sub-agent IDE Agent (cmaided) Description 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. The suggested poll_time is 15 seconds. The minimum recommended poll_time is 5 seconds. FCA Agent (cmafcad) The FCA agent gathers data for the FCA MIB.
PAGE 10
1-2-4 Data Collection Agent Data Registries are composed of standard Linux directories and associated files. Each file in the data registry is a logical object containing "n" related data items. The MIB items supported by the Server Data Collection Agents are listed in the /opt/hp/hp-snmpagents/mibs/cmafdtnobjects.conf and /opt/hp/hp-snmp-agents/mibs/cmasvrobjects.conf files.
PAGE 11
Parameter Description -e This parameter disregards the local enclosure (for example, the enclosure containing the server from which you flash) in the flashing. This parameter is given in conjunction with –a or –c. -l This parameter disregards anything but the local enclosure (for example, the enclosure containing the server from which you flash). This parameter should not be given with –a or –c.
PAGE 12
1-5 HP System Management Homepage (hpsmh) The HP System Management Homepage is a web-based interface that consolidates and simplifies single system management for HP servers running Linux operating systems. The System Management Homepage aggregates and displays data from Web Agents and other HP Web-enabled System Management Software that includes HP Insight Diagnostics, the Array Configuration Utility, and the HP Software Version Control Agents.
PAGE 13
2 Manual Installation This section describes how to install, upgrade, and remove the packages for HP System Health Application and Command Line Utilities (hp-health) and Insight Management SNMP Agents for HP ProLiant Systems (hp-snmp-agents). The latest versions of this software can be downloaded from http://hp.com/go/proliantlinux.
PAGE 14
2-1-2 Installing the HP System Health Application and Command Line Utilities (hp-health) To install hp-health, login as the root user, and then enter: # rpm –Uvh hp-health-...rpm 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 15
2-2 Uninstalling drivers and agents There are two options for preventing the drivers and agents from running, uninstalling, and starting or stopping drivers. For information on uninstalling or unloading drivers or agents, see “Starting and stopping agents and services” on page 17. Table 8 lists the commands for uninstalling the entire contents of the hpasm, hprsm, and cmanic packages. Table 8.
PAGE 16
Component To verify installation To remove NIC Agents $ rpm –q cmanic #rpm -e cmanic Note: Remove cmanic and hprsm before removing hpasm, because of driver dependencies. If concurrent access on the RPM database is attempted, the following messages can result: • rpmQuery: rpmdbOpen() failed • cannot get shared lock on database • rpmQuery: rpmdbOpen() failed 2-4 Updating drivers and agents The following section provides information on updating the HP ProLiant Management Software for Linux.
PAGE 17
The keyword "trapemail" indicates that the rest of the line is the command for sending trap email. In mail_command, you must provide the full path of your email command, the subject, and the recipients. Multiple trapemail lines can be defined in /opt/hp/hp-snmp-agents/cma.conf. A default line is added during installation if none exists: trapemail /bin/mail -s 'HP Insight Management Agents Trap Alarm' root The mail_command can be any Linux command that reads standard input.
PAGE 18
For Red Hat and SuSE systems: # service hp-health stop # service hp-snmp-agents stop 3-3 Parameters This section lists parameters for various agents and services. Table 10 includes the command line arguments that can be passed to the NIC agents (cmanicd) from the /opt/hp/hp-snmp-agents/nic/etc/cmanicd script. Table 10. Parameters for NIC agents Parameter Description -p poll_time This parameter specifies the number of seconds between data caching and poll intervals.
PAGE 19
Appendix A – Error messages Messages logged if an ASR event occurs are listed in Table 12. Table 12. 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 20
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. If the service is stopped, dependent applications like the Rack Firmware Upgrade Utility terminate as well. Table 13 lists possible issues.
PAGE 21
Message number Details Recommended action Issue 6 Issue 7 Issue 8 Issue 9 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 22
Message number Details Description These messages indicate a problem that occurred during initialization of the service. The main reasons for failure include: • Absence of the iLO Driver. • iLO encountered problems and is in an undefined state. • The operating system is running out of resources (for example, memory, threads, semaphores, and so on). Recommended action Issue 11 Issue 12 Issue 13 Issue 14 Verify that the iLO Driver is installed and reboot the server. start failed.
PAGE 23
Table 14. Known issues for hp-health Issue number Details Issue 1 Non-certified machines Symptom When the hpasm RPM file is installed, the following message displays: hpasm: system This driver is not supported on this The driver is not inserted into the list of modules. Cause The Health Monitor cannot be initialized due to a conflict in ROM internal tables, or the server is not supported.
PAGE 24
Issue number Details Symptom You experience the following problems: • Commands like insmod, modprobe, rmmod, or rpm are not available. • The RPM install fails because file permissions are being denied (see below). "Failed to open //var/lib/rpm/packages.rpm error: cannot open //var/lib/rpm/packages.rpm" Issue 5 Cause Preparing a driver install necessitates access to system administrator rights. Workaround Be sure to log in as "root" before you attempt the driver install.
PAGE 25
Issue number Details Workaround Check the Standard Equipment Agent status with the Linux command ps –ef | grep cmastdeqd. If the agent is not running, start the Standard Equipment Agent manually using the following command: #/opt/hp/hp-snmp-agents/server/etc/cmastdeqd start If the agent is running but not reporting data, or if the agent was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as "root" to access this file.
PAGE 26
Issue number Details Workaround To work around this issue, complete the following steps: 1. Be sure your system supports the System Health Agent features. These features are supported only on HP ProLiant servers. 2. Check the System Health Agent status with the Linux command ps -ef | grep cmahealthd. If the agent is not running, it must be started (see the start/stop documentation for the System Health Agent).
PAGE 27
Issue number Details Workaround Check the Threshold Agent status with the Linux command: ps -ef | grep cmathreshd. If the agent is not running, start the Threshold Agent using following command: #/opt/hp/hp-snmp-agents/server/etc/cmathreshd start If the agent is running but not reporting data, or if it was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file.
PAGE 28
Appendix C – hp-snmp-agents command lines and arguments Table 16 lists the command lines and Table 17 lists the command arguments for hp-snmp-agents. Table 16.
PAGE 29
Table 17. Command arguments for hp-snmp-agents Command line argument Description -p poll_time Specifies the number of seconds to wait between data collection intervals. The minimum allowed value is 1 second and the default value is 60 seconds. -s set_state Specifies whether SNMP set commands are allowed for this agent. A set_state of OK (default) means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed.
PAGE 30
© Copyright 2008 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. HP shall not be liable for technical or editorial errors or omissions contained herein.