Maintenance Procedures ipmievd(8) NAME ipmievd - IPMI event daemon for sending events to syslog SYNOPSIS ipmievd [-chvV] -I lan -H hostname [ -p ] [-U ] [ -f ] [-S ] sel [] ipmievd [-chvV] -I lanplus -H hostname [-p ] [-U ] [-f ] [-S ] sel [] ipmievd [-chvV] -I bmc [-S ] sel [] DESCRIPTION ipmievd is a daemon that listens for events from the Base- board Management Controller (BMC) which are being sent to the System Event Log (SEL), and logs those messages to sys- log. The daemon actively polls the contents of the SEL for new events. When an event is received, it is logged to sys- log using the LOGLOCAL4 facility. On Solaris, it has been made to use LOGDAEMON instead, so that no changes to /etc/syslog.conf are necessary. ipmievd is based on the ipmitool utility and it shares the same Intelligent Platform Management Interface (IPMI) sup- port and session setup options. The ipmitool man page pro- vides more information on supported IPMI interfaces. OPTIONS -c Present output in comma separated variable (CSV) for- mat. -f passwordfile Specify a file containing the remote server password. If this option is absent, or if passwordfile is empty, the password will default to NUL. 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 NUL. For IPMI v1.5, the maximum password length is 16 char- acters. Passwords longer than 16 characters will be truncated. For IPMI v2.0, the maximum password length is 20 char- acters. Passwords longer than 20 characters will be truncated. The longer password length is supported by the lanplus interface. SunOS 5.10 Last change: 29 November 2006 1 Maintenance Procedures ipmievd(8) -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 inter- face 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 NUL 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. COMANDS 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 periodi- cally 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. SunOS 5.10 Last change: 29 November 2006 2 Maintenance Procedures ipmievd(8) 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. ATRIBUTES See attributes(5) for descriptions of the following attri- butes: SunOS 5.10 Last change: 29 November 2006 3 Maintenance Procedures ipmievd(8) ATRIBUTE TYPE ATRIBUTE VALUE Architecture i386, amd64 Availability SUNWipmi Interface Stability Volatile SEE ALSO attributes(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 configura- tion information and service status. Source for ipmievd is available on http:/opensolaris.org. SunOS 5.10 Last change: 29 November 2006 4
