ipmievd(8)ipmievd(8)NAMEipmievd - IPMI event daemon for sending events to syslog
SYNOPSISipmievd [-c|-h|-d N|-v|-V] -I open <open | sel> [<option>]
Note: Use -I open on linux, use -I bmc on solaris
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>]
DESCRIPTIONipmievd is a daemon that listens for events from the Baseboard Manage‐
ment Controller (BMC) which are being sent to the System Event Log
(SEL), and logs those messages to syslog. The daemon actively polls the
contents of the SEL for new events. When an event is received, it is
logged to syslog using the LOG_LOCAL4 facility. On Solaris, it has
been made to use LOG_DAEMON instead, so that no changes to /etc/sys‐
log.conf are necessary.
ipmievd is based on the ipmitool utility and it shares the same Intel‐
ligent Platform Management Interface (IPMI) support and session setup
options. The ipmitool man page provides more information on supported
IPMI interfaces.
OPTIONS-a Prompt for the remote server password.
-A <authtype>
Specify an authentication type to use during IPMIv1.5 lan ses‐
sion activation. Supported types are NONE, PASSWORD, MD2, MD5,
or OEM.
-c Present output in comma separated variable (CSV) format.
-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 spec‐
ifies RAKP-HMAC-SHA1 authentication, HMAC-SHA1-96 integrity, and
AES-CBC-128 encryption algorightms.
-E The remote server password is specified by the environment vari‐
able IPMI_PASSWORD.
-f password_file
Specify a file containing the remote server password. If this
option is absent, or if password_file is empty, the password
will default to NULL.
If the -f option is not present, ipmitool will prompt the user
for a password. If no password is entered at the prompt, the
remote server password will default to NULL.
For IPMI v1.5, the maximum password length is 16 characters.
Passwords longer than 16 characters will be truncated.
For IPMI v2.0, the maximum password length is 20 characters.
Passwords longer than 20 characters will be truncated. The
longer password length is supported by the lanplus interface.
-h Get basic usage help from the command line.
-H hostname
Remote server address, which can be an IP address or hostname.
This option is required for the LAN interface connection.
-I interface
Selects IPMI interface to use. Possible interfaces are:
bmc IPMI v2.0 BMC interface [default]
lan IPMI v1.5 LAN Interface
lanplus IPMI v2.0 RMCP
-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! Speci‐
fying the password as a command line option is not recommended.
-S sdrcache
Use local file for remote Sensor Data Repository (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 can 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.
COMMANDS
help This can be used to get command-line help. It can also be
placed at the end of commands to get option usage help.
> ipmievd help
Commands:
sel Poll SEL for notification of events
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 moni‐
tor 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 /var/run/ipmievd.pid.
timeout=seconds
Time between checks for SEL polling method. Default is
10 seconds.
EXIT STATUS
Upon successful completion, ipmievd returns 0. On failure, 1 is
returned.
EXAMPLE
Local non-daemon process checking remote SEL every 30 seconds:
> ipmievd-I lan -H 1.2.3.4 -f passfile sel nodaemon timeout=30
Reading Sensors...
Waiting for Events...
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Availability │ SUNWipmi │
├────────────────────┼─────────────────┤
│Interface Stability │ Volatile │
└────────────────────┴─────────────────┘
SEE ALSOattributes(5), ipmitool(1M), smf(5), svcadm(1M), svccfg(1M), svcs(1)
IPMItool Homepage
http://ipmitool.sourceforge.net
Intelligent Platform Management Interface Specification
http://www.intel.com/design/servers/ipmi/spec.htm
OpenIPMI Homepage
http://openipmi.sourceforge.net
NOTES
The ipmievd daemon is managed by the service management facility,
smf(5), under the service identifier: svc:/network/ipmievd:default.
Administrative actions on this service, such as enabling or disabling,
can be performed using svcadm(1M). Use svccfg(1M) to make configuration
changes and svcs(1) to view configuration information and service sta‐
tus.
29 June 2012 ipmievd(8)