Most FreeIPMI tools can operate in-band by using one of the in-band drivers included. These in-band drivers include a userspace KCS interface driver, a SSIF driver through the Linux SSIF device (i.e. /dev/i2c-0), the OpenIPMI Linux kernel driver (i.e. /dev/ipmi0), the Sun/Solaris BMC driver (i.e. /dev/bmc), and the Intel DCMI/MEI driver (i.e. /dev/dcmi). If your system requires the use of installed drivers, those appropriate modules must be installed ahead of time. However, most systems should automatically load these drivers when appropriate.
Under most scenarios, the FreeIPMI tools should automatically discover which in-band interface to use and the proper settings to use. Users may execute the tools on the command line to begin using them. Some motherboards may require you to determine driver type, addresses, paths, etc. on your own and pass them as command line options to the tools. You may use ipmi-locate(8) to help determine this information. Other tools such as dmidecode(8) may also provide this information.
To use IPMI out-of-band with tools such as ipmipower(8) or ipmi-sensors(8), the remote machine's BMC must first be configured for out of band communication. Typically, this involves setting a username, password, IP address, MAC address, and a few other parameters. This can be done using the tool ipmi-config(8). Additional information on how to configure with ipmi-config(8) can be found in the ipmi-config.conf(5) manpage. Some vendors may pre-configure their motherboards with default values so that ipmi-config(8) can be used remotely to configure the machine. However, most of the time, the BMC must be configured in-band before out-of-band access can be allowed (for example, the correct IP address and MAC address must be configured).
In order to remotely connect to a machine, you typically must specify the host, username, and password for the tool in order to connect. Depending on configuration settings, a K_g key, privilege level, authentication type, cipher suite id, or protocol version may need to be specified.
Some vendors may have not implemented IPMI properly and a workaround must be specified into FreeIPMI to ensure the tool can execute properly. For example, a fair number of vendors have populated their FRU records with invalid checksums. To properly ignore these set of checksums a skipchecks workaround has been added to ipmi-fru(8). Please see each of the tool manpages to see a list of available workarounds.
Additional information, examples, and general trouble-shooting can be found in each of the tool manpages.
ipmi-sensors
A tool to read IPMI sensor readings to aid in system monitoring.
ipmi-sel
A tool to read and manage IPMI System Event Log (SEL) records to aid in system debugging.
ipmipower
A tool for remote power control.
ipmiconsole
A tool for Serial-over-Lan (SOL) console access.
Many other tools and libraries are listed below that cover additional features and areas of IPMI.
Additional information, examples, and general trouble-shooting can be found in each of the tool manpages.
bmc-info
A tool to read information about a BMC such as device version numbers, device support, and globally unique IDs (guids).
bmc-watchdog
A tool/daemon to manage a BMC Watchdog. This tool is typically used for system timeout management and automatic system restarts in the event of a system crash.
ipmi-chassis
A tool to manage/monitor a chassis, such as chassis power, identification (i.e. LED control), and status.
ipmi-fru
A tool to read field replaceable unit (FRU) information from a motherboard/machine.
ipmi-sel
A tool to read and manage IPMI System Event Log (SEL) records. SEL records store system event information and may be useful for debugging problems.
ipmi-sensors
A tool to read IPMI sensor readings and sensor data repository (SDR) information.
ipmipower
A tool for remote power control.
ipmiconsole
A tool for Serial-over-Lan (SOL) console access.
ipmi-config
A tool to configure BMC and IPMI information. In can be used to configured usernames, passwords, networking information, security, Serial-over-LAN (SOL), Platform Event Filtering (PEF), boot devices, power restoration policy, sensor thresholds, sensor events, and many more configuration options.
ipmi-raw
A tool that provides hex input/output of IPMI commands.
ipmi-locate
A tool that can probe for information about the location of a BMC device, such as device addresses.
ipmi-pet
A tool to parse and interpret Platform Event Traps (PET).
ipmi-dcmi
A tool to perform Data Center Manageability Interface (DCMI) IPMI extension commands. Supports extensions for asset management and power usage management.
bmc-device
A tool to perform advanced BMC commands, such as resetting the BMC, configuring ACPI, configuring SDR/SEL time, manually generating events, re-arming sensors, and configuring manufacturer settings.
ipmiping
An IPMI ping tool for debugging.
rmcpping
A RMCP ping tool for debugging.
ipmi-oem
An IPMI tool for OEM specific commands.
ipmidetect/ipmidetectd
A tool and daemon for IPMI node detection.
ipmiseld
A daemon that regularly polls the SEL and stores the events to the local syslog.
Additional information, examples, and general trouble-shooting can be found in each of the tool manpages.
libfreeipmi
A C library that includes KCS, SSIF, and OpenIPMI Linux, and Solaris BMC drivers, IPMI 1.5 and IPMI 2.0 LAN communication interfaces, IPMI packet building utilities, IPMI command utilities, and utilities for reading/interpreting/managing IPMI. This library is for programmers intimately familiar with the IPMI protocol and IPMI specification. Most users may wish to use the libraries listed below.
libipmiconsole
A library for Serial-over-Lan (SOL) console access. SOL console access is abstracted into a file descriptor interface, so users may read and write console data through a file descriptor.
libipmimonitoring
A library for sensor and system event log (SEL) monitoring that abstracts away most IPMI details. Interpretation of those sensors and events is abstracted into an API with an iterator interface.
libipmidetect
A library for IPMI node detection.
FreeIPMI is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
http://www.gnu.org/software/freeipmi/