1IALARMS(8)                  System Manager's Manual                 IALARMS(8)
2
3
4

NAME

6       ipmiutil alarms - display and set alarm indicators
7

SYNOPSIS

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

DESCRIPTION

13       ipmiutil alarms is a program that uses IPMI commands to display and set
14       alarm indicators, which are usually LEDs on the  system  chassis  front
15       panel.   This  utility  can  use  either  the  /dev/ipmi0  driver  from
16       OpenIPMI, the /dev/imb driver from Intel, the /dev/ipmikcs driver  from
17       valinux,  direct user-space IOs, or the IPMI LAN interface if -N.  Note
18       that a LAN user must have Administrative privileges to  read  or  write
19       the alarm LEDs.
20
21       Note  that this utility may not be the only logic setting alarm states.
22       The BMC firmware, system management software, or cluster fault  manager
23       may  also want to set alarm states.  Intel provides a Telco Alarms Man‐
24       ager API which presents a consolidated interface for all alarm  manage‐
25       ment applications.
26
27

OPTIONS

29       Command line options are described below.
30
31       -r     Read-only.   Show  the alarms status, but do not set any states.
32              This is also the default mode if no parameters are specified.
33
34       -iN    Sets the Chassis Identify feature, which can be an LED  or  some
35              other  alarm.   If  N=0, turn off the Chassis ID, otherwise turn
36              the ID on for N seconds.  N=255 will  turn  on  the  ID  indefi‐
37              nitely, if it is IPMI 2.0.
38
39       -aN    Sets  Disk  A  Fault LED.  If N=0, turn it off.  If N=1, turn it
40              on.  Used only for TIGPT1U platform.
41
42       -bN    Sets Disk B Fault LED.  If N=0, turn it off.  If  N=1,  turn  it
43              on.  Used only for TIGPT1U platform.
44
45       -dXN   Sets  Disk  X  Fault LED, where X=0-6.  If N=0, turn it off.  If
46              N=1, turn it on.  Used only for NSC2U platform.
47
48       -cN    Sets the Critical Alarm.  If N=0, turn it off.  If N=1, turn  it
49              on.
50
51       -mN    Sets the Major Alarm.  If N=0, turn it off.  If N=1, turn it on.
52
53       -nN    Sets the Minor Alarm.  If N=0, turn it off.  If N=1, turn it on.
54
55       -pN    Sets the Power Alarm.  If N=0, turn it off.  If N=1, turn it on.
56              Note that the Power LED is also wired to the System Fault LED in
57              the  back of the system, so this state may be off for Power, but
58              the LED could be lit for a System Fault reason  instead.   Refer
59              to the system Technical Product Specification for System Faults.
60
61       -o     Sets all alarms off, including the Chassis ID.
62
63       -x     Causes extra debug messages to be displayed.
64
65
66       -N nodename
67              Nodename  or IP address of the remote target system.  If a node‐
68              name is specified, IPMI LAN interface is  used.   Otherwise  the
69              local system management interface is used.
70
71       -P/-R rmt_pswd
72              Remote  password  for the nodename given.  The default is a null
73              password.
74
75       -U rmt_user
76              Remote username for the nodename given.  The default is  a  null
77              username.
78
79       -E     Use the remote password from Environment variable IPMI_PASSWORD.
80
81       -F drv_t
82              Force  the  driver  type  to one of the followng: imb, va, open,
83              gnu, landesk, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
84              lan2  with  intelplus.   The  default is to detect any available
85              driver type and use it.
86
87       -J     Use  the  specified  LanPlus   cipher   suite   (0   thru   14):
88              0=none/none/none,       1=sha1/none/none,      2=sha1/sha1/none,
89              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
90              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.
91
92       -T     Use  this  IPMI  LAN  Authentication Type: 0=None, 1=MD2, 2=MD5,
93              4=Straight Password, 5=OEM.
94
95       -V     Use this IPMI LAN  privilege  level.  1=Callback  level,  2=User
96              level,  3=Operator level, 4=Administrator level (default), 5=OEM
97              level.
98
99       -Y     Yes, do prompt the  user  for  the  IPMI  LAN  remote  password.
100              Alternatives for the password are -E or -P.
101
102
103

SEE ALSO

105       ipmiutil(8)   iconfig(8)   icmd(8)   idiscover(8)   ievents(8)  ifru(8)
106       igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8)
107       isol(8) iwdt(8)
108
109

WARNINGS

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

116       Copyright (C) 2009  Kontron America, Inc.
117
118       See the file COPYING in the distribution  for  more  details  regarding
119       redistribution.
120
121       This  utility  is  distributed  in the hope that it will be useful, but
122       WITHOUT ANY WARRANTY.
123
124

AUTHOR

126       Andy Cress <arcress at users.sourceforge.net>
127
128
129
130
131                           Version 1.3: 20 Apr 2007                 IALARMS(8)
Impressum