ipmievd - IPMI event daemon for sending events to syslog
ipmievd [-c|-h|-d
N|-v|-V] -I open
<open | sel> [<option>]
ipmievd [-c|-h|-v|-V] -I
lan -H <hostname>
[-p <port>]
[-U <username>]
[-A <authtype>]
[-L <privlvl>]
[-a|-E|-P|-f <password>]
[-o <oemtype>]
[-O <sel oem>]
sel [<option>]
ipmievd [-c|-h|-v|-V] -I
lanplus -H <hostname>
[-p <port>]
[-U <username>]
[-L <privlvl>]
[-a|-E|-P|-f <password>]
[-o <oemtype>]
[-O <sel oem>]
[-C <ciphersuite>]
sel [<option>]
ipmievd is a daemon which will listen for events from the
BMC that are being sent to the SEL and also log those messages to syslog. It
is able to run in one of two modes: either using the Event Message Buffer
and asynchronous event notification from the OpenIPMI kernel driver or
actively polling the contents of the SEL for new events. Upon receipt of an
event via either mechanism it will be logged to syslog with the
LOG_LOCAL4 facility.
It is based on the ipmitool utility and shares the same
IPMI interface support and session setup options. Please see the
ipmitool manpage for more information on supported IPMI
interfaces.
- -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.
- -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 algorithms to
use for IPMIv2 lanplus connections. See table 22-19 in the IPMIv2
specification. The default is 3 which specifies RAKP-HMAC-SHA1
authentication, HMAC-SHA1-96 integrity, and AES-CBC-128 encryption
algorithms.
- -E
- The remote server password is specified by the environment variable
IPMI_PASSWORD.
- -f
<password_file>
- Specifies a file containing the remote server password. If this option is
absent, or if password_file is empty, the password will default to
NULL.
- -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 compiled in
are visible in the usage help output.
- -L
<privlvl>
- Force session privilege level. Can be CALLBACK, USER, OPERATOR, ADMIN.
Default is ADMIN.
- -m
<local_address>
- Set the local IPMB address. The default is 0x20 and there should be no
need to change it for normal operation.
- -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 supported it
will be obscured in the process list. Note! Specifying the password
as a command line option is not recommended.
- -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.
- -t
<target_address>
- Bridge IPMI requests to the remote target address.
- -U
<username>
- Remote server username, default is NULL user.
- -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.
- -v
- Increase verbose output level. This option may be specified multiple times
to increase the level of debug output. If given three times you will get
hexdumps of all incoming and outgoing packets.
- -V
- Display version information.
If no password method is specified then ipmievd will prompt the
user for a password. If no password is entered at the prompt, the remote
server password will default to NULL.
- help
- This can be used to get command-line help. It may also be placed at the
end of commands to get option usage help.
> ipmievd help
Commands:
open Use OpenIPMI for asynchronous notification of events
sel Poll SEL for notification of events
- open
- This command starts ipmievd with the OpenIPMI event watching mechanism
which relies on the Event Message Buffer feature of IPMI. This requires a
properly installed and configured OpenIPMI driver on Linux and is only
valid to be run through the open interface. See the ipmitool
manpage and associated documentation for more information on setting up
the OpenIPMI driver.
Note: Some BMC do not support the Event Message Buffer
required for this command. Other BMCs claim to support it but do not
actually deliver events to it. If this is the case please use the
sel method.
- daemon
- Launch process as a daemon and reparent to init process. All messages will
be sent to syslog. This is the default action.
- nodaemon
- Do NOT become a daemon, instead log all messages to stderr.
- pidfile=<filename>
- Save process ID to this file when in daemon mode. Defaults to
/run/ipmievd.pidN (where N is the ipmi device number --
defaults to 0).
- sel
- This command starts ipmievd with the SEL Polling event watching mechanism.
This will poll the SEL periodically to determine if new events have been
logged. This command should work with all BMCs and is capable of using the
LAN interface as well to monitor a remote system and log its events to a
local syslog.
- daemon
- Launch process as a daemon and reparent to init process. All messages will
be sent to syslog. This is the default action.
- nodaemon
- Do NOT become a daemon, instead log all messages to stderr.
- pidfile=<filename>
- Save process ID to this file when in daemon mode. Defaults to
/run/ipmievd.pidN (where N is the ipmi device number --
defaults to 0).
- timeout=<seconds>
- Time between checks for SEL polling method. Default is 10 seconds.
- /usr/share/misc/enterprise-numbers.txt
- system IANA PEN registry taken from
https://www.iana.org/assignments/enterprise-numbers.txt
- ~/.local/usr/share/misc/enterprise-numbers.txt
- user's override for the system IANA PEN registry, this file if it exists
is loaded instead of the system registry (see above).
Duncan Laurie <duncan@iceblink.org>