Provided by: ipmiutil_2.9.7-1_i386 bug

NAME

       ipmiutil_alarms - display and set alarm indicators

SYNOPSIS

       ipmiutil alarms [-abcdimnoprx -N node -U user -P/-R pswd -EFJTVY]

DESCRIPTION

       ipmiutil alarms is a program that uses IPMI commands to display and set
       alarm indicators, which are usually LEDs on the  system  chassis  front
       panel.   This  utility  can  use  either  the  /dev/ipmi0  driver  from
       OpenIPMI, the /dev/imb driver from Intel, the /dev/ipmikcs driver  from
       valinux,  direct user-space IOs, or the IPMI LAN interface if -N.  Note
       that a LAN user must have Administrative privileges to  read  or  write
       the alarm LEDs.

       Note  that this utility may not be the only logic setting alarm states.
       The BMC firmware, system management software, or cluster fault  manager
       may  also  want  to  set  alarm  states.  Intel provides a Telco Alarms
       Manager API which presents  a  consolidated  interface  for  all  alarm
       management applications.

OPTIONS

       Command line options are described below.

       -r     Read-only.   Show  the alarms status, but do not set any states.
              This is also the default mode if no parameters are specified.

       -iN    Sets the Chassis Identify feature, which can be an LED  or  some
              other  alarm.   If  N=0, turn off the Chassis ID, otherwise turn
              the  ID  on  for  N  seconds.   N=255  will  turn  on   the   ID
              indefinitely, if it is IPMI 2.0.

       -aN    Sets  Disk  A  Fault LED.  If N=0, turn it off.  If N=1, turn it
              on.  Used only for TIGPT1U platform.

       -bN    Sets Disk B Fault LED.  If N=0, turn it off.  If  N=1,  turn  it
              on.  Used only for TIGPT1U platform.

       -dXN   Sets  Disk  X  Fault LED, where X=0-6.  If N=0, turn it off.  If
              N=1, turn it on.  Used only for NSC2U platform.

       -cN    Sets the Critical Alarm.  If N=0, turn it off.  If N=1, turn  it
              on.

       -mN    Sets the Major Alarm.  If N=0, turn it off.  If N=1, turn it on.

       -nN    Sets the Minor Alarm.  If N=0, turn it off.  If N=1, turn it on.

       -pN    Sets the Power Alarm.  If N=0, turn it off.  If N=1, turn it on.
              Note that the Power LED is also wired to the System Fault LED in
              the  back of the system, so this state may be off for Power, but
              the LED could be lit for a System Fault reason  instead.   Refer
              to the system Technical Product Specification for System Faults.

       -o     Sets all alarms off, including the Chassis ID.

       -x     Causes extra debug messages to be displayed.

       -N nodename
              Nodename  or  IP  address  of  the  remote  target system.  If a
              nodename is specified, IPMI LAN interface  is  used.   Otherwise
              the local system management interface is used.

       -P/-R rmt_pswd
              Remote  password  for the nodename given.  The default is a null
              password.

       -U rmt_user
              Remote username for the nodename given.  The default is  a  null
              username.

       -E     Use the remote password from Environment variable IPMI_PASSWORD.

       -F drv_t
              Force  the  driver  type  to one of the followng: imb, va, open,
              gnu, landesk, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
              lan2  with  intelplus.   The  default is to detect any available
              driver type and use it.

       -J     Use  the  specified  LanPlus   cipher   suite   (0   thru   17):
              0=none/none/none,       1=sha1/none/none,      2=sha1/sha1/none,
              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.

       -T     Use  this  IPMI  LAN  Authentication Type: 0=None, 1=MD2, 2=MD5,
              4=Straight Password, 5=OEM.

       -V     Use this IPMI LAN  privilege  level.  1=Callback  level,  2=User
              level,  3=Operator level, 4=Administrator level (default), 5=OEM
              level.

       -Y     Yes, do prompt the  user  for  the  IPMI  LAN  remote  password.
              Alternatives for the password are -E or -P.

SEE ALSO

       ipmiutil(8)   iconfig(8)   icmd(8)   idiscover(8)   ievents(8)  ifru(8)
       igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8)
       isol(8) iwdt(8)

WARNINGS

       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
       and any bug fix list.

COPYRIGHT

       Copyright (C) 2009  Kontron America, Inc.

       See the file COPYING in the distribution  for  more  details  regarding
       redistribution.

       This  utility  is  distributed  in the hope that it will be useful, but
       WITHOUT ANY WARRANTY.

AUTHOR

       Andy Cress <arcress at users.sourceforge.net>

                           Version 1.3: 20 Apr 2007                 IALARMS(8)