ipmi-oem 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
and/or
   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‐
sion.

   The	GNU  C Library is distributed in the hope that it will be
useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See  the
GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Pub‐
lic
   License along with the GNU C Library; if not, see
   <http://www.gnu.org/licenses/>.  */ /* This header is separate
from features.h so that the compiler can
   include  it	implicitly at the start of every compilation.  It
must
   not itself include <features.h> or any other header	that  in‐
cludes
   <features.h>	 because  the  implicit	 include comes before any
feature
   test macros that may be defined in a	 source	 file  before  it
first
   explicitly  includes	 a  system header.  GCC knows the name of
this
   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) /
IPMI-OEM(8)			System Commands			   IPMI-OEM(8)

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

NAME
       ipmi-oem - IPMI OEM utility

SYNOPSIS
       ipmi-oem [OPTION...] <OEMID> <OEMCOMMAND> [OEMOPTION...]

DESCRIPTION
       Ipmi-oem is used to execute OEM specific IPMI commands. It is  intended
       to  provide  a  better  user  interface	for OEM specific IPMI commands
       rather than using ipmi-raw(8).  Please see SUPPORTED OEM IDS  and  COM‐
       MANDS  below for a list of supported OEM specific IPMI commands. A list
       of supported OEM specific commands may  also  be	 generated  using  the
       --list  option.	 There	are  no guarantees that the below OEM commands
       will work on any particular motherboard. OEM extensions may or may  not
       exist  on  particular  hardware	revisions and/or firmware revisions of
       motherboards. The extensions may or may not function for other lines of
       motherboards from the same manufacturer.

       Listed  below  are general IPMI options, tool specific options, trouble
       shooting	 information,  workaround  information,	 examples,  and	 known
       issues. For a general introduction to FreeIPMI please see freeipmi(7).

GENERAL OPTIONS
       The following options are general options for configuring IPMI communi‐
       cation and executing general tool commands.

       -D IPMIDRIVER, --driver-type=IPMIDRIVER
	      Specify the driver type to use instead of doing an  auto	selec‐
	      tion.   The  currently  available	 outofband drivers are LAN and
	      LAN_2_0, which perform IPMI 1.5 and IPMI 2.0  respectively.  The
	      currently	 available inband drivers are KCS, SSIF, OPENIPMI, and
	      SUNBMC.

       --disable-auto-probe
	      Do not probe in-band IPMI devices for default settings.

       --driver-address=DRIVER-ADDRESS
	      Specify the in-band driver address to be	used  instead  of  the
	      probed  value. DRIVER-ADDRESS should be prefixed with "0x" for a
	      hex value and '0' for an octal value.

       --driver-device=DEVICE
	      Specify the in-band driver device path to be used instead of the
	      probed path.

       --register-spacing=REGISTER-SPACING
	      Specify  the  in-band  driver  register  spacing	instead of the
	      probed value. Argument is in bytes (i.e. 32bit register  spacing
	      = 4)

       --target-channel-number=CHANNEL-NUMBER
	      Specify  the  in-band  driver target channel number to send IPMI
	      requests to.

       --target-slave-address=SLAVE-ADDRESS
	      Specify the in-band driver target	 slave	number	to  send  IPMI
	      requests to.

       -h      IPMIHOST1,IPMIHOST2,...,	     --hostname=IPMIHOST1[:PORT],IPMI‐
       HOST2[:PORT],...
	      Specify the remote host(s) to communicate with.  Multiple	 host‐
	      names  may  be separated by comma or may be specified in a range
	      format; see HOSTRANGED SUPPORT below. An optional	 port  can  be
	      specified with each host, which may be useful in port forwarding
	      or similar situations.

       -u USERNAME, --username=USERNAME
	      Specify the username to use when authenticating with the	remote
	      host.   If  not  specified,  a null (i.e. anonymous) username is
	      assumed. The required user privilege will depend on the oem com‐
	      mands executed.

       -p PASSWORD, --password=PASSWORD
	      Specify the password to use when authenticationg with the remote
	      host.  If not specified, a null  password	 is  assumed.  Maximum
	      password length is 16 for IPMI 1.5 and 20 for IPMI 2.0.

       -P, --password-prompt
	      Prompt  for  password  to	 avoid	possibility  of	 listing it in
	      process lists.

       -k K_G, --k-g=K_G
	      Specify the K_g BMC key to  use  when  authenticating  with  the
	      remote  host  for	 IPMI  2.0.  If	 not  specified, a null key is
	      assumed. To input the key in hexadecimal form, prefix the string
	      with  '0x'.  E.g.,  the key 'abc' can be entered with the either
	      the string 'abc' or the string '0x616263'

       -K, --k-g-prompt
	      Prompt for k-g to avoid possibility of  listing  it  in  process
	      lists.

       --session-timeout=MILLISECONDS
	      Specify  the  session timeout in milliseconds. Defaults to 20000
	      milliseconds (20 seconds) if not specified.

       --retransmission-timeout=MILLISECONDS
	      Specify  the  packet  retransmission  timeout  in	 milliseconds.
	      Defaults	to  1000 milliseconds (1 second) if not specified. The
	      retransmission timeout cannot be larger than the	session	 time‐
	      out.

       -a AUTHENTICATION-TYPE, --authentication-type=AUTHENTICATION-TYPE
	      Specify  the  IPMI 1.5 authentication type to use. The currently
	      available authentication types are NONE,	STRAIGHT_PASSWORD_KEY,
	      MD2, and MD5. Defaults to MD5 if not specified.

       -I CIPHER-SUITE-ID, --cipher-suite-id=CIPHER-SUITE-ID
	      Specify the IPMI 2.0 cipher suite ID to use. The Cipher Suite ID
	      identifies a set of authentication, integrity, and confidential‐
	      ity  algorithms to use for IPMI 2.0 communication. The authenti‐
	      cation algorithm identifies the algorithm	 to  use  for  session
	      setup,  the  integrity algorithm identifies the algorithm to use
	      for session packet signatures, and the confidentiality algorithm
	      identifies the algorithm to use for payload encryption. Defaults
	      to cipher suite ID 3 if  not  specified.	The  following	cipher
	      suite ids are currently supported:

	      0 - Authentication Algorithm = None; Integrity Algorithm = None;
	      Confidentiality Algorithm = None

	      1 - Authentication Algorithm = HMAC-SHA1; Integrity Algorithm  =
	      None; Confidentiality Algorithm = None

	      2	 - Authentication Algorithm = HMAC-SHA1; Integrity Algorithm =
	      HMAC-SHA1-96; Confidentiality Algorithm = None

	      3 - Authentication Algorithm = HMAC-SHA1; Integrity Algorithm  =
	      HMAC-SHA1-96; Confidentiality Algorithm = AES-CBC-128

	      6	 -  Authentication Algorithm = HMAC-MD5; Integrity Algorithm =
	      None; Confidentiality Algorithm = None

	      7 - Authentication Algorithm = HMAC-MD5; Integrity  Algorithm  =
	      HMAC-MD5-128; Confidentiality Algorithm = None

	      8	 -  Authentication Algorithm = HMAC-MD5; Integrity Algorithm =
	      HMAC-MD5-128; Confidentiality Algorithm = AES-CBC-128

	      11 - Authentication Algorithm = HMAC-MD5; Integrity Algorithm  =
	      MD5-128; Confidentiality Algorithm = None

	      12  - Authentication Algorithm = HMAC-MD5; Integrity Algorithm =
	      MD5-128; Confidentiality Algorithm = AES-CBC-128

	      15 - Authentication Algorithm = HMAC-SHA256; Integrity Algorithm
	      = None; Confidentiality Algorithm = None

	      16 - Authentication Algorithm = HMAC-SHA256; Integrity Algorithm
	      = HMAC_SHA256_128; Confidentiality Algorithm = None

	      17 - Authentication Algorithm = HMAC-SHA256; Integrity Algorithm
	      = HMAC_SHA256_128; Confidentiality Algorithm = AES-CBC-128

       -l PRIVILEGE-LEVEL, --privilege-level=PRIVILEGE-LEVEL
	      Specify  the privilege level to be used. The currently available
	      privilege levels are USER,  OPERATOR,  and  ADMIN.  Defaults  to
	      ADMIN if not specified.

       --config-file=FILE
	      Specify an alternate configuration file.

       -W WORKAROUNDS, --workaround-flags=WORKAROUNDS
	      Specify  workarounds to vendor compliance issues. Multiple work‐
	      arounds can be specified separated by commas. A special  command
	      line flag of "none", will indicate no workarounds (may be useful
	      for overriding configured defaults). See WORKAROUNDS below for a
	      list of available workarounds.

       --debug
	      Turn on debugging.

       -?, --help
	      Output a help list and exit.

       --usage
	      Output a usage message and exit.

       -V, --version
	      Output the program version and exit.

SDR CACHE OPTIONS
       This tool requires access to the sensor data repository (SDR) cache for
       general operation. By default, SDR data will be downloaded  and	cached
       on the local machine. The following options apply to the SDR cache.

       -f, --flush-cache
	      Flush  a	cached	version	 of  the  sensor data repository (SDR)
	      cache. The SDR is typically cached for faster subsequent access.
	      However,	it  may need to be flushed and re-generated if the SDR
	      has been updated on a system.

       -Q, --quiet-cache
	      Do not output information about cache creation/deletion. May  be
	      useful in scripting.

       --sdr-cache-recreate
	      If the SDR cache is out of date or invalid, automatically recre‐
	      ate the sensor data repository (SDR) cache. This option  may  be
	      useful for scripting purposes.

       --sdr-cache-file=FILE
	      Specify a specific sensor data repository (SDR) cache file to be
	      stored or read from. If this option is used when multiple	 hosts
	      are  specified,  the  same  SDR  cache file will be used for all
	      hosts.

       --sdr-cache-directory=DIRECTORY
	      Specify an alternate directory for sensor data repository	 (SDR)
	      caches to be stored or read from. Defaults to the home directory
	      if not specified.

HOSTRANGED OPTIONS
       The following options manipulate hostranged output. See HOSTRANGED SUP‐
       PORT below for additional information on hostranges.

       -B, --buffer-output
	      Buffer  hostranged output. For each node, buffer standard output
	      until the node has completed its IPMI operation. When specifying
	      this  option, data may appear to output slower to the user since
	      the the entire IPMI operation must complete before any data  can
	      be output.  See HOSTRANGED SUPPORT below for additional informa‐
	      tion.

       -C, --consolidate-output
	      Consolidate hostranged output. The complete standard output from
	      every  node  specified  will  be consolidated so that nodes with
	      identical output are not output twice. A header will list	 those
	      nodes  with  the consolidated output. When this option is speci‐
	      fied, no output can be seen until the  IPMI  operations  to  all
	      nodes  has  completed.  If  the  user  breaks out of the program
	      early, all currently consolidated output	will  be  dumped.  See
	      HOSTRANGED SUPPORT below for additional information.

       -F NUM, --fanout=NUM
	      Specify  multiple	 host  fanout.	A "sliding window" (or fanout)
	      algorithm is used for parallel IPMI communication so that slower
	      nodes or timed out nodes will not impede parallel communication.
	      The maximum number of threads available at the same time is lim‐
	      ited by the fanout. The default is 64.

       -E, --eliminate
	      Eliminate	 hosts	determined  as undetected by ipmidetect.  This
	      attempts to remove the common issue of hostranged execution tim‐
	      ing  out	due  to	 several nodes being removed from service in a
	      large cluster. The ipmidetectd daemon must  be  running  on  the
	      node executing the command.

       --always-prefix
	      Always prefix output, even if only one host is specified or com‐
	      municating in-band. This option is primarily useful for  script‐
	      ing  purposes.  Option  will be ignored if specified with the -C
	      option.

IPMI-OEM OPTIONS
       The following options are specific to Ipmi-oem.

       -L, --list
	      List supported OEM IDs and Commands.

       -v, --verbose
	      Output verbose information. Additional  output  will  depend  on
	      specific OEM ID and OEM COMMANDS specified.

SUPPORTED OEM IDS and COMMANDS
       The currently supported OEM IDs and COMMANDs are listed below. The spe‐
       cial OEM ID of list may be passed into the list all supported  OEM  IDs
       and  Commands. The special OEM command list may be passed to any OEM ID
       to list commands supported by that OEM ID.

       Dell

	      get-system-info KEY
		     This OEM command  can  retrieve  the  motherboard	system
		     information.    Valid  keys  are  guid,  asset-tag,  ser‐
		     vice-tag,	  chassis-service-tag,	  chassis-related-ser‐
		     vice-tag,	     board-revision,	  platform-model-name,
		     blade-slot-info,	    system-revision,	   idrac-info,
		     idrac-ipv4-url,   idrac-gui-webserver-control,  cmc-info,
		     cmc-ipv4-url, cmc-ipv6-info, cmc-ipv6-url, mac-addresses.
		     Command  confirmed	 to work on Dell Poweredge 2900, 2950,
		     R610, R710, R720, M600, M610, M610X, M910, and R905. How‐
		     ever,  individual	system	information options may not be
		     readable or available on every system.

	      get-nic-selection
		     This OEM command will determine the current NIC selection
		     for  IPMI	as  dedicated,	shared,	 shared w/ failover to
		     NIC2, or shared w/ failover to all.  Dedicated  indicates
		     IPMI is only available on an expansion card, shared indi‐
		     cates IPMI is available on NIC1, shared  w/  failover  to
		     NIC2  indicates  IPMI is available on NIC1 w/ failover to
		     NIC2 on NIC1's failure, and shared	 w/  failover  to  all
		     indicates	IPMI  is  available on NIC1 w/ failover to all
		     other NICs in the event of NIC failure. Command confirmed
		     to	 work  on  Dell	 Poweredge 2900, 2950, R610, R710, and
		     R905.

	      set-nic-section						 dedi‐
	      cated|shared|shared_failover_nic2|shared_failover_all
		     This  OEM	command	 will set the current NIC selection to
		     dedicated,	    shared,	 shared_failover_nic2,	    or
		     shared_failover_all.  (See	 get-nic-selection  above  for
		     description  on  inputs.)	On  older  Poweredge  systems,
		     shared_failover_nic2  may	have  been  documented as just
		     failover. Command confirmed to  work  on  Dell  Poweredge
		     2900, 2950, R610, R710, and R905.

	      get-nic-selection-failover
		     This OEM command will determine the current NIC selection
		     for IPMI and the failover NIC. Command confirmed to  work
		     on Dell Poweredge R720 (Dell 12G Poweredge systems).

	      set-nic-section-failover		 dedicated|lom1|lom2|lom3|lom4
	      none|lom1|lom2|lom3|lom4|all
		     This OEM command will set the current NIC	selection  for
		     IPMI and the failover NIC. The first option sets the IPMI
		     NIC and the second option the failover NIC. Command  con‐
		     firmed to work on Dell Poweredge R720 (Dell 12G Poweredge
		     systems).

	      get-active-lom-status [v1|v2]
		     This OEM command will get the current NIC being used  for
		     out  of  band management and possibly additional informa‐
		     tion. Users may specify if version 1 or version 2 of this
		     extension should be executed. If no version is specified,
		     version 1 is exectued. Version 1  of  this	 command  con‐
		     firmed  to work on Dell Poweredge R610 and R710 (Dell 11G
		     Poweredge systems). Version 2 of this  command  confirmed
		     to	 work  on Dell Poweredge R720 (Dell 12G Poweredge sys‐
		     tems).

	      get-ssh-config
		     This OEM command will get the current  SSH	 configuration
		     on	 the IPMI card. Command confirmed to work on Dell Pow‐
		     eredge R610 and R710 (Dell 11G Poweredge systems).

	      set-ssh-config KEY=VALUE ...
		     This OEM command will set the current  SSH	 configuration
		     on	 the  IPMI  card.  The	possible  keys	and values are
		     ssh=enable|disable,  idletimeout=seconds,	and   portnum‐
		     ber=num. Multiple key=value pairs may be specified. If no
		     key=value pairs are specifed, available pairs are output.
		     Some  fields  may be read-only on specific Poweredge sys‐
		     tems. Command confirmed to work on	 Dell  Poweredge  R610
		     and R710 (Dell 11G Poweredge systems).

	      get-telnet-config
		     This  OEM	command will get the current telnet configura‐
		     tion on the IPMI card. Command confirmed to work on  Dell
		     Poweredge R610 and R710 (Dell 11G Poweredge systems).

	      set-telnet-config KEY=VALUE ...
		     This  OEM	command will set the current Telnet configura‐
		     tion on the IPMI card. The possible keys and  values  are
		     telnet=enable|disable,  sessiontimeout=seconds,  portnum‐
		     ber=num,  and  7fls=enable|disable.  Multiple   key=value
		     pairs  may	 be  specified.	  If  no  key=value  pairs are
		     specifed, available pairs are output. Some fields may  be
		     read-only	on  specific  Poweredge	 systems. Command con‐
		     firmed to work on Dell Poweredge R610 and R710 (Dell  11G
		     Poweredge systems).

	      get-web-server-config
		     This OEM command will get the current web server configu‐
		     ration on the IPMI card. Command  confirmed  to  work  on
		     Dell  Poweredge  R610  and	 R710 (Dell 11G Poweredge sys‐
		     tems).

	      set-web-server-config KEY=VALUE ...
		     This OEM command will set the current Web Server configu‐
		     ration on the IPMI card. The possible keys and values are
		     webserver=enable|disable,	sessiontimeout=seconds,	 http‐
		     portnumber=num,	and    httpsportnumber=num.   Multiple
		     key=value pairs may be specified. If no  key=value	 pairs
		     are specifed, available pairs are output. Some fields may
		     be read-only on specific Poweredge systems. Command  con‐
		     firmed  to work on Dell Poweredge R610 and R710 (Dell 11G
		     Poweredge systems).

	      get-active-directory-config
		     This OEM command will get the  current  active  directory
		     configuration on the IPMI card. Command confirmed to work
		     on Dell Poweredge R610 and R710 (Dell 11G Poweredge  sys‐
		     tems).

	      set-active-directory-config
		     This OEM command will set the current Web Server configu‐
		     ration on the IPMI card. The possible keys and values are
		     activedirectory=enable|disable,	      timeout=seconds,
		     type=extended|standard, sso=enable|disable, and  certifi‐
		     catevalidation=enable|disable.  If no key=value pairs are
		     specifed, available pairs are output. Some fields may  be
		     read-only	on  specific  Poweredge	 systems. Command con‐
		     firmed to work on Dell Poweredge R610 and R710 (Dell  11G
		     Poweredge systems).

	      reset-to-defaults
		     This OEM command will reset the BMC configuration back to
		     default values. The command will spin until the reset  is
		     confirmed	to  be	complete. Command confirmed to work on
		     Dell Poweredge R610 and R710  (Dell  11G  Poweredge  sys‐
		     tems).

	      get-power-consumption-data
		     This  OEM	command	 can  retrieve power consumption data.
		     Command confirmed to work on Dell Poweredge  R610,	 R710,
		     R905, M610, M610x, and M910.

	      reset-power-consumption-data cumulative|peak
		     This  OEM	command can reset the cumulative or peak power
		     consumption data (viewed via get-power-consumption-data).
		     Command  confirmed	 to work on Dell Poweredge R610, R710,
		     R905, M610, M610x, and M910.

	      power-supply-info
		     This OEM command can read and output power supply ratings
		     and  other	 information. This OEM command requires access
		     to the SDR. Command confirmed to work on  Dell  Poweredge
		     R610, R710, and M610.

	      get-instantaneous-power-consumption-data power_supply_instance
		     This OEM command can read instantaneous power consumption
		     data. If a power supply  instance	number	is  specified,
		     only  data for that instance will be gathered. Otherwise,
		     collective power consumption will	be  gathered.  Command
		     confirmed	to  work  on  Dell Poweredge R610, R710, M610,
		     M610x, and M910.

	      get-power-head-room
		     This OEM command can read power head room.	 Command  con‐
		     firmed  to work on Dell Poweredge R610 and R710 (Dell 11G
		     Poweredge systems).

	      get-power-consumption-statistics average|max|min
		     This OEM command can read average, max, or min power con‐
		     sumption  history. Command confirmed to work on Dell Pow‐
		     eredge R610, R710, M610, M610x, and M910.

	      get-power-capacity
		     This OEM command can read	the  current  power  capacity.
		     Command  confirmed	 to work on Dell Poweredge R610, R710,
		     M610, M610x, and M910.

	      set-power-capacity power-capacity
		     This OEM command can write	 the  current  power  capacity
		     (specified	 in  Watts). Command confirmed to work on Dell
		     Poweredge R610 and R710 (Dell 11G Poweredge systems).

	      get-power-capacity-status
		     This OEM command  can  determine  if  the	current	 power
		     capacity  is  enabled  or	disabled. Command confirmed to
		     work on Dell Poweredge R610, R710, M610, M610x, and M910.

	      set-power-capacity-status enable|disable
		     This OEM command can configure the current power capacity
		     to	 be  enabled or disabled. Command confirmed to work on
		     Dell Poweredge R610 and R710  (Dell  11G  Poweredge  sys‐
		     tems).

	      get-chassis-identify-status
		     This  OEM command will retrieve the current chassis iden‐
		     tify (i.e. LED) status. Command confirmed to work on Dell
		     Poweredge	2900,  2950,  R610,  R710,  R905,  M600, M610,
		     M610x, and M910.

	      power-monitoring-over-interval	     interval	       system‐
	      power|cpu1|cpu2|cpu3|cpu4|memory1|memory2|memory3|mem‐
	      ory4|drives|fans|pciecards|gpucables
		     This OEM command will retrieve power consumption informa‐
		     tion  from a specified subsystem for a specified interval
		     time. If the interval is between 30 and 900s,  the	 aver‐
		     age,  minimum,  and  maximum  power  value	 can  also  be
		     retrieved. If the interval is between 5 and  30  seconds,
		     only  the	average power consumption can be returned. See
		     power-monitoring-interval-range below to determine	 legal
		     intervals	for  each subsystem. Command confirmed to work
		     on Dell Poweredge R720 (Dell 12G Poweredge systems).

	      power-monitoring-interval-range			       system‐
	      power|cpu1|cpu2|cpu3|cpu4|memory1|memory2|memory3|mem‐
	      ory4|drives|fans|pciecards|gpucables
		     This OEM command will retrieve the	 monitoring  intervals
		     for  a  specified subsystem. Command confirmed to work on
		     Dell Poweredge R720 (Dell 12G Poweredge systems).

	      get-last-post-code
		     This OEM command will retrieve the	 last  POST  code  and
		     error  string  for	 it. Command confirmed to work on Dell
		     Poweredge R720.

	      slot-power-toggle slot-number
		     This OEM command will perform a power toggle  on  a  PCIe
		     slot.  The	 PCIe slot number can range from 1 to 16. Com‐
		     mand confirmed to work on Dell Poweredge C410x.

	      slot-power-control platform-model on|off|status slot-number
		     This OEM command will perform a power control action on a
		     PCIe  slot.  This OEM extension is tied very closely to a
		     platform, so a supported platform must be specified.  The
		     currently supported platform-model options are C410x. The
		     on action powers on a slot, off powers off	 a  slot,  and
		     status  returns if the current power is on or off. If the
		     current power status is on, an on	action	does  nothing.
		     Similarly,	 if  the  current  power status is off, an off
		     action does nothing. The on, off, and status  slot	 power
		     actions  are not native and are emulated through a combi‐
		     nation of a power toggle (using slot-power-toggle	above)
		     and  the reading of PCIe slot watt sensors. The PCIe slot
		     number can range from 1 to 16. Command confirmed to  work
		     on Dell Poweredge C410x.

	      get-port-map
		     This  OEM command will retrieve the current iPASS mapping
		     to PCIe controllers/slots. Command confirmed to  work  on
		     Dell Poweredge C410x.

	      set-port-map jumper|bmc ipass-mapping 1:2|1:4|1:8
		     This  OEM	command will set an iPass mapping to PCIe con‐
		     trollers/slots.  jumper or bmc must be specified to indi‐
		     cate  if iPass mappings will be controlled via jumpers on
		     the system or via a BMC/IPMI. In order  for  reconfigura‐
		     tion  to  be done via ipmi-oem, the user must select bmc.
		     The ipass-mapping determines which iPass  ports  will  be
		     mapped.   1:2,  1:4,  and	1:8 determine the mapping that
		     should be set. See details below for specific  platforms.
		     Command  confirmed	 to work on Dell Poweredge C410x.  For
		     the Dell Poweredge C410x, the ipass-mapping ranges from 1
		     to 4. 1 refers to iPass 1 and 5, 2 to 2 and 6, 3 to 3 and
		     7, and 4 to 4 and 8. For the platform C410x,  PCIe	 slots
		     1,	 2,  3, 4, 13, 14, 15, and 16 are attached to iPass 1,
		     2, 3, and 4. PCIe slots 5, 6, 7, 8, 9, 10, 11, and 12 are
		     attached  to iPass 5, 6, 7, and 8. For example, if 1:2 is
		     set on mapping-number 1, PCIe slots  1  and  15  will  be
		     assigned  to  iPass 1 and slots 2 and 16 will be assigned
		     to iPass 5. if 1:4 is chosen, PCIe slots 1, 2, 15, and 16
		     will be assigned to iPass 1 and iPass 5 will not be used.

       Fujitsu

	      get-power-on-source
		     This  OEM	command	 will  return  the reason for the most
		     recent Power On.  Command confirmed to  work  on  Fujitsu
		     RX100 S5.

	      get-power-off-source
		     This  OEM	command	 will  return  the reason for the most
		     recent Power Off.	Command confirmed to work  on  Fujitsu
		     RX100 S5.

	      get-remote-storage-status connection_number
		     This OEM command will return the connection and/or status
		     of remote storage. connection_number currently supports a
		     range of 0-1.  Command confirmed to work on Fujitsu RX100
		     S5.

	      get-system-status
		     This OEM command will return the current  system  status.
		     Command confirmed to work on Fujitsu RX100 S5.

	      get-eeprom-version-info eeprom_number
		     This OEM command will return the current version info for
		     various hardware elements, including firmware,  SDR,  and
		     boot  revision.  eeprom_number currently supports a range
		     of 0-1. Command confirmed to work on Fujitsu RX100 S5.

	      get-identify-led
		     This OEM command will get the current identify  LED  sta‐
		     tus. Command confirmed to work on Fujitsu RX100 S5.

	      set-identify-led on|off
		     This  OEM	command will set the current identify LED sta‐
		     tus. Command confirmed to work on Fujitsu RX100 S5.

	      get-error-led
		     This OEM command will get the current error  LED  status.
		     Command confirmed to work on Fujitsu RX100 S5.

	      get-sel-entry-long-text sel_record_id
		     This  OEM	command	 will  retrieve	 the  Fujitsu specific
		     string interpretation of a SEL record. This  command  may
		     be useful for interpreting Fujitsu OEM hex codes found in
		     the SEL. A specific SEL  record  ID  must	be  specified.
		     Please  see ipmi-sel(8), for retrieving SEL records. Com‐
		     mand confirmed to work on Fujitsu RX100 S5.

       IBM

	      get-led
		     This OEM command will get the current  LED	 status.  This
		     OEM command requires access to the SDR. Command confirmed
		     to work on IBM x3755.

       Intel

	      get-smtp-config [channel-number]
		     This OEM command will get the current SMTP	 configuration
		     on the IPMI card. By default, configuration for every LAN
		     channel will be output.  If a  channel-number  is	speci‐
		     fied,  only  that specific channel number's configuration
		     will be output.   Command	confirmed  to  work  on	 Intel
		     S5500WB  (Penguin Computing Relion 700) and Intel S2600JF
		     (Appro 512X).

	      set-smtp-config [channel-number] KEY=VALUE ...
		     This OEM command will set the current SMTP	 configuration
		     on	 the IPMI card. By default, configuration will be done
		     for all LAN channels.  If a channel-number is  specified,
		     only that specific channel number's configuration will be
		     configured.    The	  possible   keys   and	  values   are
		     smtp=enable|disable,   smtpserveraddress=ipaddress,  smt‐
		     pusername=string,	    userpassword=string,      emailad‐
		     dress=string,    subject=string,	messagecontent=string,
		     senderemailaddress=string, and smtphostname=string.  Mul‐
		     tiple  key=value  pairs may be specified. If no key=value
		     pairs are specifed, available pairs are  output.  Command
		     confirmed	to  work  on  Intel S5500WB (Penguin Computing
		     Relion 700) and Intel S2600JF (Appro 512X).

	      get-power-restore-delay
		     This OEM command will retrieve the power  on  delay.  The
		     power  on	delay  is a delay that occurs whenever the BMC
		     turns on the system according to the Power Restore Policy
		     setting.  It  does	 not take effect otherwise (i.e. power
		     button or Chassis Control). Command confirmed to work  on
		     Intel S2600JF (Appro 512X).

	      set-power-restore-delay seconds
		     This  OEM	command	 will  set  the	 power	on delay. (See
		     get-power-restore-delay above for	description  on	 power
		     restore  delay).  Command	confirmed  to  work  on	 Intel
		     S2600JF (Appro 512X).

	      restore-configuration
		     This OEM command will restore  BMC	 configuration	values
		     back  to  default values. The command will spin until the
		     restore is confirmed to be complete.  Command  configured
		     to	 work  on Intel S5500WB (Penguin Computing Relion 700)
		     and Intel S2600JF (Appro 512X). After running  this  com‐
		     mand,  the	 BMC must be reset to return it to functioning
		     status. This may be accomplished  by  executing  a	 cold-
		     reset with bmc-device(8).

       IntelNM (Intel Node Manager)

       The  following OEM commands operate on Intel chipsets with Node Manager
       support. They all require access to the SDR. They may work on  multiple
       vendors motherboards.

	      get-node-manager-statistics [domainid=num] [policyid=num]
		     This  OEM command will output the Intel Node Manager sta‐
		     tistics. The user may optionally specify  a  domainid  or
		     policyid.	The  default  domainid	is 0. If a policyid is
		     specified, per policy statistics will be  output,	other‐
		     wise  global statistics will be output. Command confirmed
		     to work on Intel S5500WB (Penguin Computing Relion	 700),
		     Inventec  5441/5442  (Dell	 Xanadu	 II/III),  Quanta S99Q
		     (Dell FS12-TY), Quanta QSSC-S4R (Appro GB812X-CN), Super‐
		     micro X9DRi-F, Intel S2600JF (Appro 512X).

	      reset-node-manager-statistics [domainid=num] [policyid=num]
		     This  OEM	command will reset the Intel Node Manager sta‐
		     tistics. The user may optionally specify  a  domainid  or
		     policyid.	The  default  domainid	is 0. If a policyid is
		     specified, per policy statistics will be reset, otherwise
		     global  statistics	 will  be  reset. Command confirmed to
		     work on Intel S5500WB  (Penguin  Computing	 Relion	 700),
		     Inventec  5441/5442  (Dell	 Xanadu	 II/III),  Quanta S99Q
		     (Dell FS12-TY), Quanta QSSC-S4R (Appro GB812X-CN), Super‐
		     micro X9DRi-F, Intel S2600JF (Appro 512X).

	      get-node-manager-capabilities	[domainid=num]	  [policytrig‐
	      ger=none|inlet] [policytype=powercontrol]
		     This OEM command will output the current capabilities  of
		     the Intel Node manager. The user may optionally specify a
		     domainid,	policytrigger,	or  policytype.	 The   default
		     domainid is 0. If any particular option is not specified,
		     all permutations of the remaining options will be used in
		     an attempt to output all capabilities of the system. Com‐
		     mand confirmed to work on Intel S2600JF (Appro 512X).

	      node-manager-policy-control   <enable|disable>	[domainid=num]
	      [policyid=num]
		     This  OEM	command	 will  enable  or  disable the current
		     global, domain, or policies used by the Intel  Node  Man‐
		     ager.  If no domainid is specified, then the Node Manager
		     will be enabled or globally disabled.  If a  domainid  is
		     specified,	 only that domain will be enabled or disabled.
		     If both a domainid and policyid are specified, only  that
		     specific policy within the domain will be specified. This
		     OEM command will be required to enable or	disable	 poli‐
		     cies  before  many	 of the commands below can be used for
		     configuration or use. Command confirmed to work on	 Intel
		     S2600JF (Appro 512X).

	      get-node-manager-policy [domainid=num] [policyid=num]
		     This  OEM	command will get the current node manager pol‐
		     icy. If no domainid is specified, all  policies  for  all
		     domain IDs and policy Ids will be attempted to be output.
		     If a domainid is specified but a  policyid	 is  not,  all
		     policies  within a domain will be attempted to be output.
		     If the verbose option is set, additional  error  messages
		     will  be output as valid policies are being searched for.
		     Command confirmed to work on Intel S2600JF (Appro 512X).

	      set-node-manager-policy  domainid=num  policyid=num  policytrig‐
	      ger=none|inlet   powerlimit=watts	 correctiontimelimit=ms	 poli‐
	      cytriggerlimit=num  statisticsreportingperiod=seconds  [policys‐
	      tate=enable|disable] [policyexceptionaction=alert|shutdown]
		     This  OEM	command will add or modify an indicated policy
		     ID from the domain ID.  Most  of  the  fields  above  are
		     required,	although  they	can be listed in any order. By
		     default any created/modified policy will be enabled, how‐
		     ever this can be overridden by policystate.  policyexcep‐
		     tionaction may be specified multiple times	 to  configure
		     multiple  actions	or  can	 be  skipped  to  configure no
		     actions.  When the policytrigger is configured  as	 none,
		     the  trigger  that	 will lead to exception actions is the
		     value specified by the powerlimit. When the policytrigger
		     is	 inlet, the tigger that will lead to exception actions
		     is the value specified by policytriggerlimit.  The	 units
		     of	 the policytriggerlimit will depend on the policytrig‐
		     ger selected.  Most  notably,  if	the  policytrigger  is
		     inlet,  which  refers  to inlet temperature, the units of
		     policytriggerlimit will be in  Celsius.  When  the	 poli‐
		     cytrigger	is  none,  the	policytriggerlimit  is ignored
		     internally by the Intel Node Manager, but	a  value  must
		     still be specified for configuration. Typically configur‐
		     ing it to 0 is more than sufficient. The  correctiontime‐
		     limit  specifies the time the Node Manager must take cor‐
		     rective actions to bring back the	system	within	limits
		     before taking the actions specified in policyexceptionac‐
		     tion. statisticsreportingperiod is the number of  seconds
		     that  measured  power  will  be  averaged	for reporting.
		     Please see get-node-manager-policy	 to  determine	proper
		     ranges  for  powerlimit, correctiontimelimit, policytrig‐
		     gerlimit, and  statisticsreportingperiod.	 Command  con‐
		     firmed to work on Intel S2600JF (Appro 512X).

	      remove-node-manager-policy domainid=num policyid=num
		     This OEM command will remove the indicated policy ID from
		     the  domain  ID.  Both  the  domainid  and	 policyid  are
		     required.	Command	 confirmed  to	work  on Intel S2600JF
		     (Appro 512X).

	      get-node-manager-alert-thresholds [domainid=num] [policyid=num]
		     This OEM command will get the current  alert  thresholds.
		     If	 no  domainid  is  specified, all alert thresholds for
		     domain IDs and policy Ids will be attempted to be output.
		     If	 a  domainid  is  specified but a policyid is not, all
		     alert thresholds within a domain will be attempted to  be
		     output.  The  units  of the thresholds will depend on the
		     configuration of  the  current  policy.  If  the  verbose
		     option  is	 set, additional error messages will be output
		     as valid policies are being searched  for.	 Command  con‐
		     firmed to work on Intel S2600JF (Appro 512X).

	      set-node-manager-alert-thresholds	   domainid=num	  policyid=num
	      [threshold1=num] [threshold2=num] [threshold3=num]
		     This OEM command will set	the  alert  thresholds	for  a
		     given domain ID and policy ID. Up to three thresholds can
		     be specified, The units of the thresholds will depend  on
		     the  configuration	 of  the  current policy. Command con‐
		     firmed to work on Intel S2600JF (Appro 512X).

	      get-node-manager-policy-suspend-periods  [domainid=num]	[poli‐
	      cyid=num]
		     This  OEM	command	 will  get  the current policy suspend
		     periods. Suspend periods will temporarily	disable	 Intel
		     Node Manager policies at configured times. If no domainid
		     is specified, all suspend periods for domain IDs and pol‐
		     icy Ids will be attempted to be output.  If a domainid is
		     specified but a policyid  is  not,	 all  suspend  periods
		     within  a	domain	will be attempted to be output. If the
		     verbose option is set, additional error messages will  be
		     output  as valid policies are being searched for. Suspend
		     start and stop times are output in 24 hour	 format.  Com‐
		     mand confirmed to work on Intel S2600JF (Appro 512X).

	      set-node-manager-policy-suspend-periods	 domainid=num	 poli‐
	      cyid=num suspendperiodstart1=time	 suspendperiodstop1=time  sus‐
	      pendperiodrepeat1=monday|tuesday|wednesday|thursday|friday|sat‐
	      urday|sunday ...
		     This OEM command will set the policy suspend periods  for
		     a policy.	Suspend periods will temporarily disable Intel
		     Node Manager policies at configured times. Up to  5  sus‐
		     pend  periods  can	 be  specified by suspendperiodstartX,
		     suspendperiodstopX, suspendperiodrepeatX.	suspendperiod‐
		     start  and	 suspendperiodstop  specify the start and stop
		     time since midnight for a suspend period. The time should
		     be	 specified  in	24  hour format (i.e. 02:00 or 13:40).
		     Note that suspend periods are configured in multiples  of
		     6	minutes,  therefore  the  stored  configuration may be
		     rounded to a slightly alternate configuration.   suspend‐
		     periodrepeat  indicates  the  days	 in  which the suspend
		     period shall be enabled. The option can be specified mul‐
		     tiple  times  to  configure  multiple times. Command con‐
		     firmed to work on Intel S2600JF (Appro 512X).

	      set-node-manager-power-draw-range	    domainid=num     minpower‐
	      drawrange=watts maxpowerdrawrange=watts
		     This  OEM	command	 will  set  the power draw range for a
		     given domain ID.  After this configuration, any  policies
		     within  the domain ID that are outside of this range will
		     be disabled as needed. The current power draw  range  can
		     be read via the get-node-manager-capabilities above. Com‐
		     mand confirmed to work on Intel S2600JF (Appro 512X).

	      get-node-manager-version
		     This OEM command will output the current Intel Node  Man‐
		     ager  version  information.  Command confirmed to work on
		     Intel S5500WB (Penguin Computing  Relion  700),  Inventec
		     5441/5442	 (Dell	 Xanadu	 II/III),  Quanta  S99Q	 (Dell
		     FS12-TY),	Quanta	QSSC-S4R  (Appro   GB812X-CN),	 Intel
		     S2600JF (Appro 512X).

       Inventec

	      get-nic-mode
		     This  OEM	command will determine the current NIC mode as
		     dedicated or shared. Dedicated  indicates	IPMI  is  only
		     available	on the dedicated management port. Shared indi‐
		     cates IPMI is also available on one of the primary ether‐
		     net   ports.   Command  confirmed	to  work  on  Inventec
		     5441/5442 (Dell Xanadu II/III).

	      set-nic-mode dedicated|shared
		     This OEM command will set the current NIC mode  to	 dedi‐
		     cated  or shared. (See get-nic-mode above for description
		     on dedicated vs.  shared  mode.)  This  OEM  command  may
		     internally	 reset	the  BMC,  making the BMC unusable for
		     awhile. Command confirmed to work on  Inventec  5441/5442
		     (Dell Xanadu II/III).

	      get-mac-address
		     This  command  will retrieve the BMC MAC address. This is
		     actually not an OEM command, but rather the  normal  IPMI
		     MAC  address  command  (identical	to what is used in the
		     bmc-config(8) tool). This command is placed here for con‐
		     venience.

	      set-mac-address dedicated|shared MACADDR
		     This OEM command will set the dedicated or shared BMC MAC
		     address.  (See get-nic-mode above for description on ded‐
		     icated  vs.  shared  mode.) The BMC MAC address cannot be
		     set through the normal IPMI MAC address command (what  is
		     used  in  the  bmc-config(8) tool). The MACADDR should be
		     specified in XX:XX:XX:XX:XX:XX form.  A  shared  BMC  MAC
		     address  may  conflict with normal communication ethernet
		     communication on the primary  ethernet  port.  Users  may
		     wish  to  configuration an alternate MAC address instead.
		     After configuration of the MAC address, the BMC  must  be
		     reset. This may be accomplished by executing a cold-reset
		     with bmc-device(8).  Command confirmed to work on	Inven‐
		     tec 5441/5442 (Dell Xanadu II/III).

	      get-bmc-services
		     This  OEM	command will display the currently enabled BMC
		     services.	 Command  confirmed  to	  work	 on   Inventec
		     5441/5442 (Dell Xanadu II/III).

	      set-bmc-services enable|disable all|kvm|http|ssh
		     This  OEM	command	 will enable or disable other BMC ser‐
		     vices besides IPMI. all can be specified  to  enable/dis‐
		     able all services, kvm specifies KVM and Virtual Storage,
		     http specifies HTTP and HTTPS, and ssh specifies both SSH
		     and   Telnet.  Command  confirmed	to  work  on  Inventec
		     5441/5442 (Dell Xanadu II/III).

	      get-authentication-config
		     This OEM command will display additional OEM  authentica‐
		     tion  settings.  (See set-authentication-config below for
		     description on outputs.) Command  confirmed  to  work  on
		     Inventec 5441/5442 (Dell Xanadu II/III).

	      set-authentication-config KEY=VALUE ...
		     This  OEM	command will set additional OEM authentication
		     settings on the IPMI card. The possible keys  and	values
		     are  maxauthenticationfailures=count,  lockoutwindow=sec‐
		     onds, lockouttime=seconds, and httpsportnumber=num.  max‐
		     authenticationfailures  specifies	the  maximum number of
		     allowed authentication failures. lockoutwindow  specifies
		     the  window  of time the authentication failure count can
		     be reached in to disable a	 user.	lockouttime  specifies
		     the  time period a user is disabled if the authentication
		     failure count is reached. Setting 0 to any	 of  the  set‐
		     tings  will disable the lockout feature. Each time any of
		     these settings is modified,  the  authentication  failure
		     count  of	each  enabled  user  is	 reset	to 0. Multiple
		     key=value pairs may be specified. If no  key=value	 pairs
		     are  specifed,  available	pairs are output. Command con‐
		     firmed  to	 work  on  Inventec  5441/5442	(Dell	Xanadu
		     II/III).

	      get-account-status
		     This  OEM	command will output the current account status
		     of users on the BMC. This command is particularly	usefor
		     for determinining which users in the system may have been
		     locked out via  authentication  failures  configured  via
		     set-authentication-config.	 Command  confirmed to work on
		     Inventec 5441/5442 (Dell Xanadu II/III).

	      get-dns-config
		     This OEM command will display  additional	OEM  DNS  set‐
		     tings.  (See set-dns-config below for description on out‐
		     puts.) Command confirmed to work  on  Inventec  5441/5442
		     (Dell Xanadu II/III).

	      set-dns-config KEY=VALUE ...
		     This  OEM command will set additional OEM DNS settings on
		     the IPMI card. The possible keys  and  values  are	 dnsd‐
		     hcp=enable|disable,		 dnsserver1=ipaddress,
		     dnsserver2=ipaddress, dnsregisterbmc=enable|disable, dns‐
		     bmchostname=string, dnsdomainnamedhcp=enable|disable, and
		     dnsdomainname=string. dnsdhcp specifies if the DNS server
		     IP	 addresses  should  be	assigned from the DHCP server.
		     dnsserver1 and  dnsserver2	 specify  the  IP  addess  for
		     server  1	and 2 respectively. These fields are read only
		     if dnsdhcp and DHCP are enabled. dnsregisterbmc specifies
		     if	 the  BMC  host name is registered via the DNS server.
		     dnsbmchostname specifies the BMC host name. This field is
		     read only if dnsregisterbmc is enabled. dnsdomainnamedhcp
		     specifies if the DNS domainname should be	assigned  from
		     the  DHCP	server. dnsdomainname specifies the DNS domain
		     name string. This field is read only if dnsdomainnamedhcp
		     is enabled. Multiple key=value pairs may be specified. If
		     no key=value pairs are specifed, available pairs are out‐
		     put.  Command  confirmed  to  work	 on Inventec 5441/5442
		     (Dell Xanadu II/III).

	      get-web-server-config
		     This OEM command will get the current web server configu‐
		     ration  on	 the  IPMI  card. Command confirmed to work on
		     Inventec 5441/5442 (Dell Xanadu II/III).

	      set-web-server-config KEY=VALUE ...
		     This OEM command will set the current web server configu‐
		     ration on the IPMI card. The possible keys and values are
		     webserver=enable|disable, webservertimeout=seconds, http‐
		     portnumber=num,	and    httpsportnumber=num.   Multiple
		     key=value pairs may be specified. If no  key=value	 pairs
		     are  specifed,  available	pairs are output. Command con‐
		     firmed  to	 work  on  Inventec  5441/5442	(Dell	Xanadu
		     II/III).

	      get-power-management-config
		     This  OEM	command	 will get the current power management
		     configuration on the IPMI card. Command confirmed to work
		     on Inventec 5441/5442 (Dell Xanadu II/III).

	      set-power-management-config KEY=VALUE ...
		     This  OEM	command	 will set the current power management
		     configuration on the IPMI card.  The  possible  keys  and
		     values are dpnmpowermanagement=enable|disable, powerstag‐
		     geringacrecovery=immediate|auto|user,   powerondelay=sec‐
		     onds,  and	 maxpowerondelay=seconds.  dpnmpowermanagement
		     enables or diables DPNM, Dynamic Power  Node  Management.
		     For  powerstaggeringacrecovery,  immediate	 specifies  no
		     delay, auto generates a delay time	 between  the  minimum
		     and  maximum  configured,	and user uses the user defined
		     time defined by powerondelay. powerondelay must be within
		     the  minimum  and	maximum power on delay times. Multiple
		     key=value pairs may be specified. If no  key=value	 pairs
		     are  specifed,  available	pairs are output. Command con‐
		     firmed  to	 work  on  Inventec  5441/5442	(Dell	Xanadu
		     II/III).

	      get-sol-idle-timeout
		     This  OEM	command will get the SOL idle timeout. Command
		     confirmed to work	on  Inventec  5441/5442	 (Dell	Xanadu
		     II/III).

	      set-sol-idle-timeout idle-timeout
		     This  OEM	command	 will  set  the	 SOL idle timeout. The
		     idle-timeout is one-based, max  of	 65535,	 in  1	minute
		     increments	 (e.g. 1 = 1 minute), 0 or "none" will config‐
		     ure no timeout. Command confirmed	to  work  on  Inventec
		     5441/5442 (Dell Xanadu II/III).

	      get-telnet-ssh-redirect-status
		     This OEM command will get the telnet/SSH redirect status.
		     Command confirmed to work on Inventec 5442	 (Dell	Xanadu
		     III).

	      set-telnet-ssh-redirect-status enable|disable
		     This  OEM command will enable or disable telnet/SSH redi‐
		     rect status.  Command confirmed to work on Inventec  5442
		     (Dell Xanadu III).

	      get-board-id
		     This  OEM command can get the board ID. Command confirmed
		     to work on Inventec 5441/5442 (Dell Xanadu II/III).

	      set-board-id ID
		     This OEM command can set the board ID. Command  confirmed
		     to work on Inventec 5441/5442 (Dell Xanadu II/III).

	      get-fcb-version
		     This OEM command can get the fan control board (FCB) ver‐
		     sion number.   Command  confirmed	to  work  on  Inventec
		     5441/5442 (Dell Xanadu II/III).

	      set-fcb-version majorversion minorversion
		     This OEM command can set the fan control board (FCB) ver‐
		     sion number.  The majorversion and minorversion  must  be
		     specified	in  hex. Command confirmed to work on Inventec
		     5441/5442 (Dell Xanadu II/III).

	      get-sol-inactivity-timeout
		     This OEM command will retrieve the SOL  inactivity	 time‐
		     out.  Command  confirmed  to  work	 on Inventec 5441/5442
		     (Dell Xanadu II/III).

	      set-sol-inactivity-timeout inactivity-timeout
		     This OEM command will set the SOL inactivity timeout. The
		     inactivity-timeout	 is  one-based,	 max  of  65535,  in 1
		     minute increments (e.g. 1 = 1 minute), 0 or  "none"  will
		     configure	no  timeout.   Command	confirmed  to  work on
		     Inventec 5441/5442 (Dell Xanadu II/III).

	      restore-to-defaults all|user|lan|sol|serial|pef
		     This OEM command will restore certain  BMC	 configuration
		     sections  back  to	 default values. The command will spin
		     until the reset is confirmed to be complete. Command con‐
		     firmed  to work on Inventec 5442 (Dell Xanadu III). After
		     running this command, the BMC must be reset to return  it
		     to	 functioning  status. This may be accomplished by exe‐
		     cuting a cold-reset with bmc-device(8).

	      read-eeprom at24c256n
		     This OEM command will read the specified eeprom.  Command
		     confirmed	to  work on Inventec 5441 (Dell Xanadu II) for
		     at24c256.

	      clear-eeprom at24c256n
		     This OEM command will clear the specified	eeprom,	 over‐
		     writing  all  bytes  with	0xFF. If the verbose option is
		     set, progress percent will be output as the  clearing  is
		     being  done.  Command  confirmed to work on Inventec 5441
		     (Dell Xanadu II) for at24c256.

       Quanta

	      get-nic-mode
		     This OEM command will determine the current NIC  mode  as
		     dedicated	or  shared.  Dedicated	indicates IPMI is only
		     available on the dedicated management port. Shared	 indi‐
		     cates IPMI is also available on one of the primary ether‐
		     net ports. Command confirmed to work on Quanta S99Q (Dell
		     FS12-TY).

	      set-nic-mode dedicated|shared
		     This  OEM	command will set the current NIC mode to dedi‐
		     cated or shared.  (See get-nic-mode above for description
		     on	 dedicated  vs.	 shared	 mode.)	 This  OEM command may
		     internally reset the BMC, making  the  BMC	 unusable  for
		     awhile.  Command  confirmed  to work on Quanta S99Q (Dell
		     FS12-TY).

	      get-bmc-services
		     This OEM command will display the currently  enabled  BMC
		     services.	Command confirmed to work on Quanta S99Q (Dell
		     FS12-TY).

	      set-bmc-services enable|disable all|kvm|http|ssh
		     This OEM command will enable or disable  other  BMC  ser‐
		     vices  besides  IPMI. all can be specified to enable/dis‐
		     able all services, kvm specifies KVM and Virtual Storage,
		     http specifies HTTP and HTTPS, and ssh specifies both SSH
		     and Telnet. Command confirmed  to	work  on  Quanta  S99Q
		     (Dell FS12-TY).

	      get-account-status
		     This  OEM	command will output the current account status
		     of users on the BMC. This command is particularly	usefor
		     for determinining which users in the system may have been
		     locked out via authentication failures. Command confirmed
		     to work on Quanta S99Q (Dell FS12-TY).

	      get-dns-config
		     This  OEM	command	 will  display additional OEM DNS set‐
		     tings.  (See set-dns-config below for description on out‐
		     puts.)  Command  confirmed	 to  work on Quanta S99Q (Dell
		     FS12-TY).

	      set-dns-config KEY=VALUE ...
		     This OEM command will set additional OEM DNS settings  on
		     the  IPMI	card.  The  possible keys and values are dnsd‐
		     hcp=enable|disable,		 dnsserver1=ipaddress,
		     dnsserver2=ipaddress, dnsregisterbmc=enable|disable, dns‐
		     bmchostname=string, dnsdomainnamedhcp=enable|disable, and
		     dnsdomainname=string. dnsdhcp specifies if the DNS server
		     IP addresses should be assigned  from  the	 DHCP  server.
		     dnsserver1	 and  dnsserver2  specify  the	IP  addess for
		     server 1 and 2 respectively. These fields are  read  only
		     if dnsdhcp and DHCP are enabled. dnsregisterbmc specifies
		     if the BMC host name is registered via  the  DNS  server.
		     dnsbmchostname specifies the BMC host name. This field is
		     read only if dnsregisterbmc is enabled. dnsdomainnamedhcp
		     specifies	if  the DNS domainname should be assigned from
		     the DHCP server. dnsdomainname specifies the  DNS	domain
		     name string. This field is read only if dnsdomainnamedhcp
		     is enabled. Multiple key=value pairs may be specified. If
		     no key=value pairs are specifed, available pairs are out‐
		     put. Command confirmed  to	 work  on  Quanta  S99Q	 (Dell
		     FS12-TY).

	      get-web-server-config
		     This OEM command will get the current web server configu‐
		     ration on the IPMI card. Command  confirmed  to  work  on
		     Quanta S99Q (Dell FS12-TY).

	      set-web-server-config KEY=VALUE ...
		     This OEM command will set the current web server configu‐
		     ration on the IPMI card. The possible keys and values are
		     webserver=enable|disable, webservertimeout=seconds, http‐
		     portnumber=num,   and    httpsportnumber=num.    Multiple
		     key=value	pairs  may be specified. If no key=value pairs
		     are specifed, available pairs are	output.	 Command  con‐
		     firmed to work on Quanta S99Q (Dell FS12-TY).

	      get-power-management-config
		     This  OEM	command	 will get the current power management
		     configuration on the IPMI card. Command confirmed to work
		     on Quanta S99Q (Dell FS12-TY).

	      set-power-management-config KEY=VALUE ...
		     This  OEM	command	 will set the current power management
		     configuration on the IPMI card.  The  possible  keys  and
		     values are dpnmpowermanagement=enable|disable, powerstag‐
		     geringacrecovery=immediate|auto|user,   powerondelay=sec‐
		     onds,  and	 maxpowerondelay=seconds.  dpnmpowermanagement
		     enables or diables DPNM, Dynamic Power  Node  Management.
		     For  powerstaggeringacrecovery,  immediate	 specifies  no
		     delay, auto generates a delay time	 between  the  minimum
		     and  maximum  configured,	and user uses the user defined
		     time defined by powerondelay. powerondelay must be within
		     the  minimum  and	maximum power on delay times. Multiple
		     key=value pairs may be specified. If no  key=value	 pairs
		     are  specifed,  available	pairs are output. Command con‐
		     firmed to work on Quanta S99Q (Dell FS12-TY).

	      get-sol-idle-timeout
		     This OEM command will get the SOL idle  timeout.  Command
		     confirmed to work on Quanta S99Q (Dell FS12-TY).

	      set-sol-idle-timeout idle-timeout
		     This  OEM	command	 will  set  the	 SOL idle timeout. The
		     idle-timeout is one-based, max  of	 65535,	 in  1	minute
		     increments	 (e.g. 1 = 1 minute), 0 or "none" will config‐
		     ure no timeout. Command confirmed to work on Quanta  S99Q
		     (Dell FS12-TY).

	      get-telnet-ssh-redirect-status
		     This OEM command will get the telnet/SSH redirect status.
		     Command confirmed to work on Quanta S99Q (Dell FS12-TY).

	      set-telnet-ssh-redirect-status enable|disable
		     This OEM command will enable or disable telnet/SSH	 redi‐
		     rect  status.   Command  confirmed to work on Quanta S99Q
		     (Dell FS12-TY).

	      reset-to-defaults all|user|lan|sol|serial|pef
		     This OEM command will  reset  certain  BMC	 configuration
		     sections  back  to	 default values. The command will spin
		     until the reset is confirmed to be complete. Command con‐
		     firmed to work on Quanta S99Q (Dell FS12-TY).  After run‐
		     ning this command, the BMC must be reset to return it  to
		     functioning status. This may be accomplished by executing
		     a cold-reset with bmc-device(8).

	      get-processor-information [processor-index]
		     This OEM command will determine system processor informa‐
		     tion.  By	default, information about each processor will
		     be output. If a processor-index is specified,  only  that
		     specific  processor  will be output. Command confirmed to
		     work on Quanta S99Q (Dell FS12-TY).

	      read-mac-address s99q dedicated|shared
		     This command will read the currently configured dedicated
		     or	 shared	 MAC  address  for a specified motherboard. It
		     will read the MAC address directly from the  BMC  eeprom.
		     Command  confirmed	 to work on Quanta S99Q (Dell FS12-TY)
		     for s99q.

	      write-mac-address s99q dedicated|shared MACADDR
		     This OEM command will set the dedicated or shared BMC MAC
		     address  for  a specified motherboard. It will be written
		     directly to the BMC eeprom. (See get-nic-mode  above  for
		     description  on  dedicated	 vs. shared mode.) The BMC MAC
		     address cannot be set through the normal IPMI MAC address
		     command  (what  is	 used  in the bmc-config(8) tool). The
		     MACADDR should be specified in XX:XX:XX:XX:XX:XX form.  A
		     shared  BMC MAC address may conflict with normal communi‐
		     cation ethernet communication  on	the  primary  ethernet
		     port.  Users  may	wish to configuration an alternate MAC
		     address instead. After configuration of the MAC  address,
		     the  BMC  must be reset. This may be accomplished by exe‐
		     cuting a cold-reset  with	bmc-device(8).	 Command  con‐
		     firmed to work on Quanta S99Q (Dell FS12-TY) for s99q.

       Sun

	      get-led
		     This  OEM command will output current LED mode. off indi‐
		     cates the LED is steady off,  on  indicates  the  LED  is
		     steady  on,  standby  indicates the LED blinks at a 100ms
		     on, 2900ms off rate, slow indicates the LED  is  blinking
		     at	 1Hz,  and  fast indicates the LED is blinking at 4Hz.
		     If the verbose option is set, sensor names will be output
		     with their entity ID and instance when appropriate. (Sim‐
		     ilar to the  --entity-sensor-names	 option	 in  ipmi-sen‐
		     sors.)  This OEM command requires access to the SDR. Com‐
		     mand confirmed to work on Sun Fire 4140 with ILOM.

	      set-led record_id off|on|standby|slow|fast
		     This OEM command will configure LED modes.	 (See  get-led
		     above  for	 description  on  LED modes.) This OEM command
		     requires access to the SDR. Command confirmed to work  on
		     Sun Fire 4140 with ILOM.

       Supermicro

	      extra-firmware-info
		     This  OEM command will output additional firmware version
		     information.  Command confirmed  to  work	on  Supermicro
		     H8QME.

	      reset-intrusion
		     This  OEM	command	 will  reset the motherboard intrusion
		     flag after it has been triggered. For example,  in	 ipmi-
		     sensors  or  ipmi-sel,  you may notice a 'General Chassis
		     Intrusion' if the motherboard chassis is  not  open,  but
		     was  opened  in  the  past.  Command confirmed to work on
		     Supermicro H8QME.

	      get-bmc-services-status
		     This OEM command  will  determine	if  non-IPMI  services
		     (e.g.  ssh, http, https, vnc, etc.) are currently enabled
		     or disabled on the BMC.  Command  confirmed  to  work  on
		     Supermicro X8DTG.

	      set-bmc-services-status enable|disable
		     This OEM command will enable or disable all non-IPMI ser‐
		     vices on the BMC. This command can be used to  enable  or
		     disable  non-IPMI	services such as ssh, http, https, and
		     vnc. Command confirmed to work on Supermicro X8DTG.

       Wistron

	      get-system-info KEY
		     This OEM command  can  retrieve  the  motherboard	system
		     information.   Valid  keys	 are  asset-tag,  service-tag,
		     product-name. Command confirmed to work on Wistron / Dell
		     Poweredge C6220.

	      get-nic-mode
		     This  OEM	command will determine the current NIC mode as
		     dedicated or shared. Dedicated  indicates	IPMI  is  only
		     available	on the dedicated management port. Shared indi‐
		     cates IPMI is also available on one of the primary ether‐
		     net  ports.  Command  confirmed to work on Wistron / Dell
		     Poweredge C6220.

	      set-nic-mode dedicated|shared
		     This OEM command will set the current NIC mode  to	 dedi‐
		     cated or shared.  (See get-nic-mode above for description
		     on dedicated vs. shared mode.) After  running  this  com‐
		     mand,  the	 BMC may need to be reset to finalize the con‐
		     figuration. This may be accomplished by executing a cold-
		     reset  with  bmc-device(8).  Command confirmed to work on
		     Wistron / Dell Poweredge C6220.

	      get-shared-nic-selection
		     This OEM command will determine the current NIC  IPMI  is
		     shared  with  if  the  mode  is shared. (See get-nic-mode
		     above for description on dedicated vs. shared mode.) Com‐
		     mand confirmed to work on Wistron / Dell Poweredge C6220.

	      set-shared-nic-selection nic1|nic2|nic3|nic4|clear
		     This  OEM command will set the current NIC sharing selec‐
		     tion. If the current NIC mode is dedicated it  is	advis‐
		     able to clear this setting with the clear option. Command
		     confirmed to work on Wistron / Dell Poweredge C6220.

	      get-bmc-services
		     This OEM command will display the currently  enabled  BMC
		     services.	 Command  confirmed  to work on Wistron / Dell
		     Poweredge C6220.

	      set-bmc-services enable|disable all|kvm|http|ssh|snmp|telnet
		     This OEM command will enable or disable  other  BMC  ser‐
		     vices  besides  IPMI. all can be specified to enable/dis‐
		     able all services, kvm specifies KVM and Virtual Storage,
		     http  specifies HTTP and HTTPS. Command confirmed to work
		     on Wistron / Dell Poweredge C6220.

	      get-account-status
		     This OEM command will output the current  account	status
		     of	 users on the BMC. This command is particularly usefor
		     for determinining which users in the system may have been
		     locked out via authentication failures. Command confirmed
		     to work on Wistron / Dell Poweredge C6220.

	      get-dns-config
		     This OEM command will display  additional	OEM  DNS  set‐
		     tings.  (See set-dns-config below for description on out‐
		     puts.) Command confirmed to work on Wistron /  Dell  Pow‐
		     eredge C6220.

	      set-dns-config KEY=VALUE ...
		     This  OEM command will set additional OEM DNS settings on
		     the IPMI card. The possible keys  and  values  are	 dnsd‐
		     hcp=enable|disable,		 dnsserver1=ipaddress,
		     dnsserver2=ipaddress, dnsregisterbmc=enable|disable, dns‐
		     bmchostname=string,     dnsdomainnamedhcp=enable|disable,
		     dnsdomainname=string,  and	 dnsregistrationdelay=seconds.
		     dnsdhcp  specifies	 if the DNS server IP addresses should
		     be	 assigned  from	 the  DHCP  server.   dnsserver1   and
		     dnsserver2	 specify  the  IP  addess  for	server 1 and 2
		     respectively. These fields are read only if  dnsdhcp  and
		     DHCP  are	enabled.  dnsregisterbmc  specifies if the BMC
		     host name is registered via the DNS  server.  dnsbmchost‐
		     name specifies the BMC host name. This field is read only
		     if dnsregisterbmc is enabled. dnsdomainnamedhcp specifies
		     if	 the  DNS  domainname should be assigned from the DHCP
		     server.  dnsdomainname  specifies	the  DNS  domain  name
		     string.  This  field is read only if dnsdomainnamedhcp is
		     enabled. dnsregistrationdelay specifies the delay the BMC
		     should  take  after  the  IPMI process is up and running.
		     Multiple  key=value  pairs	 may  be  specified.   If   no
		     key=value pairs are specifed, available pairs are output.
		     Command confirmed to work on  Wistron  /  Dell  Poweredge
		     C6220.

	      get-web-server-config
		     This OEM command will get the current web server configu‐
		     ration on the IPMI card. Command  confirmed  to  work  on
		     Wistron / Dell Poweredge C6220.

	      set-web-server-config KEY=VALUE ...
		     This OEM command will set the current web server configu‐
		     ration on the IPMI card. The possible keys and values are
		     webserver=enable|disable, webservertimeout=seconds, http‐
		     portnumber=num,   and    httpsportnumber=num.    Multiple
		     key=value	pairs  may be specified. If no key=value pairs
		     are specifed, available pairs are	output.	 Command  con‐
		     firmed to work on Wistron / Dell Poweredge C6220.

	      get-power-management-config
		     This  OEM	command	 will get the current power management
		     configuration on the IPMI card. Command confirmed to work
		     on Wistron / Dell Poweredge C6220.

	      set-power-management-config KEY=VALUE ...
		     This  OEM	command	 will set the current power management
		     configuration on the IPMI card.  The  possible  keys  and
		     values are powerstaggeringacrecovery=immediate|auto|user,
		     powerondelay=seconds,  and	 maxpowerondelay=seconds.  For
		     powerstaggeringacrecovery,	 immediate specifies no delay,
		     auto generates a delay time between the minimum and maxi‐
		     mum  configured,  and  user  uses	the  user defined time
		     defined by powerondelay. powerondelay must be within  the
		     minimum  and  maximum  power  on  delay  times.  Multiple
		     key=value pairs may be specified. If no  key=value	 pairs
		     are  specifed,  available	pairs are output. Command con‐
		     firmed to work on Wistron / Dell Poweredge C6220.

	      get-ipv6-settings
		     This OEM command will get the current  IPv6  settings  on
		     the  IPMI	card.  Command	confirmed to work on Wistron /
		     Dell Poweredge C6220.

	      set-ipv6-settings KEY=VALUE ...
		     This OEM command will set the current  IPv6  settings  on
		     the   IPMI	 card.	 The  possible	keys  and  values  are
		     ipv6=enable|disable,   ipv6address=ipaddress,   ipv6gate‐
		     wayaddress=ipaddress,  ipv6prefixlength=length, ipv6auto‐
		     config=enable|disable,	   ipv6autodns=enable|disable,
		     ipv6dnsserver1=ipaddress,	and  ipv6dnsserver2=ipaddress.
		     If no key=value pairs are specifed, available  pairs  are
		     output.  Some  fields  may	 be read-only on specific Pow‐
		     eredge systems. Command confirmed to work	on  Wistron  /
		     Dell Poweredge C6220.

	      get-ipv6-trap-settings
		     This OEM command will get the current IPv6 SNMP trap set‐
		     tings on the IPMI card.  Command  confirmed  to  work  on
		     Wistron / Dell Poweredge C6220.

	      set-ipv6-trap-settings index KEY=VALUE ...
		     This OEM command will set the current IPv6 SNMP trap set‐
		     tings on the IPMI card. The  index	 indicates  the	 index
		     position  for  the configuration. It is followed by a set
		     of configuration keys and values. The possible  keys  and
		     values  are  destinationtype=pet|oem1|oem2, alertacktime‐
		     out=seconds, retries=count, and ipv6snmptrapaddress=ipad‐
		     dress.  If	 no  key=value	pairs  are specifed, available
		     pairs are output. Some fields may be  read-only  on  spe‐
		     cific  Poweredge  systems.	 Command  confirmed to work on
		     Wistron / Dell Poweredge C6220.

	      get-sol-idle-timeout
		     This OEM command will get the SOL idle  timeout.  Command
		     confirmed to work on Wistron / Dell Poweredge C6220.

	      set-sol-idle-timeout idle-timeout
		     This  OEM	command	 will  set  the	 SOL idle timeout. The
		     idle-timeout is one-based, max  of	 65535,	 in  1	minute
		     increments	 (e.g. 1 = 1 minute), 0 or "none" will config‐
		     ure no timeout. Command confirmed to work	on  Wistron  /
		     Dell Poweredge C6220.

	      get-telnet-redirect-function
		     This  OEM	command will get the telnet redirect function.
		     Command confirmed to work on  Wistron  /  Dell  Poweredge
		     C6220.

	      set-telnet-redirect-function disable|solenable|smashenable
		     This  OEM	command will enable or disable telnet redirect
		     function.	Command confirmed to work on  Wistron  /  Dell
		     Poweredge C6220.

	      get-dhcp-retry
		     This  OEM	command	 will retrieve DHCP retry information.
		     Wistron / Dell Poweredge C6220.

	      set-dhcp-retry retry-count retry-interval retry-timeout
		     This OEM command will set	DHCP  retry  information.  The
		     retry-count  is  one-based,  max of 254, 0 or "none" will
		     configure no retries, 255 or "indefinite" will  configure
		     constant  retries. The retry-interval is one-based, in 10
		     second increments (e.g. 1 = 10 seconds). The  retry-time‐
		     out  is  one-based,  in  1	 minute increments (e.g. 1 = 1
		     minute).  After running this command, the BMC may need to
		     be	 reset	to  finalize  the  configuration.  This may be
		     accomplished  by  executing  a   cold-reset   with	  bmc-
		     device(8).	  Command  confirmed to work on Wistron / Dell
		     Poweredge C6220.

	      get-link-status-change-control
		     This OEM command will get the current link status	change
		     control.  If  it  reports "Link Down Resilience Enabled",
		     BMC firmware will do nothing upon detecting  Link	Status
		     Change  until  the	 DHCP  lease is expired. If it reports
		     "DHCP Re-Discovery Enabled", BMC  firmware	 will  perform
		     DHCP Discovery upon detecting link status going down than
		     back up. Command confirmed to work on Wistron / Dell Pow‐
		     eredge C6220..

	      set-link-status-change-control link_resilience|dhcp_rediscovery
		     This  OEM	command	 will  set the current NIC link status
		     change control setting. (See  set-link-status-change-con‐
		     trol  above  for description of arguments). After running
		     this command, the BMC may need to be  reset  to  finalize
		     the  configuration. This may be accomplished by executing
		     a cold-reset with bmc-device(8).	Command	 confirmed  to
		     work on Wistron / Dell Poweredge C6220.

	      set-password-policy <enable|disable>
		     This  OEM	command	 will  set the current password policy
		     enforcement. If password policy is enabled, BMC passwords
		     must  meet	 the  following	 requirements: Not contain the
		     user's name, be 8-14 characters long, and	contain	 three
		     of the following four, an English uppercase character (A-
		     Z), an English lowercase character (a-z), a digit	(0-9),
		     a special character (!, $, #, %, etc.). Command confirmed
		     to work on Wistron / Dell Poweredge C6220.

	      read-proprietary-string
		     This OEM command will read the proprietary string	stored
		     in	 the FRU.  The proprietary string is a string the user
		     may set for any management purpose. It can also  be  read
		     via  ipmi-fru.   Command  confirmed  to work on Wistron /
		     Dell Poweredge C6220.

	      set-proprietary-string <string>
		     This OEM command will write the proprietary string stored
		     in	 the FRU.  The maximum length string is 80 characters.
		     Command confirmed to work on  Wistron  /  Dell  Poweredge
		     C6220.

	      clear-proprietary-string
		     This OEM command will clear the proprietary string stored
		     in the FRU.  Command confirmed to work on Wistron /  Dell
		     Poweredge C6220.

HOSTRANGED SUPPORT
       Multiple hosts can be input either as an explicit comma separated lists
       of hosts or a range of hostnames in  the	 general  form:	 prefix[n-m,l-
       k,...],	where  n < m and l < k, etc. The later form should not be con‐
       fused with regular expression character classes (also denoted  by  []).
       For example, foo[19] does not represent foo1 or foo9, but rather repre‐
       sents a degenerate range: foo19.

       This range syntax is meant only as a convenience	 on  clusters  with  a
       prefixNN	 naming	 convention  and specification of ranges should not be
       considered necessary -- the list foo1,foo9 could be specified as	 such,
       or by the range foo[1,9].

       Some examples of range usage follow:
	   foo[01-05] instead of foo01,foo02,foo03,foo04,foo05
	   foo[7,9-10] instead of foo7,foo9,foo10
	   foo[0-3] instead of foo0,foo1,foo2,foo3

       As a reminder to the reader, some shells will interpret brackets ([ and
       ]) for pattern matching. Depending on your shell, it may	 be  necessary
       to enclose ranged lists within quotes.

       When  multiple  hosts  are specified by the user, a thread will be exe‐
       cuted for each host in parallel up to the configured fanout (which  can
       be  adjusted via the -F option). This will allow communication to large
       numbers of nodes far more quickly than if done in serial.

       By default, standard output from each node  specified  will  be	output
       with the hostname prepended to each line. Although this output is read‐
       able in many situations, it may be difficult to read  in	 other	situa‐
       tions.  For  example, output from multiple nodes may be mixed together.
       The -B and -C options can be used to change this default.

       In-band IPMI Communication will be used when the	 host  "localhost"  is
       specified.  This	 allows	 the  user  to add the localhost into the hos‐
       tranged output.

GENERAL TROUBLESHOOTING
       Most often, IPMI problems are due to configuration problems.

       IPMI over  LAN  problems	 involve  a  misconfiguration  of  the	remote
       machine's  BMC.	Double check to make sure the following are configured
       properly in the remote machine's BMC: IP address, MAC  address,	subnet
       mask,  username,	 user enablement, user privilege, password, LAN privi‐
       lege, LAN enablement, and allowed authentication type(s). For IPMI  2.0
       connections,  double  check  to make sure the cipher suite privilege(s)
       and K_g key are configured properly. The bmc-config(8) tool can be used
       to check and/or change these configuration settings.

       Inband  IPMI  problems  are  typically  caused by improperly configured
       drivers or non-standard BMCs.

       In addition to the troubleshooting tips below, please  see  WORKAROUNDS
       below to also if there are any vendor specific bugs that have been dis‐
       covered and worked around.

       Listed below are many of the common issues  for	error  messages.   For
       additional  support, please e-mail the <freeipmi-users@gnu.org> mailing
       list.

       "username invalid" - The username entered (or a NULL username  if  none
       was  entered)  is  not  available on the remote machine. It may also be
       possible the remote BMC's username configuration is incorrect.

       "password invalid" - The password entered (or a NULL password  if  none
       was  entered)  is not correct. It may also be possible the password for
       the user is not correctly configured on the remote BMC.

       "password verification timeout" - Password verification has timed  out.
       A  "password  invalid"  error  (described  above) or a generic "session
       timeout" (described below) occurred.  During this point in the protocol
       it cannot be differentiated which occurred.

       "k_g  invalid"  -  The  K_g  key entered (or a NULL K_g key if none was
       entered) is not correct. It may also be possible the  K_g  key  is  not
       correctly configured on the remote BMC.

       "privilege level insufficient" - An IPMI command requires a higher user
       privilege than the one authenticated with. Please try  to  authenticate
       with a higher privilege. This may require authenticating to a different
       user which has a higher maximum privilege.

       "privilege level cannot be obtained for	this  user"  -	The  privilege
       level  you are attempting to authenticate with is higher than the maxi‐
       mum allowed for this user. Please try again with a lower privilege.  It
       may  also be possible the maximum privilege level allowed for a user is
       not configured properly on the remote BMC.

       "authentication type unavailable for attempted privilege level"	-  The
       authentication  type you wish to authenticate with is not available for
       this privilege level. Please try again with an alternate authentication
       type  or	 alternate privilege level. It may also be possible the avail‐
       able authentication types you can authenticate with are	not  correctly
       configured on the remote BMC.

       "cipher suite id unavailable" - The cipher suite id you wish to authen‐
       ticate with is not available on the remote BMC. Please try  again  with
       an  alternate  cipher  suite  id. It may also be possible the available
       cipher suite ids are not correctly configured on the remote BMC.

       "ipmi 2.0 unavailable" - IPMI 2.0 was  not  discovered  on  the	remote
       machine. Please try to use IPMI 1.5 instead.

       "connection  timeout"  - Initial IPMI communication failed. A number of
       potential errors are possible, including an invalid hostname specified,
       an  IPMI	 IP  address  cannot  be  resolved, IPMI is not enabled on the
       remote server, the network connection is bad, etc. Please  verify  con‐
       figuration and connectivity.

       "session	 timeout"  - The IPMI session has timed out. Please reconnect.
       If this error occurs often, you may wish to increase the retransmission
       timeout. Some remote BMCs are considerably slower than others.

       "device	not  found"  - The specified device could not be found. Please
       check configuration or inputs and try again.

       "driver timeout" - Communication with the driver or  device  has	 timed
       out. Please try again.

       "message	 timeout"  - Communication with the driver or device has timed
       out. Please try again.

       "BMC busy" - The BMC is currently busy. It may be  processing  informa‐
       tion  or have too many simultaneous sessions to manage. Please wait and
       try again.

       "could not find inband device" - An inband device could not  be	found.
       Please  check configuration or specify specific device or driver on the
       command line.

       "driver timeout" - The inband driver has timed out communicating to the
       local  BMC  or  service	processor. The BMC or service processor may be
       busy or (worst case) possibly non-functioning.

WORKAROUNDS
       With so many different vendors implementing their own  IPMI  solutions,
       different  vendors  may implement their IPMI protocols incorrectly. The
       following describes a number of workarounds currently available to han‐
       dle  discovered compliance issues. When possible, workarounds have been
       implemented so they will be transparent to the user. However, some will
       require the user to specify a workaround be used via the -W option.

       The hardware listed below may only indicate the hardware that a problem
       was discovered on. Newer versions of  hardware  may  fix	 the  problems
       indicated  below.  Similar machines from vendors may or may not exhibit
       the same problems. Different vendors may license	 their	firmware  from
       the  same IPMI firmware developer, so it may be worthwhile to try work‐
       arounds listed below even if your motherboard is not listed.

       If you believe your hardware has an additional  compliance  issue  that
       needs a workaround to be implemented, please contact the FreeIPMI main‐
       tainers on <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>.

       assumeio - This workaround flag will assume inband interfaces  communi‐
       cate  with  system  I/O rather than being memory-mapped. This will work
       around systems that report invalid base addresses. Those	 hitting  this
       issue  may see "device not supported" or "could not find inband device"
       errors.	Issue observed on HP ProLiant DL145 G1.

       spinpoll - This workaround flag will inform some inband	drivers	 (most
       notably	the  KCS driver) to spin while polling rather than putting the
       process to sleep. This may significantly improve the wall clock running
       time  of	 tools because an operating system scheduler's granularity may
       be much larger than the time it takes to perform a single IPMI  message
       transaction.  However,  by spinning, your system may be performing less
       useful work by not contexting out the tool for a more useful task.

       authcap - This workaround flag will  skip  early	 checks	 for  username
       capabilities,  authentication  capabilities,  and K_g support and allow
       IPMI authentication to succeed. It  works  around  multiple  issues  in
       which the remote system does not properly report username capabilities,
       authentication capabilities, or K_g status. Those  hitting  this	 issue
       may  see	 "username  invalid",  "authentication	type  unavailable  for
       attempted privilege level", or "k_g invalid" errors.  Issue observed on
       Asus  P5M2/P5MT-R/RS162-E4/RX4,	Intel  SR1520ML/X38ML,	and  Sun  Fire
       2200/4150/4450 with ELOM.

       nochecksumcheck - This workaround flag will tell FreeIPMI to not	 check
       the  checksums  returned	 from  IPMI command responses. It works around
       systems that return invalid checksums due to implementation errors, but
       the  packet  is otherwise valid. Users are cautioned on the use of this
       option, as it removes validation of packet integrity  in	 a  number  of
       circumstances.  However,	 it  is unlikely to be an issue in most situa‐
       tions. Those hitting this issue may see "connection timeout",  "session
       timeout",  or  "password verification timeout" errors. On IPMI 1.5 con‐
       nections, the "noauthcodecheck" workaround may also needed  too.	 Issue
       observed	 on  Supermicro	 X9SCM-iiF, Supermicro X9DRi-F, and Supermicro
       X9DRFR.

       idzero - This workaround flag  will  allow  empty  session  IDs	to  be
       accepted by the client. It works around IPMI sessions that report empty
       session IDs to the client. Those hitting this issue  may	 see  "session
       timeout" errors. Issue observed on Tyan S2882 with M3289 BMC.

       unexpectedauth  -  This	workaround flag will allow unexpected non-null
       authcodes to be checked as though they were expected. It	 works	around
       an  issue  when	packets contain non-null authentication data when they
       should be null due to disabled per-message authentication.  Those  hit‐
       ting  this  issue  may  see "session timeout" errors. Issue observed on
       Dell PowerEdge 2850,SC1425. Confirmed fixed on newer firmware.

       forcepermsg - This workaround flag will force  per-message  authentica‐
       tion  to	 be used no matter what is advertised by the remote system. It
       works around an issue when per-message authentication is advertised  as
       disabled on the remote system, but it is actually required for the pro‐
       tocol. Those hitting this  issue	 may  see  "session  timeout"  errors.
       Issue observed on IBM eServer 325.

       endianseq  -  This  workaround flag will flip the endian of the session
       sequence numbers to allow the session to continue  properly.  It	 works
       around  IPMI  1.5  session  sequence numbers that are the wrong endian.
       Those hitting this  issue  may  see  "session  timeout"	errors.	 Issue
       observed	 on  some  Sun	ILOM  1.0/2.0  (depends	 on  service processor
       endian).

       noauthcodecheck - This workaround flag will tell FreeIPMI to not	 check
       the  authentication  codes returned from IPMI 1.5 command responses. It
       works around systems that return invalid authentication	codes  due  to
       hashing	or  implementation  errors.  Users are cautioned on the use of
       this option, as it removes an authentication check verifying the valid‐
       ity of a packet. However, in most organizations, this is unlikely to be
       a security issue. Those hitting this issue may  see  "connection	 time‐
       out",  "session	timeout",  or  "password verification timeout" errors.
       Issue observed on Xyratex FB-H8-SRAY.

       intel20 - This workaround flag will work around several Intel IPMI  2.0
       authentication issues. The issues covered include padding of usernames,
       and password  truncation	 if  the  authentication  algorithm  is	 HMAC-
       MD5-128. Those hitting this issue may see "username invalid", "password
       invalid", or "k_g invalid" errors. Issue observed  on  Intel  SE7520AF2
       with Intel Server Management Module (Professional Edition).

       supermicro20 - This workaround flag will work around several Supermicro
       IPMI 2.0	 authentication	 issues	 on  motherboards  w/  Peppercon  IPMI
       firmware.  The issues covered include handling invalid length authenti‐
       cation codes. Those hitting  this  issue	 may  see  "password  invalid"
       errors.	 Issue	observed on Supermicro H8QME with SIMSO daughter card.
       Confirmed fixed on newerver firmware.

       sun20 - This workaround flag will work work around several Sun IPMI 2.0
       authentication issues. The issues covered include invalid lengthed hash
       keys, improperly hashed keys, and invalid cipher suite  records.	 Those
       hitting	this  issue  may see "password invalid" or "bmc error" errors.
       Issue observed on Sun Fire 4100/4200/4500 with ILOM.   This  workaround
       automatically includes the "opensesspriv" workaround.

       opensesspriv - This workaround flag will slightly alter FreeIPMI's IPMI
       2.0 connection protocol to workaround an invalid hashing algorithm used
       by  the remote system. The privilege level sent during the Open Session
       stage of an IPMI 2.0 connection is used for hashing keys instead of the
       privilege  level	 sent during the RAKP1 connection stage. Those hitting
       this issue may see "password invalid", "k_g invalid", or "bad  rmcpplus
       status  code"  errors.	Issue observed on Sun Fire 4100/4200/4500 with
       ILOM, Inventec 5441/Dell Xanadu II, Supermicro X8DTH, Supermicro X8DTG,
       Intel S5500WBV/Penguin Relion 700, Intel S2600JF/Appro 512X, and Quanta
       QSSC-S4R/Appro GB812X-CN. This workaround  is  automatically  triggered
       with the "sun20" workaround.

       integritycheckvalue  - This workaround flag will work around an invalid
       integrity check value during an IPMI  2.0  session  establishment  when
       using  Cipher Suite ID 0. The integrity check value should be 0 length,
       however the remote motherboard responds with a non-empty	 field.	 Those
       hitting	this  issue  may  see  "k_g invalid" errors. Issue observed on
       Supermicro X8DTG, Supermicro X8DTU, and Intel  S5500WBV/Penguin	Relion
       700, and Intel S2600JF/Appro 512X.

       assumemaxsdrrecordcount	-  This	 workaround will inform SDR reading to
       stop reading after a known maximum numer of SDR records have been read.
       This  will  work	 around	 systems that have mis-implemented SDR reading
       functions that. Those hitting this issue	 may  see  "SDR	 record	 count
       invalid" errors. Issue observed on unspecified Inspur motherboard.

       No IPMI 1.5 Support - Some motherboards that support IPMI 2.0 have been
       found to not support IPMI 1.5. Those hitting this issue may  see	 "ipmi
       2.0  unavailable"  or  "connection  timeout"  errors. This issue can be
       worked around by using IPMI 2.0	instead	 of  IPMI  1.5	by  specifying
       --driver-type=LAN_2_0. Issue observed on HP Proliant DL 145.

DIAGNOSTICS
       Upon  successful	 execution, exit status is 0. On error, exit status is
       1.

       If multiple hosts are specified for communication, the exit status is 0
       if  and	only  if  all targets successfully execute. Otherwise the exit
       status is 1.

KNOWN ISSUES
       On older operating systems, if you input your username,	password,  and
       other  potentially  security  relevant information on the command line,
       this information may be discovered by other users when using tools like
       the  ps(1) command or looking in the /proc file system. It is generally
       more secure to input password information with options like the	-P  or
       -K  options.  Configuring security relevant information in the FreeIPMI
       configuration file would also be an appropriate way to hide this infor‐
       mation.

       In  order  to  prevent  brute force attacks, some BMCs will temporarily
       "lock up" after a number of remote authentication errors. You may  need
       to  wait awhile in order to this temporary "lock up" to pass before you
       may authenticate again.

REPORTING BUGS
       Report bugs to <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>.

COPYRIGHT
       Copyright © 2008-2012 FreeIPMI Core Team

       This program 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.

SEE ALSO
       freeipmi(7),  bmc-config(8),  bmc-device(8),  ipmi-pef-config(8), ipmi-
       raw(8)

       http://www.gnu.org/software/freeipmi/

IPMI OEM version 1.2.9		  2014-05-01			   IPMI-OEM(8)
[top]

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]
Tweet
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