ipmievd(8)ipmievd(8)NAMEipmievd - IPMI event daemon for sending events to syslog
SYNOPSISipmievd [-chvV] -I lan -H hostname [ -p <port>] [-U <username>] [ -f
<password_file>] [-S <sdrcache>] sel [<option>]
ipmievd [-chvV] -I lanplus -H hostname [-p <port>] [-U <username>] [-f
<password_file>] [-S <sdrcache>] sel [<option>]
ipmievd [-chvV] -I bmc [-S <sdrcache>] 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-c Present output in comma separated variable (CSV) format.
-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
-p port
Remote server UDP port to connect to (default is 623).
-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.
-U username
Remote server username; default is NULL user.
-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 bmc 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...
FILES
/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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬──────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼──────────────────────┤
│Architecture │ i386, amd64 │
├────────────────────┼──────────────────────┤
│Availability │ system/ipmi/ipmitool │
├────────────────────┼──────────────────────┤
│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.
Source for ipmievd is available on http://opensolaris.org.
29 November 2006 ipmievd(8)
