ipmievd(8) - phpMan

Command: man perldoc info search(apropos)  


ipmievd(8)                                                                             ipmievd(8)

NAME
       ipmievd - IPMI event daemon for sending events to syslog

SYNOPSIS
       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>]

DESCRIPTION
       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 ker-
       nel 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 in-
       terfaces.

OPTIONS
       -a     Prompt for the remote server password.

       -A <authtype>
              Specify an authentication type to use during IPMIv1.5 lan session activation.  Sup-
              ported 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  de-
              fault  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 visi-
              ble 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 list-
              ings.  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 op-
              tion is not recommended.

       -S <sdr_cache_file>
              Use local file for remote SDR cache.  Using a local SDR cache can  drastically  in-
              crease 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 in-
              crease 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.

COMMANDS
       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 in-
              formation 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  /var/run/ip-
                     mievd.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 /var/run/ip-
                     mievd.pidN (where N is the ipmi device number -- defaults to 0).

              timeout=<seconds>
                     Time between checks for SEL polling method.  Default is 10 seconds.

EXAMPLES
       Example 1: Daemon process watching OpenIPMI for events

              > ipmievd -I open open daemon

       Example 2: 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...

AUTHOR
       Duncan Laurie <duncan AT iceblink.org>

SEE ALSO
       IPMItool Homepage
              http://ipmitool.sourceforge.net

       Intelligent Platform Management Interface Specification
              http://www.intel.com/design/servers/ipmi

       OpenIPMI Homepage
              http://openipmi.sourceforge.net

Duncan Laurie                                                                          ipmievd(8)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-11-03 07:34 @100.28.231.85 CrawledBy CCBot/2.0 (https://commoncrawl.org/faq/)
Valid XHTML 1.0!Valid CSS!