FreeBSD Manual Pages
ipmitool(1) ipmitool(1) NAME ipmitool - utility for controlling IPMI-enabled devices SYNOPSIS ipmitool [ <options> ] <command> [ <sub-commands and sub-options> ] <options> := [ <general-options> | <conditional-opts> ] Any recognized option is accepted. Conditional options may be ignored or it's usage postponed until shell or exec processes relevant command. <general-options> := [ -h | -V | -v | -I <interface> | -H <address> | -d <N> | -p <port> | -c | -U <username> | -L <privlvl> | -l <lun> | -m <local_address> | -N <sec> | -R <count> | <password-option> | <oem-option> | <bridge-options> ] <conditional-opts> := [ <lan-options> | <lanplus-options> | <command-options> ] Bridging: <bridge-options> := -t <target_address> [ -b <channel> | [ -T <address> | -B <channel> ] ] Options used with -I lan: <lan-options> := [ -A <authtype> ] Options used with -I lanplus: <lanplus-options> := [ -C <ciphersuite> | <key-option> ] Option groups setting same value: <key-option> := [ -k <key> | -K | -y <hex_key> | -Y ] <password-option> := [ -f <password_file> | -a | -P <password> | -E ] <oem-option> := [ -o <oemtype> | -g | -s ] Options used with specific command <command-options>: <options-sdr> := [ -S <sdr_cache_file> ] <options-sel> := [ -O <sel_oem> ] <options-sol> := [ -e <sol_escape_char> ] DESCRIPTION This program lets you manage Intelligent Platform Management Interface (IPMI) functions of either the local system, via a kernel device driver, or a remote system, using IPMI v1.5 and IPMI v2.0. These functions include printing FRU information, LAN configuration, sensor readings, and remote chassis power control. IPMI management of a local system interface requires a compatible IPMI ker- nel driver to be installed and configured. On Linux this driver is called OpenIPMI and it is included in standard distributions. On Solaris this driver is called BMC and is included in Solaris 10. Management of a remote station requires the IPMI-over-LAN interface to be enabled and configured. Depending on the particular requirements of each system it may be possible to enable the LAN interface using ipmitool over the system interface. OPTIONS -a Prompt for the remote server password. -A <authtype> Specify an authentication type to use during IPMIv1.5 lan session activation. Supported types are NONE, PASSWORD, MD2, MD5, or OEM. -b <channel> Set destination channel for bridged request. -B <channel> Set transit channel for bridged request (dual bridge). -b <channel> Set destination channel for bridged request. -B <channel> Set transit channel for bridged request. (dual bridge) -c Present output in CSV (comma separated variable) format. This is not available with all commands. -C <ciphersuite> The remote server authentication, integrity, and encryption algo- rithms to use for IPMIv2.0 lanplus connections. See table 22-20 in the IPMI v2.0 specification. The default is 17 which specifies RAKP-HMAC-SHA256 authentication, HMAC-SHA256-128 integrity, and AES-CBC-128 encryption algorithms. NOTE: In ipmitool 1.8.18 and earlier the default was 3, which was insecure and was not supported by some more recent BMC implementa- tions. -d N Use device number N to specify the /dev/ipmiN (or /dev/ipmi/N or /dev/ipmidev/N) device to use for in-band BMC communication. Used to target a specific BMC on a multi-node, multi-BMC system through the ipmi device driver interface. Default is 0. -e <sol_escape_char> Use supplied character for SOL session escape character. The de- fault is to use ~ but this can conflict with ssh sessions. -E The remote server password is specified by the environment variable IPMI_PASSWORD or IPMITOOL_PASSWORD. The IPMITOOL_PASSWORD takes precedence. -f <password_file> Specifies a file containing the remote server password. If this op- tion is absent, or if password_file is empty, the password will de- fault to NULL. -g Deprecated. Use: -o intelplus -h Get basic usage help from the command line. -H <address> Remote server address, can be IP address or hostname. This option is required for lan and lanplus interfaces. -I <interface> Selects IPMI interface to use. Supported interfaces that are com- piled in are visible in the usage help output. -k <key> Use supplied Kg key for IPMIv2.0 authentication. The default is not to use any Kg key. -K Read Kg key from IPMI_KGKEY environment variable. -l <lun> Set destination lun for raw commands. -L <privlvl> Force session privilege level. Can be CALLBACK, USER, OPERATOR, AD- MINISTRATOR. Default is ADMINISTRATOR. This value is ignored and always set to ADMINISTRATOR when combined with -t target address. -m <local_address> Set the local IPMB address. The local address defaults to 0x20 or is auto discovered on PICMG platforms when -m is not specified. There should be no need to change the local address for normal oper- ation. -N <sec> Specify nr. of seconds between retransmissions of lan/lanplus mes- sages. Defaults are 2 seconds for lan and 1 second for lanplus in- terfaces. Command raw uses fixed value of 15 seconds. Command sol uses fixed value of 1 second. -o <oemtype> Select OEM type to support. This usually involves minor hacks in place in the code to work around quirks in various BMCs from various manufacturers. Use -o list to see a list of current supported OEM types. -O <sel oem> Open selected file and read OEM SEL event descriptions to be used during SEL listings. See examples in contrib dir for file format. -p <port> Remote server UDP port to connect to. Default is 623. -P <password> Remote server password is specified on the command line. If sup- ported it will be obscured in the process list. Note! Specifying the password as a command line option is not recommended. -R <count> Set the number of retries for lan/lanplus interface (default=4). Command raw uses fixed value of one try (no retries). Command hpm uses fixed value of 10 retries. -s Deprecated. Use: -o supermicro -S <sdr_cache_file> Use local file for remote SDR cache. Using a local SDR cache can drastically increase performance for commands that require knowledge of the entire SDR to perform their function. Local SDR cache from a remote system can be created with the sdr dump command. -t <target_address> Bridge IPMI requests to the remote target address. Default is 32. The -L privlvl option is always ignored and value set to ADMINISTRA- TOR. -T <address> Set transit address for bridge request (dual bridge). -T <transmit_address> Set transit address for bridge request. (dual bridge) -U <username> Remote server username, default is NULL user. -v Increase verbose output level. This option may be specified multi- ple times to increase the level of debug output. If given three times you will get hexdumps of all incoming and outgoing packets. Using it five times provides details on request and expected reply processing. The hpm commands targetcap compprop abort upgstatus rollback rollbackstatus selftestresult increases the verbosity level -V Display version information. -y <hex key> Use supplied Kg key for IPMIv2.0 authentication. The key is expected in hexadecimal format and can be used to specify keys with non- printable characters. E.g. '-k PASSWORD' and '-y 50415353574F5244' are equivalent. The default is not to use any Kg key. -Y Prompt for the Kg key for IPMIv2.0 authentication. -z <size> Change Size of Communication Channel. (OEM) If no password method is specified then ipmitool will prompt the user for a password. If no password is entered at the prompt, the remote server pass- word will default to NULL. SECURITY There are several security issues be be considered before enabling the IPMI LAN interface. A remote station has the ability to control a system's power state as well as being able to gather certain platform information. To re- duce vulnerability it is strongly advised that the IPMI LAN interface only be enabled in 'trusted' environments where system security is not an issue or where there is a dedicated secure 'management network'. Further it is strongly advised that you should not enable IPMI for remote access without setting a password, and that that password should not be the same as any other password on that system. When an IPMI password is changed on a remote machine with the IPMIv1.5 lan interface the new password is sent across the network as clear text. This could be observed and then used to attack the remote system. It is thus recommended that IPMI password management only be done over IPMIv2.0 lan- plus interface or the system interface on the local station. For IPMI v1.5, the maximum password length is 16 characters; longer pass- words might be truncated or rejected by the server, or rejected by ipmi- tool. For IPMI v2.0, the maximum password length is 20 characters; longer pass- words will be rejected by ipmitool. COMMANDS help This can be used to get command-line help on ipmitool commands. It may also be placed at the end of commands to get option usage help. > ipmitool help Commands: bmc Deprecated. Use mc channel Configure Management Controller channels chassis Get chassis status and set power state dcmi Data Center Management Interface delloem Manage Dell OEM Extensions. echo Used to echo lines to stdout in scripts ekanalyzer run FRU-Ekeying analyzer using FRU files event Send events to MC exec Run list of commands from file firewall Configure Firmware Firewall fru Print built-in FRU and scan for FRU locators fwum Update IPMC using Kontron OEM Firmware Update Manager gendev Read/Write Device associated with Generic De- vice locators sdr hpm Update HPM components using PICMG HPM.1 file i2c Send an I2C Master Write-Read command and print response ime Upgrade/Query Intel ME firmware isol Configure and connect Intel IPMIv1.5 Ser- ial-over-LAN kontronoem Manage Kontron OEM Extensions lan Configure LAN Channels mc Management Controller status and global enables nm Node Manager pef Configure Platform Event Filtering (PEF) picmg Run a PICMG/ATA extended command power Shortcut to chassis power commands raw Send a RAW IPMI request and print response sdr Print Sensor Data Repository entries and read- ings sel Print System Event Log (SEL) sensor Print detailed sensor information session Print session information set Set runtime variable for shell and exec shell Launch interactive IPMI shell sol Configure and connect IPMIv2.0 Serial-over-LAN spd Print SPD info from remote I2C device sunoem Manage Sun OEM Extensions tsol Configure and connect Tyan IPMIv1.5 Ser- ial-over-LAN user Configure Management Controller users channel authcap <channel number> <max priv> Displays information about the authentication capabilities of the selected channel at the specified privilege level. Possible privilege levels are: 1 Callback level 2 User level 3 Operator level 4 Administrator level 5 OEM Proprietary level 15 No access info [channel number] Displays information about the selected channel. If no channel is given it will display information about the cur- rently used channel. > ipmitool channel info Channel 0xf info: Channel Medium Type : System Interface Channel Protocol Type : KCS Session Support : session-less Active Session Count : 0 Protocol Vendor ID : 7154 getaccess <channel number> [<userid>] Configure the given userid as the default on the given chan- nel number. When the given channel is subsequently used, the user is identified implicitly by the given userid. setaccess <channel number> <userid> [<callin=on|off>] [<ipmi=on|off>] [<link=on|off>] [<privilege=level>] Configure user access information on the given channel for the given userid. getciphers <ipmi|sol> [<channel>] Displays the list of cipher suites supported for the given application (ipmi or sol) on the given channel. chassis status Status information related to power, buttons, cooling, drives and faults. power status on off cycle reset diag soft identify [<seconds>|force] Identify interval. Default is 15 seconds. 0 - Off force - To turn on indefinitely policy What to do when power is restored. list Show available options. always-on previous always-off restart_cause Last restart cause. poh Get power on hours. bootdev none Do not change boot device order. pxe Force PXE boot. disk Force boot from default Hard-drive. safe Force boot from default Hard-drive, request Safe Mode. diag Force boot from Diagnostic Partition. cdrom Force boot from CD/DVD. bios Force boot into BIOS Setup. floppy Force boot from Floppy/primary removable media. bootmbox get [text] [block <block#>] Read the Boot Initiator Mailbox in hex dump or in text mode. By default the whole mailbox is read. If block number is specified, that particular block is read. For block 0 or when the whole mailbox is read, the Boot Initiator IANA Enterprise Number and the corresponding enterprise name are printed. bootmbox set text [block <block#>] <IANA_PEN> "<data_string>" Write the specified <block> or the entire Boot Initiator Mailbox in text mode. It is required to specify a decimal IANA Enterprise Number recognized by the boot initiator on the target system. Refer to your target system manufacturer for details. The rest of the arguments are a text string. When single block write is requested, the total length of <data> may not exceed 13 bytes for block 0, or 16 bytes oth- erwise. bootmbox set [block <block#>] <IANA_PEN> <data_byte> [<data_byte> ...] Same as above, but the arguments after IANA PEN are separate data byte values separated by spaces. bootparam get <opt_id> [<opt_param>] Get value of system boot option number <opt_id>. Some boot options (e.g. option 7) can also take an optional numeric pa- rameter. bootparam set bootflag <device> [options=...] Set a boot flag. Valid devices are: force_pxe Force PXE boot force_disk Force boot from default Hard-drive force_safe Force boot from default Hard-drive, request Safe Mode force_diag Force boot from Diagnostic Partition force_cdrom Force boot from CD/DVD force_bios Force boot into BIOS Setup Valid options are: PEF Clear valid bit on reset/power cycle cause by PEF timeout Automatically clear boot flag valid bit on timeout watchdog Clear valid bit on reset/power cycle cause by watchdog reset Clear valid bit on push button reset/soft reset power Clear valid bit on power up via power push button or wake event selftest Get the chassis self-test results dcmi discover This command is used to discover supported capabilities in DCMI. power <command> Platform power limit command options are: reading Get power related readings from the system. get_limit Get the configured power limits. set_limit <parameter> <value> Set a power limit option. Possible parameters/values are: action <No Action | Hard Power Off & Log Event to SEL | Log Event to SEL> Exception Actions are taken as "No Action", "Hard Power Off system and log events to SEL", or "Log event to SEL only". limit <number in Watts> Power Limit Requested in Watts. correction <number in milliseconds> Correction Time Limit in milliseconds. sample <number in seconds> Statistics Sampling period in seconds. activate Activate the set power limit. deactivate Deactivate the set power limit. sensors Prints the available DCMI sensors. asset_tag Prints the platforms asset tag. set_asset_tag <string> Sets the platforms asset tag get_mc_id_string Get management controller identifier string. set_mc_id_string <string> Set management controller identifier string. The maximum length is 64 bytes including a null terminator. thermalpolicy [<get | set>] Thermal Limit policy get/set. The commands are: Get <entityID> <instanceID> Get Thermal Limit values. entityID is the physical entity that a sensor or de- vice is associated with. instanceID is a particular instance of an entity. Entity Instance can be in one of two ranges, system-relative or device-relative. For example, a system with four processors could use an Entity Instance value of "0" to identify the first processor. Set <entityID> <instanceID> Set Thermal Limit values. entityID is the physical entity that a sensor or de- vice is associated with. instanceID is a particular instance of an entity. Entity Instance can be in one of two ranges, system-relative or device-relative. For example, a system with four processors could use an Entity Instance value of "0" to identify the first processor. get_temp_reading Get Temperature Sensor Readings. get_conf_param Get DCMI Configuration Parameters. set_conf_param <parameters> Set DCMI Configuration Parameters. The Configuration Parameters are: activate_dhcp Activate/restart DHCP dhcp_config Discover DHCP Configuration. init Set DHCP Initial timeout interval, in seconds. The recommended default is four seconds. timeout Set DHCP Server contact timeout interval, in seconds. The recommended default timeout is two minutes. retry Set DHCP Server contact retry interval, in seconds. The recommended default timeout is sixty-four seconds. oob_discover Ping/Pong Message for DCMI Discovery. delloem The delloem commands provide information on Dell-specific features. setled {b:d.f} {state..} Sets the drive backplane LEDs for a device. {b:d.f} = PCI Address of device (eg. 06:00.0) {state} = one or more of the following: online | present | hotspare | identify | rebuilding | fault | predict | critical | failed lcd set {mode}|{lcdqualifier}|{errordisplay} Allows you to set the LCD mode and user-defined string. lcd set mode {none}|{modelname}|{ipv4address}|{macaddress}| {systemname}|{servicetag}|{ipv6address}| {ambienttemp}|{systemwatt}|{assettag}| {userdefined}<text> Allows you to set the LCD display mode to any of the preceding parameters. lcd set lcdqualifier {watt}|{btuphr}| {celsius}|{fahrenheit} Allows you to set the unit for the system ambient tem- perature mode. lcd set errordisplay {sel}|{simple} Allows you to set the error display. lcd info Displays the LCD screen information. lcd set vkvm {active}|{inactive} Allows you to set the vKVM status to active or inac- tive. When it is active and session is in progress, a message appears on LCD. lcd status Displays the LCD status for vKVM display active or in- active and Front Panel access mode (viewandmodify, view-only or disabled). mac Displays the information about the system NICs. mac list Displays the NIC MAC address and status of all NICs. It also displays the DRAC/iDRAC MAC address. mac get <NIC number> Displays the selected NICs MAC address and status. lan Displays the information of Lan. lan set <Mode> Sets the NIC selection mode (dedicated, shared with lom1, shared with lom2,shared with lom3,shared with lom4,shared with failover lom1,shared with failover lom2,shared with failover lom3,shared with failover lom4,shared with Failover all loms, shared with Failover None). lan get Returns the current NIC selection mode (dedicated, shared with lom1, shared with lom2, shared with lom3, shared with lom4,shared with failover lom1, shared with failover lom2,shared with failover lom3,shared with failover lom4,shared with Failover all loms,shared with Failover None). lan get active Returns the current active NIC (dedicated, LOM1, LOM2, LOM3 or LOM4). powermonitor Displays power tracking statistics. powermonitor clear cumulativepower Reset cumulative power reading. powermonitor clear peakpower Reset peak power reading. powermonitor powerconsumption <watt>|<btuphr> Displays the power consumption in watt or btuphr. powermonitor powerconsumptionhistory <watt>|<btuphr> Displays the power consumption history in watt or btuphr. powermonitor getpowerbudget <watt>|<btuphr> Displays the power cap in watt or btuphr. powermonitor setpowerbudget <val><watt|btuphr|percent> Allows you to set the power cap in watt, BTU/hr or percentage. powermonitor enablepowercap Enables set power cap. powermonitor disablepowercap Disables set power cap. vFlash info Card Shows Extended SD Card information. echo For echoing lines to stdout in scripts. ekanalyzer <command> <xx=filename1> <xx=filename2> [<rc=filename3>] ... NOTE : This command can support a maximum of 8 files per command line filename1 : binary file that stores FRU data of a Carrier or an AMC module filename2 : binary file that stores FRU data of an AMC module. These binary files can be generated from command: ipmitool fru read <id> <filename> filename3 : configuration file used for configuring On-Carrier De- vice ID or OEM GUID. This file is optional. xx : indicates the type of the file. It can take the following value: oc : On-Carrier device a1 : AMC slot A1 a2 : AMC slot A2 a3 : AMC slot A3 a4 : AMC slot A4 b1 : AMC slot B1 b2 : AMC slot B2 b3 : AMC slot B3 b4 : AMC slot B4 sm : Shelf Manager The available commands for ekanalyzer are: print [<carrier | power | all>] carrier (default) <oc=filename1> <oc=filename2> ... Display point to point physical connectivity between carriers and AMC modules. Example: > ipmitool ekanalyzer print carrier oc=fru oc=car- rierfru From Carrier file: fru Number of AMC bays supported by Carrier: 2 AMC slot B1 topology: Port 0 =====> On Carrier Device ID 0, Port 16 Port 1 =====> On Carrier Device ID 0, Port 12 Port 2 =====> AMC slot B2, Port 2 AMC slot B2 topology: Port 0 =====> On Carrier Device ID 0, Port 3 Port 2 =====> AMC slot B1, Port 2 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-* From Carrier file: carrierfru On Carrier Device ID 0 topology: Port 0 =====> AMC slot B1, Port 4 Port 1 =====> AMC slot B1, Port 5 Port 2 =====> AMC slot B2, Port 6 Port 3 =====> AMC slot B2, Port 7 AMC slot B1 topology: Port 0 =====> AMC slot B2, Port 0 AMC slot B1 topology: Port 1 =====> AMC slot B2, Port 1 Number of AMC bays supported by Carrier: 2 power <xx=filename1> <xx=filename2> ... Display power supply information between carrier and AMC modules. all <xx=filename> <xx=filename> ... Display both physical connectivity and power supply of each carrier and AMC modules. frushow <xx=filename> Convert a binary FRU file into human readable text format. Use -v option to get more display information. summary [<match | unmatch | all>] match (default) <xx=filename> <xx=filename> ... Display only matched results of Ekeying match between an On-Carrier device and an AMC module or between 2 AMC modules. Example: > ipmitool ekanalyzer summary match oc=fru b1=amcB1 a2=amcA2 On-Carrier Device vs AMC slot B1 AMC slot B1 port 0 ==> On-Carrier Device 0 port 16 Matching Result - From On-Carrier Device ID 0 -Channel ID 11 || Lane 0: enable -Link Type: AMC.2 Ethernet -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link -Link Group ID: 0 || Link Asym. Match: exact match - To AMC slot B1 -Channel ID 0 || Lane 0: enable -Link Type: AMC.2 Ethernet -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link -Link Group ID: 0 || Link Asym. Match: exact match *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-* AMC slot B1 port 1 ==> On-Carrier Device 0 port 12 Matching Result - From On-Carrier Device ID 0 -Channel ID 6 || Lane 0: enable -Link Type: AMC.2 Ethernet -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link -Link Group ID: 0 || Link Asym. Match: exact match - To AMC slot B1 -Channel ID 1 || Lane 0: enable -Link Type: AMC.2 Ethernet -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link -Link Group ID: 0 || Link Asym. Match: exact match *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-* On-Carrier Device vs AMC slot A2 AMC slot A2 port 0 ==> On-Carrier Device 0 port 3 Matching Result - From On-Carrier Device ID 0 -Channel ID 9 || Lane 0: enable -Link Type: AMC.2 Ethernet -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link -Link Group ID: 0 || Link Asym. Match: exact match - To AMC slot A2 -Channel ID 0 || Lane 0: enable -Link Type: AMC.2 Ethernet -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link -Link Group ID: 0 || Link Asym. Match: exact match *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-* AMC slot B1 vs AMC slot A2 AMC slot A2 port 2 ==> AMC slot B1 port 2 Matching Result - From AMC slot B1 -Channel ID 2 || Lane 0: enable -Link Type: AMC.3 Storage -Link Type extension: Serial Attached SCSI (SAS/SATA) -Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match} - To AMC slot A2 -Channel ID 2 || Lane 0: enable -Link Type: AMC.3 Storage -Link Type extension: Serial Attached SCSI (SAS/SATA) -Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match} *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-* unmatch <xx=filename> <xx=filename> ... Display the unmatched results of Ekeying match between an On-Carrier device and an AMC module or between 2 AMC modules all <xx=filename> <xx=filename> ... Display both matched result and unmatched results of Ekeying match between two cards or two modules. event <predefined event number N> Send a pre-defined test event to the System Event Log. The following events are included as a means to test the func- tionality of the System Event Log component of the BMC (an entry will be added each time the event N command is exe- cuted). Currently supported values for N are: 1 Temperature: Upper Critical: Going High 2 Voltage Threshold: Lower Critical: Going Low 3 Memory: Correctable ECC NOTE: These pre-defined events will likely not produce "accu- rate" SEL records for a particular system because they will not be correctly tied to a valid sensor number, but they are sufficient to verify correct operation of the SEL. file <filename> Event log records specified in <filename> will be added to the System Event Log. The format of each line in the file is as follows: <{EvM Revision} {Sensor Type} {Sensor Num} {Event Dir/Type} {Event Data 0} {Event Data 1} {Event Data 2}>[# COMMENT] e.g.: 0x4 0x2 0x60 0x1 0x52 0x0 0x0 # Voltage threshold: Lower Critical: Going Low EvM Revision - The "Event Message Revision" is 0x04 for mes- sages that comply with the IPMI 2.0 Specification and 0x03 for messages that comply with the IPMI 1.0 Specification. Sensor Type - Indicates the Event Type or Class. Sensor Num - Represents the 'sensor' within the management controller that generated the Event Message. Event Dir/Type - This field is encoded with the event direc- tion as the high bit (bit 7) and the event type as the low 7 bits. Event direction is 0 for an assertion event and 1 for a deassertion event. See the IPMI 2.0 specification for further details on the de- finitions for each field. <sensorid> <list> Get a list of all the possible Sensor States and pre-defined Sensor State Shortcuts available for a particular sensor. sensorid is the character string representation of the sensor and must be enclosed in double quotes if it includes white space. Several different commands including ipmitool sensor list may be used to obtain a list that includes the sensorid strings representing the sensors on a given system. > ipmitool -I open event "PS 2T Fan Fault" list Finding sensor PS 2T Fan Fault... ok Sensor States: State Deasserted State Asserted Sensor State Shortcuts: present absent assert deassert limit nolimit fail nofail yes no on off up down <sensorid> <sensor state> [<direction>] Generate a custom event based on existing sensor information. The optional event direction can be either assert (the de- fault) or deassert. > ipmitool event "PS 2T Fan Fault" "State Asserted" Finding sensor PS 2T Fan Fault... ok 0 | Pre-Init Time-stamp | Fan PS 2T Fan Fault | State Asserted > ipmitool event "PS 2T Fan Fault" "State Deasserted" Finding sensor PS 2T Fan Fault... ok 0 | Pre-Init Time-stamp | Fan PS 2T Fan Fault | State Desserted exec <filename> Execute ipmitool commands from filename. Each line is a complete command. The syntax of the commands are defined by the COMMANDS section in this manpage. Each line may have an optional comment at the end of the line, delimited with a `#' symbol. e.g., a command file with two lines: sdr list # get a list of sdr records sel list # get a list of sel records firewall This command supports the Firmware Firewall capability. It may be used to add or remove security-based restrictions on certain com- mands/command sub-functions or to list the current firmware fire- wall restrictions set on any commands. For each firmware firewall command listed below, parameters may be included to cause the com- mand to be executed with increasing granularity on a specific LUN, for a specific NetFn, for a specific IPMI Command, and finally for a specific command's sub-function (see Appendix H in the IPMI 2.0 Specification for a listing of any sub-function numbers that may be associated with a particular command). Parameter syntax and dependencies are as follows: [<channel H>] [<lun L> [ <netfn N> [<command C [<subfn S>]]]] Note that if "netfn <N>" is specified, then "lun <L>" must also be specified; if "command <C>" is specified, then "netfn <N>" (and therefore "lun <L>") must also be specified, and so forth. "channel <H>" is an optional and standalone parameter. If not spec- ified, the requested operation will be performed on the current channel. Note that command support may vary from channel to chan- nel. Firmware firewall commands: info [<Parms as described above>] List firmware firewall information for the specified LUN, NetFn, and Command (if supplied) on the current or specified channel. Listed information includes the support, config- urable, and enabled bits for the specified command or com- mands. Some usage examples: info [<channel H>] [<lun L>] This command will list firmware firewall information for all NetFns for the specified LUN on either the current or the specified channel. info [<channel H>] [<lun L> [ <netfn N> ] This command will print out all command information for a single LUN/NetFn pair. info [<channel H>] [<lun L> [ <netfn N> [<command C] ]] This prints out detailed, human-readable information showing the support, configurable, and enabled bits for the specified command on the specified LUN/NetFn pair. Information will be printed about each of the command subfunctions. info [<channel H>] [<lun L> [ <netfn N> [<command C [<subfn S>]]]] Print out information for a specific sub-function. enable [<Parms as described above>] This command is used to enable commands for a given NetFn/LUN combination on the specified channel. disable [<Parms as described above>] [force] This command is used to disable commands for a given NetFn/LUN combination on the specified channel. Great care should be taken if using the "force" option so as not to dis- able the "Set Command Enables" command. reset [<Parms as described above>] This command may be used to reset the firmware firewall back to a state where all commands and command sub-functions are enabled. fru print Read all Field Replaceable Unit (FRU) inventory data and extract such information as serial number, part number, asset tags, and short strings describing the chassis, board, or product. read <fru id> <fru file> fru id is the digit ID of the FRU (see output of 'fru print'). fru file is the absolute pathname of a file in which to dump the binary FRU data pertaining to the specified FRU entity. write <fru id> <fru file> fru id is the digit ID of the FRU (see output of 'fru print'). fru file is the absolute pathname of a file from which to pull the binary FRU data before uploading it to the specified FRU. upgEkey <fru id> <fru file> Update a multirecord FRU location. fru id is the digit ID of the FRU (see output of 'fru print'). fru file is the ab- solute pathname of a file from which to pull the binary FRU data to upload into the specified multirecord FRU entity. edit <fru id> This command provides interactive editing of some supported records, namely PICMG Carrier Activation Record. fru id is the digit ID of the FRU (see output of 'fru print'); default is 0. edit <fru id> field <section> <index> <string> This command may be used to set a field string to a new value. It replaces the FRU data found at index in the speci- fied section with the supplied string. fru id is the digit ID of the FRU (see output of 'fru print'). <section> is a string which refers to FRU Inventory Informa- tion Storage Areas and may be refer to: c FRU Inventory Chassis Info Area b FRU Inventory Board Info Area p FRU Inventory Product Info Area <index> specifies the field number. Field numbering starts on the first 'english text' field type. For instance in the <board> info area field '0' is <Board Manufacturer> and field '2' is <Board Serial Number>; see IPMI Platform Management FRU Information Storage Definition v1.0 R1.1 for field loca- tions. <string> must be the same length as the string being replaced and must be 8-bit ASCII (0xCx). edit <fru id> oem iana <record> <format> [<args>] This command edits the data found in the multirecord area. Support for OEM specific records is limited. fwum Update IPMC using Kontron OEM Firmware Update Manager. info Show information about current firmware. status Show status of each firmware bank present in the hardware. download <filename> Download specified firmware. upgrade [filename] Install firmware upgrade. If the filename is specified, the file is downloaded first, otherwise the last firmware down- loaded is used. rollback Ask IPMC to rollback to previous version. tracelog Show firmware upgrade log. gendev list List All Generic Device Locators. read <sdr name> <file> Read to file eeprom specify by Generic Device Locators. write <sdr name> <file> Write from file eeprom specify by Generic Device Locators hpm PICMG HPM.1 Upgrade Agent check Check the target information. check <filename> Display both the existing target version and image version on the screen. download <filename> Download specified firmware. upgrade <filename> [all] [component <x>] [activate] Upgrade the firmware using a valid HPM.1 image file. If no option is specified, the firmware versions are checked first and the firmware is upgraded only if they are different. all Upgrade all components even if the firmware versions are the same (use this only after using "check" com- mand). component <x> Upgrade only given component from the given file. component 0 - BOOT component 1 - RTK activate Activate new firmware right away. activate Activate the newly uploaded firmware. targetcap Get the target upgrade capabilities. compprop <id> <select> Get the specified component properties. Valid component id: 0-7. Select can be one of following: 0 - General properties 1 - Current firmware version 2 - Description string 3 - Rollback firmware version 4 - Deferred firmware version abort Abort the on-going firmware upgrade. upgstatus Show status of the last long duration command. rollback Perform manual rollback on the IPM Controller firmware. rollbackstatus Show the rollback status. selftestresult Query the self test results. i2c <i2caddr> <read bytes> [<write data>] This command may be used to execute raw I2C commands with the Master Write-Read IPMI command. ime help Print usage information info Displays information about the Manageability Engine (ME) update <file> Upgrade the ME firmware with the specified image file WARNING You MUST use a supported image provided by your board vendor rollback Perform manual rollback of the ME firmware isol info Retrieve information about the Intel IPMI v1.5 Ser- ial-Over-LAN configuration. set <parameter> <value> Configure parameters for Intel IPMI v1.5 Serial-over-LAN. Valid parameters and values are: enabled true, false. privilege-level user, operator, admin, oem. bit-rate 9.6, 19.2, 38.4, 57.6, 115.2. activate Causes ipmitool to enter Intel IPMI v1.5 Serial Over LAN mode. An RMCP+ connection is made to the BMC, the terminal is set to raw mode, and user input is sent to the serial console on the remote server. On exit, the SOL payload mode is deac- tivated and the terminal is reset to its original settings. Special escape sequences are provided to control the SOL ses- sion: ~. Terminate connection ~^Z Suspend ipmitool ~^X Suspend ipmitool, but don't restore tty on restart ~B Send break ~~ Send the escape character by typing it twice ~? Print the supported escape sequences Note that escapes are only recognized immediately after new- line. kontronoem OEM commands specific to Kontron devices. setsn Set FRU serial number. setmfgdate Set FRU manufacturing date. nextboot <boot device> Select the next boot order on the Kontron CP6012. lan These commands will allow you to configure IPMI LAN channels with network information so they can be used with the lan and lanplus in- terfaces. NOTE: To determine on which channel the LAN interface is located, issue the `channel info number' command until you come across a valid 802.3 LAN channel. For example: > ipmitool -I open channel info 1 Channel 0x1 info: Channel Medium Type : 802.3 LAN Channel Protocol Type : IPMB-1.0 Session Support : session-based Active Session Count : 8 Protocol Vendor ID : 7154 print [<channel>] Print the current configuration for the given channel. The default will print information on the first found LAN channel. set <channel number> <command> <parameter> Set the given command and parameter on the specified channel. Valid command/parameter options are: ipaddr <x.x.x.x> Set the IP address for this channel. netmask <x.x.x.x> Set the netmask for this channel. macaddr <xx:xx:xx:xx:xx:xx> Set the MAC address for this channel. defgw ipaddr <x.x.x.x> Set the default gateway IP address. defgw macaddr <xx:xx:xx:xx:xx:xx> Set the default gateway MAC address. bakgw ipaddr <x.x.x.x> Set the backup gateway IP address. bakgw macaddr <xx:xx:xx:xx:xx:xx> Set the backup gateway MAC address. password <pass> Set the null user password. snmp <community string> Set the SNMP community string. user Enable user access mode for userid 1 (issue the `user' command to display information about userids for a given channel). access <on|off> Set LAN channel access mode. alert <on|off> Enable or disable PEF alerting for this channel. ipsrc <source> Set the IP address source: none unspecified static manually configured static IP address dhcp address obtained by BMC running DHCP bios address loaded by BIOS or system software arp respond <on|off> Set BMC generated ARP responses. arp generate <on|off> Set BMC generated gratuitous ARPs. arp interval <seconds> Set BMC generated gratuitous ARP interval. vlan id <off|id> Disable VLAN operation or enable VLAN and set the ID. ID: value of the virtual lan identifier between 1 and 4094 inclusive. vlan priority <priority> Set the priority associated with VLAN frames. ID: priority of the virtual lan frames between 0 and 7 inclusive. auth <level,...> <type,...> Set the valid authtypes for a given auth level. Levels: callback, user, operator, admin Types: none, md2, md5, password, oem cipher_privs <privlist> Correlates cipher suite numbers with the maximum priv- ilege level that is allowed to use it. In this way, cipher suites can restricted to users with a given privilege level, so that, for example, administrators are required to use a stronger cipher suite than nor- mal users. The format of privlist is as follows. Each character represents a privilege level and the character posi- tion identifies the cipher suite number. For example, the first character represents cipher suite 0, the second represents cipher suite 1, and so on. privlist must be 15 characters in length. Characters used in privlist and their associated priv- ilege levels are: X Cipher Suite Unused c CALLBACK u USER o OPERATOR a ADMIN O OEM So, to set the maximum privilege for cipher suite 0 to USER and suite 1 to ADMIN, issue the following com- mand: > ipmitool -I interface lan set channel cipher_privs uaXXXXXXXXXXXXX bad_pass_thresh <thresh_num> <1|0> <reset_interval> <lock- out_interval> Sets the Bad Password Threshold. <thresh_num> If non-zero, this value determines the number of sequential bad passwords that will be al- lowed to be entered for the identified user before the user is automatically disabled from access on the channel. <1|0> 1 = generate a Session Audit sensor "Invalid password disable" event message. 0 = do not generate an event message when the user is disabled. <reset_interval> Attempt Count Reset Interval. The in- terval, in tens of seconds, for which the accumulated count of bad password attempts is retained before be- ing automatically reset to zero. <lockout_interval> User Lockout Interval. The inter- val, in tens of seconds, that the user will remain disabled after being disabled because the Bad Password Threshold number was reached. alert print [<channel>] [<alert destination>] Print alert information for the specified channel and desti- nation. The default will print all alerts for all alert des- tinations on the first found LAN channel. alert set <channel number> <alert destination> <command> <parameter> Set an alert on the given LAN channel and destination. Alert Destinations are listed via the 'lan alert print' com- mand. Valid command/parameter options are: ipaddr <x.x.x.x> Set alert IP address. macaddr <xx:xx:xx:xx:xx:xx> Set alert MAC address. gateway <default | backup> Set the channel gateway to use for alerts. ack <on | off> Set Alert Acknowledge on or off. type <pet | oem1 | oem2> Set the destination type as PET or OEM. time <seconds> Set ack timeout or unack retry interval. retry <number> Set the number of alert retries. stats get [<channel number>] Retrieve information about the IP connections on the speci- fied channel. The default will retrieve statistics on the first found LAN channel. stats clear [<channel number>] Clear all IP/UDP/RMCP Statistics to 0 on the specified chan- nel. The default will clear statistics on the first found LAN channel. mc | bmc reset <warm|cold> Instructs the BMC to perform a warm or cold reset. guid [smbios|rfc4122|ipmi|dump] Display the Management Controller Globally Unique IDentifier. auto This is the default behavior for ipmitool(1). Try to automatically detect the encoding based on the value of the version field and (for version 1) the timestamp. The version is considered valid if it is 1 through 5, and the timestamp is valid if the year is past or equal to UNIX Epoch (1970) and is before or equal to the current year. If multiple encodings happen to have valid version fields, then precedence takes the one with version 1 and a valid timestamp. If neither one has that, then the precedence order is as follows: smbios, ipmi, rfc4122. If neither encoding yields a valid version field, then ipmitool(1) defaults to dump mode. If this option is in use, then ipmitool(1) will also print out the detected encoding and warn regarding IPMI specification violation if the encoding isn't ipmi. smbios Decode GUID as if it was sent by BMC as prescribed by SMBIOS specification. NOTE: This is a violation of IPMI specification, but many BMC implementations do it this way. If your BMC's GUID is shown correctly using this option, you may want to inform your BMC manufacturer that they have a bug. ipmi Decode GUID according to IPMI specification. It MUST show the correct GUID. If it doesn't, try other op- tions and inform your BMC manufacturer of the bug. rfc4122 or rfc Decode GUID as if it was sent by BMC as prescribed by RFC4122 specification. NOTE: This is a violation of IPMI specification. If your BMC's GUID is shown correctly using this option, you may want to inform your BMC manufacturer that they have a bug. dump Dump as hex the data received from BMC in response to Get Device GUID command. No decoding or interpreta- tion is performed. First received byte is dumped first. info Displays information about the BMC hardware, including device revision, firmware revision, IPMI version supported, manufac- turer ID, and information on additional device support. watchdog These commands allow a user to view and change the current state of the watchdog timer. get Show current Watchdog Timer settings and countdown state. reset Reset the Watchdog Timer to its most recent state and restart the countdown timer. off Turn off a currently running Watchdog countdown timer. selftest Check on the basic health of the BMC by executing the Get Self Test results command and report the results. getenables Displays a list of the currently enabled options for the BMC. setenables <option>=[on|off] Enables or disables the given option. This command is only supported over the system interface according to the IPMI specification. Currently supported values for option in- clude: recv_msg_intr Receive Message Queue Interrupt event_msg_intr Event Message Buffer Full Interrupt event_msg Event Message Buffer system_event_log System Event Logging oem0 OEM-Defined option #0 oem1 OEM-Defined option #1 oem2 OEM-Defined option #2 getsysinfo <argument> Retrieves system info from bmc for given argument. See setsysinfo for argument definitions setsysinfo <argument> <string> Stores system info string to bmc for given argument Possible arguments are: primary_os_name Primary Operating System Name os_name Operating System Name system_name System Name of Server delloem_os_version Running version of operating system delloem_URL URL of BMC Webserver chassis status Displays information regarding the high-level status of the system chassis and main power subsystem. poh This command will return the Power-On Hours counter. identify <interval> Control the front panel identify light. Default in- terval is 15 seconds. Use 0 to turn off. Use "force" to turn on indefinitely. restart_cause Query the chassis for the cause of the last system restart. selftest Check on the basic health of the BMC by executing the Get Self Test results command and report the results. policy Set the chassis power policy in the event power failure. list Return supported policies. always-on Turn on when power is restored. previous Returned to previous state when power is restored. always-off Stay off after power is restored. power Performs a chassis control command to view and change the power state. status Show current chassis power status. on Power up chassis. off Power down chassis into soft off (S4/S5 state). WARNING: This command does not initiate a clean shutdown of the operating system prior to pow- ering down the system. cycle Provides a power off interval of at least 1 second. No action should occur if chassis power is in S4/S5 state, but it is recommended to check power state first and only issue a power cycle command if the system power is on or in lower sleep state than S4/S5. reset This command will perform a hard reset. diag Pulse a diagnostic interrupt (NMI) directly to the processor(s). soft Initiate a soft-shutdown of OS via ACPI. This can be done in a number of ways, commonly by simulating an overtemperture or by simulating a power button press. It is necessary for there to be Operating System support for ACPI and some sort of daemon watching for events for this soft power to work. bootdev <device> [<clear-cmos=yes|no>] [<options=help,...>] Request the system to boot from an alternate boot de- vice on next reboot. The clear-cmos option, if sup- plied, will instruct the BIOS to clear its CMOS on the next reboot. Various options may be used to modify the boot device settings. Run "bootdev none op- tions=help" for a list of available boot device modi- fiers/options. Currently supported values for <device> are: none Do not change boot device pxe Force PXE boot disk Force boot from BIOS default boot device safe Force boot from BIOS default boot device, re- quest Safe Mode diag Force boot from diagnostic partition cdrom Force boot from CD/DVD bios Force boot into BIOS setup floppy Force boot from Floppy/primary removable media bootparam Get or set various system boot option parameters. get <param #> Get boot parameter. Currently supported values for <param #> are: 0 - Set In Progress 1 - Service Partition Selector 2 - Service Partition Scan 3 - BMC Boot Flag Valid Bit Clearing 4 - Boot Info Acknowledge 5 - Boot Flags 6 - Boot Initiator Info 7 - Boot Initiator Mailbox set <device> [<options=help,...>] Set boot device parameter used for next boot. Various options may be used to change when the the next boot device is cleared. Run "op- tions=help" for a list of available bootparam set device options. Currently supported bootparam device settings are: force_pxe Force PXE boot force_disk Force boot from default hard-drive force_safe Force boot from default hard-drive, re- quest Safe Mode force_diag Force boot from diagnostic partition force_cdrom Force boot from CD/DVD force_bios Force boot into BIOS setup Currently supported bootparam options settings are associated with BMC Boot Valid Bit Clearing and are as follows: Any option can be pre- fixed with "no-" to invert the sense of the op- eration. PEF Clear valid bit on reset/power cycle caused by PEF timeout Automatically clear boot flag valid bit if Chassis Control command is not re- ceived within 60 seconds. watchdog Clear valid bit on reset/power cycle caused by watchdog timeout reset Clear valid bit on push button reset / soft-reset power Clear valid bit on power up via power push button or wake event nm alert clear dest <dest> Clear the Node Manager Alert lan destination. get Get the Node Manager Alert settings. set chan <chan> dest <dest> string <string> Set the Node Manager alert channel, lan destination, and alert string number. capability Obtain the Node Manager power control capabilities and ranges. control enable|disable global Enable/disable all policies for all domains. per_domain <platform|CPU|Memory> Enable/disable all policies of the specified domain. per_policy <0-7> Enable/disable the policy for the specified do- main/policy combination. discover Discover Node Manager presence as well as the Node Manager version, revision, and patch number. policy add power <watts> policy_id <0-7> [correction auto|soft|hard] trig_lim <seconds> stats <seconds> [domain <platform|CPU|Memory>] enable|disable Add a new power policy, or overwrite an exist- ing policy. The correction parameter is the agressiveness of frequency limiting, default is auto. The trig_lim is the correction time limit and must be at least 6000 and not greater than 65535. The stats setting is the averaging period in seconds and ranges from 1-65535. If domain is not supplied a default of platform is used. inlet <temp> policy_id <0-7> [correction auto|soft|hard] trig_lim <seconds> stats <seconds> [domain <platform|CPU|Memory>] enable|disable Add a new inlet temp policy, or overwrite an existing policy. The correction parameter is the agressiveness of frequency limiting, de- fault is auto. The trig_lim is the correction time limit and must be at least 6000 and not greater than 65535. The stats setting is the averaging period in seconds and ranges from 1-65535. If domain is not supplied a default of platform is used. get policy_id <0-7> Get a previously stored policy. limiting Report policy number if any policy is limiting power. remove policy_id <0-7> [domain <platform|CPU|Memory>] Remove a policy. If domain is not supplied a default of platform is used. power min <minimum> max <maximum> [domain <platform|CPU|Memory>] Configure Node Manager power minimum and maximum power draw limits. The min and max values must be in the range of 0-65535. If domain is not supplied a default of platform is used. reset comm policy_id <0-7> [domain <platform|CPU|Memory>] Reset Node Manager communication statistics. If do- main is not supplied a default of platform is used. global Reset Node Manager global statistics. memory policy_id <0-7> [domain <platform|CPU|Memory>] Reset Node Manager memory throttling statistics. If domain is not supplied a default of platform is used. per_policy policy_id <0-7> [domain <platform|CPU|Memory>] Reset Node Manager per policy statistics. If domain is not supplied a default of platform is used. requests policy_id <0-7> [domain <platform|CPU|Memory>] Reset Node Manager unhandled requests statistics. If domain is not supplied a default of platform is used. response policy_id <0-7> [domain <platform|CPU|Memory>] Reset Node Manager response time statistics. If do- main is not supplied a default of platform is used. throttling policy_id <0-7> [domain <platform|CPU|Memory>] Reset Node Manager throttling statistics. If domain is not supplied a default of platform is used. statistics comm_fail Report Node Manager communication failure statistics. cpu_throttling Report Node Manager cpu throttling statistics. mem_throttling Report Node Manager memory throttling statistics. policy_power policy_id <0-7> [domain <platform|CPU|Memory>] Report Node Manager per policy power statistics (pol- icy must be a power limit type policy). If domain is not supplied a default of platform is used. policy_temps policy_id <0-7> [domain <platform|CPU|Memory>] Report Node Manager per policy temp statistics (policy must be an inlet temp limit policy). If domain is not supplied a default of platform is used. policy_throt policy_id <0-7> [domain <platform|CPU|Memory>] Report Node Manager per policy throttling statistics. If domain is not supplied a default of platform is used. requests Report Node Manager unhandled requests statistics. response Report Node Manager response time statistics. suspend get policy_id <0-7> [domain <platform|CPU|Memory>] Get Node Manager policy suspend periods. If domain is not supplied a default of platform is used. set policy_id <0-7> [domain <platform|CPU|Memory>] <start> <stop> <repeat> Set Node Manager policy suspend periods. If domain is not supplied a default of platform is used. The <start> and <stop> values must be in the range of 0-239, which is the number of minutes past midnight divided by 6. The <repeat> value is the daily recur- rence pattern. Bit 0 is repeat every Monday, bit 1 is repeat every Tuesday, on through bit 6 for Sunday. threshold get policy_id <0-7> [domain <platform|CPU|Memory>] Get Node Manager policy Alert Threshold settings. If domain is not supplied a default of platform is used. set policy_id <0-7> [domain <platform|CPU|Memory>] thresh_ar- ray Set Node Manager policy Alert Threshold values. If domain is not supplied a default of platform is used. The thresh_array is 1, 2, or 3 integers that set three alert threshold settings. The setting type is a power or temperature value which must match the type of pol- icy. pef info This command will query the BMC and print information about the PEF supported features. status This command prints the current PEF status (the last SEL en- try processed by the BMC, etc). policy This command lists the PEF policy table entries. Each policy entry describes an alert destination. A policy set is a col- lection of table entries. PEF alert actions reference policy sets. list This command lists the PEF table entries. Each PEF entry re- lates a sensor event to an action. When PEF is active, each platform event causes the BMC to scan this table for entries matching the event, and possible actions to be taken. Ac- tions are performed in priority order (higher criticality first). picmg <properties> Run a PICMG/ATA extended command. Get PICMG properties may be used to obtain and print Extension major version information, PICMG iden- tifier, FRU Device ID and Max FRU Device ID. addrinfo Get address information. This command may return information on the Hardware address, IPMB-0 Address, FRU ID, Site/Entity ID, and Site/Entity Type. frucontrol <fru id> <options> Set various control options: 0x00 - Cold Reset 0x01 - Warm Reset 0x02 - Graceful Reboot 0x03 - Issue Diagnostic Interrupt 0x04 - Quiesce [AMC only] 0x05-0xFF - Cold Reset activate <fru id> Activate the specified FRU. deactivate <fru id> Deactivate the specified FRU. policy get <fru id> Get FRU activation policy. policy set <fru id> <lockmask> <lock> Set FRU activation policy. lockmask is 1 or 0 to indicate action on the deactivation or activation locked bit respec- tively. lock is 1 or 0 to set/clear locked bit. portstate set|getall|getgranted|getdenied <parameters> Get or set various port states. See usage for parameter de- tails. power <chassis power command> Shortcut to the chassis power commands. See the chassis power com- mands for usage information. raw <netfn> <cmd> [<data>] This will allow you to execute raw IPMI commands. For example to query the POH counter with a raw command: > ipmitool -v raw 0x0 0xf RAW REQ (netfn=0x0 cmd=0xf data_len=0) RAW RSP (5 bytes) 3c 72 0c 00 00 Note that the OpenIPMI driver provided by the Linux kernel will re- ject the Get Message, Send Message and Read Event Message Buffer commands because it handles the message sequencing internally. sdr get <id> ... [<id>] Prints information for sensor data records specified by sen- sor id. info This command will query the BMC for Sensor Data Record (SDR) Repository information. type [<sensor type>] This command will display all records from the SDR Repository of a specific type. Run with type list (or simply with no type) to see the list of available types. For example to query for all Temperature sensors: > ipmitool sdr type Temperature Baseboard Temp | 30h | ok | 7.1 | 28 degrees C FntPnl Amb Temp | 32h | ok | 12.1 | 24 degrees C Processor1 Temp | 98h | ok | 3.1 | 57 degrees C Processor2 Temp | 99h | ok | 3.2 | 53 degrees C list | elist [<all|full|compact|event|mcloc|fru|generic>] This command will read the Sensor Data Records (SDR) and ex- tract sensor information of a given type, then query each sensor and print its name, reading, and status. If invoked as elist then it will also print sensor number, entity id and instance, and asserted discrete states. The default output will only display full and compact sensor types, to see all sensors use the all type with this command. Valid types are: all All SDR records (Sensor and Locator) full Full Sensor Record compact Compact Sensor Record event Event-Only Sensor Record mcloc Management Controller Locator Record fru FRU Locator Record generic Generic SDR records entity <id>[.<instance>] Displays all sensors associated with an entity. Get a list of valid entity ids on the target system by issuing the sdr elist command. A list of all entity ids can be found in the IPMI specifications. dump <file> Dumps raw SDR data to a file. This data file can then be used as a local SDR cache of the remote managed system with the -S <file> option on the ipmitool command line. This can greatly improve performance over system interface or remote LAN. fill sensors Create the SDR Repository for the current configuration. Will perform a 'Clear SDR Repository' command so be careful. fill file <filename> Fill the SDR Repository using records stored in a binary data file. Will perform a 'Clear SDR Repository' command so be careful. sel NOTE: System Event Log (SEL) entry-times are displayed as `Pre-Init Time-stamp' if the SEL clock needs to be set. Ensure that the SEL clock is accurate by invoking the sel time get and sel time set <time string> commands. info This command will query the BMC for information about the System Event Log (SEL) and its contents. clear This command will clear the contents of the SEL. It cannot be undone so be careful. list | elist When this command is invoked without arguments, the entire contents of the System Event Log are displayed. If invoked as elist (extended list) it will also use the Sensor Data Record entries to display the sensor ID for the sensor that caused each event. Note this can take a long time over the system interface. <count> | first <count> Displays the first count (least-recent) entries in the SEL. If count is zero, all entries are displayed. last <count> Displays the last count (most-recent) entries in the SEL. If count is zero, all entries are displayed. delete <SEL Record ID> ... <SEL Record ID> Delete one or more SEL event records. add <filename ID> Read event entries from a file and add them to the SEL. New SEL entries area added onto the SEL after the last record in the SEL. Record added is of type 2 and is automatically timestamped. get <SEL Record ID> Print information on the specified SEL Record entry. save <file> Save SEL records to a text file that can be fed back into the event file ipmitool command. This can be useful for testing Event generation by building an appropriate Platform Event Message file based on existing events. Please see the avail- able help for the 'event file ...' command for a description of the format of this file. writeraw <file> Save SEL records to a file in raw, binary format. This file can be fed back to the sel readraw ipmitool command for view- ing. readraw <file> Read and display SEL records from a binary file. Such a file can be created using the sel writeraw ipmitool command. time get Displays the SEL clock's current time. set <time string> Sets the SEL clock. Future SEL entries will use the time set by this command. <time string> is of the form "MM/DD/YYYY HH:MM:SS". Note that hours are in 24-hour form. It is recommended that the SEL be cleared before setting the time. sensor list Lists sensors and thresholds in a wide table format. get <id> ... [<id>] Prints information for sensors specified by name. thresh <id> <threshold> <setting> This allows you to set a particular sensor threshold value. The sensor is specified by name. Valid thresholds are: unr Upper Non-Recoverable ucr Upper Critical unc Upper Non-Critical lnc Lower Non-Critical lcr Lower Critical lnr Lower Non-Recoverable thresh <id> lower <lnr> <lcr> <lnc> This allows you to set all lower thresholds for a sensor at the same time. The sensor is specified by name and the thresholds are listed in order of Lower Non-Recoverable, Lower Critical, and Lower Non-Critical. thresh <id> upper <unc> <ucr> <unr> This allows you to set all upper thresholds for a sensor at the same time. The sensor is specified by name and the thresholds are listed in order of Upper Non-Critical, Upper Critical, and Upper Non-Recoverable. session info <active|all|id 0xnnnnnnnn|handle 0xnn> Get information about the specified session(s). You may identify sessions by their id, by their handle number, by their active status, or by using the keyword `all' to specify all sessions. set hostname <host> Session hostname. username <user> Session username. password <pass> Session password. privlvl <level> Session privilege level force. authtype <type> Authentication type force. localaddr <addr> Local IPMB address. targetaddr <addr> Remote target IPMB address. port <port> Remote RMCP port. csv [level] Enable output in comma separated format. Affects following commands: user, channel, isol, sunoem, sol, sensor, sdr, sel, session. verbose [verbose] Verbosity level. shell This command will launch an interactive shell which you can use to send multiple ipmitool commands to a BMC and see the responses. This can be useful instead of running the full ipmitool command each time. Some commands will make use of a Sensor Data Record cache and you will see marked improvement in speed if these commands are able to reuse the same cache in a shell session. LAN sessions will send a periodic keepalive command to keep the IPMI session from timing out. sol info [<channel number>] Retrieve information about the Serial-Over-LAN configuration on the specified channel. If no channel is given, it will display SOL configuration data for the currently used chan- nel. payload <enable | disable | status> <channel number> <userid> Enable, disable or show status of SOL payload for the user on the specified channel. set <parameter> <value> [<channel>] Configure parameters for Serial Over Lan. If no channel is given, it will display SOL configuration data for the cur- rently used channel. Configuration parameter updates are au- tomatically guarded with the updates to the set-in-progress parameter. Valid parameters and values are: set-in-progress set-complete set-in-progress commit-write enabled true false force-encryption true false force-authentication true false privilege-level user operator admin oem character-accumulate-level Decimal number given in 5 milliseconds increments character-send-threshold Decimal number retry-count Decimal number. 0 indicates no retries after packet is transmitted. retry-interval Decimal number in 10 millisecond increments. 0 indi- cates that retries should be sent back to back. non-volatile-bit-rate serial, 19.2, 38.4, 57.6, 115.2. Setting this value to serial indicates that the BMC should use the set- ting used by the IPMI over serial channel. volatile-bit-rate serial, 19.2, 38.4, 57.6, 115.2. Setting this value to serial indicates that the BMC should use the set- ting used by the IPMI over serial channel. activate [usesolkeepalive | nokeepalive] [instance=<number>] Causes ipmitool to enter Serial Over LAN mode, and is only available when using the lanplus interface. An RMCP+ connec- tion is made to the BMC, the terminal is set to raw mode, and user input is sent to the serial console on the remote server. On exit, the the SOL payload mode is deactivated and the terminal is reset to its original settings. If the instance is given, it will activate using the given instance number. The default is 1. Special escape sequences are provided to control the SOL ses- sion: ~. Terminate connection ~^Z Suspend ipmitool ~^X Suspend ipmitool, but don't restore tty on restart ~B Send break ~~ Send the escape character by typing it twice ~? Print the supported escape sequences Note that escapes are only recognized immediately after new- line. deactivate [instance=<number>] Deactivates Serial Over LAN mode on the BMC. Exiting Serial Over LAN mode should automatically cause this command to be sent to the BMC, but in the case of an unintentional exit from SOL mode, this command may be necessary to reset the state of the BMC. If the instance is given, it will deactivate the given in- stance number. The default is 1. spd <i2cbus> <i2caddr> [<channel>] [<axread>] This command may be used to read SPD (Serial Presence Detect) data using the I2C Master Write-Read IPMI command. sunoem cli [<command string> ...] Execute the service processor command line interface com- mands. Without any command string, an interactive session is started in the service processor command line environment. If a command string is specified, the command string is exe- cuted on the service processor and the connection is closed. led These commands provide a way to get and set the status of LEDs on a Sun Microsystems server. Use 'sdr list generic' to get a list of devices that are controllable LEDs. The led- type parameter is optional and not necessary to provide on the command line unless it is required by hardware. get <sensorid> [<ledtype>] Get status of a particular LED described by a Generic Device Locator record in the SDR. A sensorid of all will get the status of all available LEDS. set <sensorid> <ledmode> [<ledtype>] Set status of a particular LED described by a Generic Device Locator record in the SDR. A sensorid of all will set the status of all available LEDS to the spec- ified ledmode and ledtype. LED Mode is required for set operations: OFF Off ON Steady On STANDBY 100ms on 2900ms off blink rate SLOW 1HZ blink rate FAST 4HZ blink rate LED Type is optional: OK2RM Ok to Remove SERVICE Service Required ACT Activity LOCATE Locate nacname <ipmi name> Return the full NAC name of a target identified by ipmi name. ping <count> [<q>] Send and receive count packets. Each packet is 64 bytes. q - Quiet. Displays output only at the start and end of the process. getval <property name> Returns value of specified ILOM property. setval <property name> <property value> [<timeout>] Sets value of ILOM property. If timeout is not specified, the default value is 5 seconds. NOTE: setval must be executed locally on host! sshkey set <userid> <keyfile> This command will allow you to specify an SSH key to use for a particular user on the Service Processor. This key will be used for CLI logins to the SP and not for IPMI sessions. View available users and their userids with the 'user list' command. del <userid> This command will delete the SSH key for a specified userid. version Display the version of ILOM firmware. getfile <file identifier> <destination file name> This command will return various files from service processor and store them in specified destination file. Note that some files may not be present or be supported by your SP. File identifiers: SSH_PUBKEYS DIAG_PASSED DIAG_FAILED DIAG_END_TIME DIAG_INVENTORY DIAG_TEST_LOG DIAG_START_TIME DIAG_UEFI_LOG DIAG_TEST_LOG DIAG_LAST_LOG DIAG_LAST_CMD getbehavior <feature identifier> This command will test if various ILOM features are enabled. Feature identifiers: SUPPORTS_SIGNED_PACKAGES REQUIRES_SIGNED_PACKAGES tsol This command allows Serial-over-LAN sessions to be established with Tyan IPMIv1.5 SMDC such as the M3289 or M3290. The default command run with no arguments will establish default SOL session back to lo- cal IP address. Optional arguments may be supplied in any order. <ipaddr> Send receiver IP address to SMDC which it will use to send serial traffic to. By default this detects the local IP ad- dress and establishes two-way session. Format of ipaddr is XX.XX.XX.XX port=NUM Configure UDP port to receive serial traffic on. By default this is 6230. ro|rw Confiure SOL session as read-only or read-write. Sessions are read-write by default. user summary Displays a summary of userid information, including maximum number of userids, the number of enabled users, and the num- ber of fixed names defined. list Displays a list of user information for all defined userids. set name <userid> <username> Sets the username associated with the given userid. password <userid> [<password> [<16|20>]] Sets the password for the given userid. If no pass- word is given, the password is cleared (set to the NULL password). Be careful when removing passwords from administrator-level accounts. If specified, 16 or 20 determines the maximum password length. disable <userid> Disables access to the BMC by the given userid. enable <userid> Enables access to the BMC by the given userid. priv <userid> <privilege level> [<channel number>] Set user privilege level on the specified channel. If the channel is not specified, the current channel will be used. test <userid> <16|20> [<password>] Determine whether a password has been stored as 16 or 20 bytes. OPEN INTERFACE The ipmitool open interface utilizes the OpenIPMI kernel device driver. This driver is present in all modern 2.4 and all 2.6 kernels and it should be present in recent Linux distribution kernels. There are also IPMI dri- ver kernel patches for different kernel versions available from the OpenIPMI homepage. The required kernel modules is different for 2.4 and 2.6 kernels. The fol- lowing kernel modules must be loaded on a 2.4-based kernel in order for ip- mitool to work: ipmi_msghandler Incoming and outgoing message handler for IPMI interfaces. ipmi_kcs_drv An IPMI Keyboard Controller Style (KCS) interface driver for the message handler. ipmi_devintf Linux character device interface for the message handler. The following kernel modules must be loaded on a 2.6-based kernel in order for ipmitool to work: ipmi_msghandler Incoming and outgoing message handler for IPMI interfaces. ipmi_si An IPMI system interface driver for the message handler. This mod- ule supports various IPMI system interfaces such as KCS, BT, SMIC, and even SMBus in 2.6 kernels. ipmi_devintf Linux character device interface for the message handler. Once the required modules are loaded there will be a dynamic character de- vice entry that must exist at /dev/ipmi0. For systems that use devfs or udev this will appear at /dev/ipmi/0. To create the device node first determine what dynamic major number it was assigned by the kernel by looking in /proc/devices and checking for the ip- midev entry. Usually if this is the first dynamic device it will be major number 254 and the minor number for the first system interface is 0 so you would create the device entry with: mknod /dev/ipmi0 c 254 0 ipmitool includes some sample initialization scripts that can perform this task automatically at start-up. In order to have ipmitool use the OpenIPMI device interface you can specify it on the command line: > ipmitool -I open <command> BMC INTERFACE The ipmitool bmc interface utilizes the bmc device driver as provided by Solaris 10 and higher. In order to force ipmitool to make use of this in- terface you can specify it on the command line: > ipmitool -I bmc <command> The following files are associated with the bmc driver: /platform/i86pc/kernel/drv/bmc 32-bit ELF kernel module for the bmc driver. /platform/i86pc/kernel/drv/amd64/bmc 64-bit ELF kernel module for the bmc driver. /dev/bmc Character device node used to communicate with the bmc driver. LIPMI INTERFACE The ipmitool lipmi interface uses the Solaris 9 IPMI kernel device driver. It has been superceeded by the bmc interface on Solaris 10. You can tell ipmitool to use this interface by specifying it on the command line. > ipmitool -I lipmi <expression> LAN INTERFACE The ipmitool lan interface communicates with the BMC over an Ethernet LAN connection using UDP under IPv4. UDP datagrams are formatted to contain IPMI request/response messages with a IPMI session headers and RMCP head- ers. IPMI-over-LAN uses version 1 of the Remote Management Control Protocol (RMCP) to support pre-OS and OS-absent management. RMCP is a request-re- sponse protocol delivered using UDP datagrams to port 623. The LAN interface is an authentication multi-session connection; messages delivered to the BMC can (and should) be authenticated with a challenge/re- sponse protocol with either straight password/key or MD5 message-digest al- gorithm. ipmitool will attempt to connect with administrator privilege level as this is required to perform chassis power functions. You can tell ipmitool to use the lan interface with the -I lan option: > ipmitool -I lan -H <hostname> [-U <username>] [-P <password>] <command> A hostname must be given on the command line in order to use the lan inter- face with ipmitool. The password field is optional; if you do not provide a password on the command line, ipmitool will attempt to connect without au- thentication. If you specify a password it will use MD5 authentication if supported by the BMC and straight password/key otherwise, unless overridden with a command line option. LANPLUS INTERFACE Like the lan interface, the lanplus interface communicates with the BMC over an Ethernet LAN connection using UDP under IPv4. The difference is that the lanplus interface uses the RMCP+ protocol as described in the IPMI v2.0 specification. RMCP+ allows for improved authentication and data in- tegrity checks, as well as encryption and the ability to carry multiple types of payloads. Generic Serial Over LAN support requires RMCP+, so the ipmitool sol activate command requires the use of the lanplus interface. RMCP+ session establishment uses a symmetric challenge-response protocol called RAKP (Remote Authenticated Key-Exchange Protocol) which allows the negotiation of many options. ipmitool does not yet allow the user to spec- ify the value of every option, defaulting to the most obvious settings marked as required in the v2.0 specification. Authentication and integrity HMACS are produced with SHA1, and encryption is performed with AES-CBC-128. Role-level logins are not yet supported. ipmitool must be linked with the OpenSSL library in order to perform the encryption functions and support the lanplus interface. If the required packages are not found it will not be compiled in and supported. You can tell ipmitool to use the lanplus interface with the -I lanplus op- tion: > ipmitool -I lanplus -H <hostname> [-U <username>] [-P <password>] <com- mand> A hostname must be given on the command line in order to use the lan inter- face with ipmitool. With the exception of the -A and -C options the rest of the command line options are identical to those available for the lan in- terface. The -C option allows you specify the authentication, integrity, and encryp- tion algorithms to use for for lanplus session based on the cipher suite ID found in the IPMIv2.0 specification in table 22-20. The default cipher suite is 17 which specifies RAKP-HMAC-SHA256 authentication, HMAC-SHA256-128 integrity, and AES-CBC-128 encryption algorightms. FREE INTERFACE The ipmitool free interface utilizes the FreeIPMI libfreeipmi drivers. You can tell ipmitool to use the FreeIPMI interface with the -I option: > ipmitool -I free <command> IMB INTERFACE The ipmitool imb interface supports the Intel IMB (Intel Inter-module Bus) Interface through the /dev/imb device. You can tell ipmitool to use the IMB interface with the -I option: > ipmitool -I imb <command> EXAMPLES Example 1: Listing remote sensors > ipmitool -I lan -H 1.2.3.4 -f passfile sdr list Baseboard 1.25V | 1.24 Volts | ok Baseboard 2.5V | 2.49 Volts | ok Baseboard 3.3V | 3.32 Volts | ok Example 2: Displaying status of a remote sensor > ipmitool -I lan -H 1.2.3.4 -f passfile sensor get "Baseboard 1.25V" Locating sensor record... Sensor ID : Baseboard 1.25V (0x10) Sensor Type (Analog) : Voltage Sensor Reading : 1.245 (+/- 0.039) Volts Status : ok Lower Non-Recoverable : na Lower Critical : 1.078 Lower Non-Critical : 1.107 Upper Non-Critical : 1.382 Upper Critical : 1.431 Upper Non-Recoverable : na Example 3: Displaying the power status of a remote chassis > ipmitool -I lan -H 1.2.3.4 -f passfile chassis power status Chassis Power is on Example 4: Controlling the power on a remote chassis > ipmitool -I lan -H 1.2.3.4 -f passfile chassis power on Chassis Power Control: Up/On FILES /usr/local/share/ipmitool/enterprise-numbers system IANA PEN registry taken from http://www.iana.org/assign- ments/enterprise-numbers ~/.local/usr/share/misc/enterprise-numbers user's override for the system IANA PEN registry, this file if it exists is loaded instead of the system registry (see above). AUTHORS Originally written by Duncan Laurie <duncan@iceblink.org>. Numerous contributors over time. BUGS Any bugs found in ipmitool please report via GitHub issue system at https://github.com/ipmitool/ipmitool/issues SEE ALSO IPMItool Homepage http://github.com/ipmitool/ipmitool Intelligent Platform Management Interface Specification http://www.intel.com/design/servers/ipmi OpenIPMI Homepage http://openipmi.sourceforge.net FreeIPMI Homepage http://www.gnu.org/software/freeipmi/ Duncan Laurie ipmitool(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SECURITY | COMMANDS | OPEN INTERFACE | BMC INTERFACE | LIPMI INTERFACE | LAN INTERFACE | LANPLUS INTERFACE | FREE INTERFACE | IMB INTERFACE | EXAMPLES | FILES | AUTHORS | BUGS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ipmitool&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>