freeipmi man page on Oracle

Man page or keyword search:  
man Server   33470 pages
apropos Keyword Search (all sections)
Output format
Oracle logo
[printable version]

/* Copyright (C) 1991‐2012 Free Software Foundation, Inc.
   This file is part of the GNU C Library.

   The	GNU  C	Library is free software; you can redistribute it
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later ver‐

   The	GNU  C Library is distributed in the hope that it will be
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Pub‐
   License along with the GNU C Library; if not, see
   <>.  */ /* This header is separate
from features.h so that the compiler can
   include  it	implicitly at the start of every compilation.  It
   not itself include <features.h> or any other header	that  in‐
   <features.h>	 because  the  implicit	 include comes before any
   test macros that may be defined in a	 source	 file  before  it
   explicitly  includes	 a  system header.  GCC knows the name of
   header in order to preinclude it.  */ /* We do support the IEC
559  math  functionality,  real	 and complex.  */ /* wchar_t uses
ISO/IEC 10646 (2nd ed., published 2011‐03‐15) /
FREEIPMI(7)			   Overview			   FREEIPMI(7)

   Unicode 6.0.	 */ /* We do not support C11 <threads.h>.  */

       FreeIPMI - FreeIPMI overview

       FreeIPMI provides in-band and out-of-band IPMI software	based  on  the
       IPMI v1.5/2.0 specification.

What is IPMI?
       The IPMI specification defines a set of interfaces for platform manage‐
       ment and is implemented by a number vendors for system management.  The
       features of IPMI that most users will be interested in are sensor moni‐
       toring, system event monitoring,	 power	control,  and  serial-over-LAN
       (SOL).  The  FreeIPMI  tools  and libraries listed below should provide
       users with the ability to access and utilize these and many other  fea‐
       tures of IPMI.

Getting Started with IPMI
       IPMI can be used in-band (i.e. running on a machine locally) or out-of-
       band (i.e. connecting remotely).

       Most FreeIPMI tools can operate in-band by using	 one  of  the  in-band
       drivers	included. These in-band drivers include a direct KCS interface
       driver, a Linux SSIF driver through the SSIF device (i.e.  /dev/i2c-0),
       the OpenIPMI Linux kernel driver (i.e. /dev/ipmi0), and the Sun/Solaris
       BMC driver  (i.e.  /dev/bmc).  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-sen‐
       sors(8), the remote machine's BMC must first be configured for  out  of
       band  communication. Typically, this involves setting a username, pass‐
       word, IP address, MAC address, and a few other parameters. This can  be
       done  using  the	 tool bmc-config(8).  Additional information on how to
       configure with bmc-config(8) can be  found  in  the  bmc-config.conf(5)
       manpage. Some vendors may pre-configure their motherboards with default
       values so that bmc-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	 prop‐
       erly.  For  example,  a fair number of vendors have populated their FRU
       records with invalid checksums. To properly ignore these set of	check‐
       sums 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.

General Use
       The primary tools that most users of FreeIPMI will be interested in for
       system management are the following:


       A tool to read IPMI sensor readings to aid in system monitoring.


       A tool to read and manage IPMI System Event Log (SEL) records to aid in
       system debugging.


       A tool for remote power control.


       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.

       In  order  to  avoid  typing  in a long list of command line options to
       specify IPMI communication requirements everytime a command is executed
       (e.g.  driver  paths,  usernames, passwords, etc.), an alternate set of
       default values can be set for most FreeIPMI tools in the FreeIPMI  con‐
       figuration file. See freeipmi.conf(5) for more information.

HPC Support
       Much  of	 FreeIPMI was written with HPC support in mind. The configura‐
       tion tools ( bmc-config(8), ipmi-pef-config(8), ipmi-sensors-config(8),
       and  ipmi-chassis-config(8)  )  come  with file input/output support so
       that configuration can be copied and verified across nodes in  a	 clus‐
       ter. Most tools (like ipmipower(8) and ipmi-sensors(8) ) come with hos‐
       trange support so multiple hosts can be specified on the	 command  line
       at  the	same time and IPMI can be executed against the hosts in paral‐
       lel. See tool manpages for more information.   Also  see	 the  document
       freeipmi-hostrange.txt  for  detailed usage and explanation.  Ipmi-sen‐
       sors(8) and the libipmimonitoring(3) library  support  the  ability  to
       interpret  sensor  readings  as well as just reporting them. By mapping
       sensor readings into NOMINAL, WARNING, or  CRITICAL  states,  it	 makes
       monitoring sensors easier across large numbers of nodes.

       For  information	 on  the  libraries  that  can be used to program IPMI
       applications with, please see libfreeipmi(3), libipmiconsole(3), libip‐
       mimonitoring(3),	 and  libipmidetect(3).	 Or see the document freeipmi-

Project Tools
       The following tools are distributed and supported by FreeIPMI.


       A tool to read information about a BMC such as device version  numbers,
       device support, and globally unique IDs (guids).


       A tool to configure general BMC and IPMI information. Supports configu‐
       ration  of  usernames,  passwords,  networking  information,  security,
       Serial-over-LAN (SOL), and other core fields.


       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.


       A  tool to manage/monitor a chassis, such as chassis power, identifica‐
       tion (i.e. LED control), and status.


       A tool to read field replaceable unit (FRU) information from a  mother‐


       A  tool	to  read  and  manage IPMI System Event Log (SEL) records. SEL
       records store system event information and may be useful for  debugging


       A  tool	to  read IPMI sensor readings and sensor data repository (SDR)


       A tool for remote power control.


       A tool for Serial-over-Lan (SOL) console access.


       A tool that provides hex input/output of IPMI commands.


       A tool that can probe for information  about  the  location  of	a  BMC
       device, such as device addresses.


       A tool to configure IPMI chassis information. Supports configuration of
       boot device, power restore policy, and other chassis related fields.


       A tool to configure Platform Event Filtering (PEF) information.


       A tool to parse and interpret Platform Event Traps (PET).


       A tool to configure IPMI	 sensors.  Supports  configuration  of	sensor
       thresholds, sensor events, and other sensor related fields.


       A  tool	to  perform  Data  Center  Manageability Interface (DCMI) IPMI
       extension commands. Supports extensions for asset management and	 power
       usage management.


       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.


       An IPMI ping tool for debugging.


       A RMCP ping tool for debugging.


       An IPMI tool for OEM specific commands.


       A tool and daemon for IPMI node detection.


       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.

Project Libraries
       The following libraries are distributed and supported by FreeIPMI.


       A  C  library  that includes KCS, SSIF, 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.


       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.


       A library for sensor monitoring that abstracts away most IPMI details.


       A library for IPMI node detection.

       Report bugs to <> or <>.

       Copyright © 2003-2012 FreeIPMI Core Team.

       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.

       libfreeipmi(3),	libipmiconsole(3),  libipmidetect(3),  libipmimonitor‐
       ing(3), freeipmi.conf(5),  bmc-config(8),  bmc-device(8),  bmc-info(8),
       bmc-watchdog(8),	 ipmi-chassis(8),  ipmi-fru(8),	 ipmi-locate(8), ipmi-
       oem(8),	ipmi-pef-config(8),  ipmi-pet(8),  ipmi-raw(8),	  ipmi-sel(8),
       ipmi-sensors(8), ipmi-sensors-config(8), ipmiconsole(8), ipmidetect(8),
       ipmiping(8), ipmipower(8), rmcpping(8)

FreeIPMI 1.2.9			  2014-05-01			   FREEIPMI(7)

List of man pages available for Oracle

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net