HP Management Base Installation and User's Guide *5991–5421* HP Part Number: 5991–5421 Published: May 2006 Edition: 1
© Copyright 2006 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Table of Contents About This Document.....................................................................................5 Intended Audience..................................................................................................................................5 Document Organization...........................................................................................................................5 Typographic Conventions......................................................................
About This Document This document provides installation and user information for the HP Management Base (hpmgmtbase). Intended Audience This document is intended for Linux system administrators and assumes that the user has experience installing and managing Linux systems. This document is intended to be used in conjunction with the operations and maintenance guides for any Integrity servers on which hpmgmtbase is installed.
Documentation Updates For the latest updates to the hpmgmtbase documentation, please see one of the following Web sites: • http://www.hp.com/go/integritylinux • http://www.docs.hp.com/linux Publishing History The document printing date and part number indicate the document’s current edition. The printing date will change when a new edition is printed. Minor changes may be made at reprint without changing the printing date. The document part number will change when extensive changes are made.
1 Overview of hpmgmtbase HP Management Base (hpmgmtbase) is a collection of software that includes driver modules, daemons, shared libraries, lookup files, and utility support for other HP manageability software (such as SNMP Agents or WBEM providers). All HP Integrity servers provide their platform manageability information via hardware that realizes the Intelligent Platform Management Initiative (IPMI) specification. A key component of IPMI is the Baseboard Management Controller (BMC).
2 Installing hpmgmtbase This chapter describes the installation procedures for hpmgtbase. Installation Prerequisites A typical server installation usually includes these items needed by hpmgmtbase will not install without these items. • An officially supported version, update, or errata kernel for • RedHat Advanced Server 2.1 • RedHat Enterprise Linux Advanced Server (AS) 3.0 • RedHat Enterprise Linux Advanced Server (AS) 4.0 • SuSE LINUX Enterprise Server 8.0 • SuSE LINUX Enterprise Server 9.
3 Using hpmgmtbase This chapter describes how to use the hpmgmtbase utilities. All utilities have manpages. hpmgmtbase Utilities The following command-line utilities are part of hpmgmtbase. hpuid — hp Unique Identifer (UID) utility Syntax /sbin/hpuid [-d] [-e] [-s] [-v] The Unique Identifier (UID) is a flashing LED on the chassis used to identify a box. This can be a great aid when confronted with a server farm of hundreds of boxes.
Refer to hpbmc(8) for an explanation of all directives. This section discusses some of the background processing done by hpmgmtbase and hpbmc. All IPMI commands are a command/response message protocol with a requestor and a responder. In most cases on HP hardware using HP software, programs running under Linux are the requestor, and the system's BMC is the responder. The BMC hardware is exposed through a System Interface as described in the IPMI specification.
specify the target. For example, to issue Get Device ID command to IPMB address 0x82 behind an RMCP responder at atca.fc.hp.com with password please, the syntax is # hpbmc -d please@atca.fc.hp.com -b 82 IPMIraw 18 1 Decoding Events hpmgmtbase libraries and utilities generate extensive decoding of System Event Log (SEL) entries. HP Integrity Servers support several event types in the SEL. The first is type 02 events which are mostly documented and described in the IPMI specification.
4 Troubleshooting In the discussion that follows, all programs (and drivers) attempt to talk to the local system BMC. No RMCP is used, no -d argument is used, and the shell environment variable EZBMC_DEVICE is unset. Proper Function In a properly functioning system the following should be observed: 1. 2. 3. 4. 5. 6. 7. No errors during installation of hpmgmtbase. Three IPMI kernel modules are visible from lsmod. An IPMI character device major number is visible from cat /proc/devices.
Sometimes other user or system actions cause the distribution's drivers to be loaded before hpmgmtbase is installed, and hindsight shows that was a mistake. Follow the following steps: 1. /etc/init.d/hpima stop /etc/init.d/hpwebm stop /etc/init.d/hpmgmtbase stop # If SNMP agents are installed # If SNMP agents are installed to stop any HP IPMI programs that might be running. 2. /etc/init.d/hpmgmtbase unconfigure erases current knowledge of appropriate IPMI drivers. 3.
5 Rebuilding the Kernel The hpmgmtbase scripts examine the running kernel version to assist in the selection of the appropriate binaries for the HP-supplied Open IPMI modules. If the kernel (version) is changed that selection process will probably need to be executed again. This may not be apparent until a reboot of the new kernel when hpmgmtbase fails to initialize, or other programs that are dependent on the Open IPMI driver fail to start.
A Frequently Asked Questions This section addresses frequently asked questions concerning hpmgmtbase. 1. I have a custom kernel, and none of the IPMI modules work. See Chapter 5. 2. Can I use the Open IPMI driver directly from my own programs? Yes. There are several open source tools that use direct access to the Open IPMI driver device interface. One of these is the Open IPMI Library, which can be found at http://www.sf.net/projects/openipmi.
Glossary BMC Baseboard Management Controller. The IPMI spec describes the BMC as the "heart of IPMI". It is an embedded microcontroller surrounded by memory, interfaces, and sensors. The entire collection can provide the various functions described in the specification. BT Block Transfer. One of the System Interfaces used to connect a BMC to a system CPU. BT is used in HP Integrity midrange and highend systems. It transfers data in blocks and is much faster than KCS or SMIC. FPL Forward Progress Log.
SDRR Sensor Data Record Repository. A required feature of a BMC, this is the material list for IPMI. It starts with the list of sensors, their conversion and units, thresholds, and scanning information. The SDRR also holds FRU lists, entity associations, and HP proprietary entries. The SDRR completely describes the resources of an HP Integrity Server. SEL System Event Log.
Index B Baseboard Management Controller (see BMC) BMC, 7 System Event Log (see SEL) T Troubleshooting, 15 C Cell assignment monitored by hpbmc, 7 E events decoding, 13 F Forward Progress Log (see FPL) FPL, 7 Frequently asked questions, 19 H hpbmc, 11 hpmgmtbase components, 7 installing, 9 overview, 7 using, 11 utilities, 11 hpseld, 7, 11 hpuid, 11 I Installation prerequisites, 9 procedures, 9 K kernel rebuilding, 17 L Log event, 7 forward progress, 7 P Partition assignment monitored by hpbmc, 7 R
