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

NAME

6       ipmiutil_reset - perform a hardware reset on the system
7

SYNOPSIS

9       ipmiutil  reset  [-bcdDefhijmnoprsuwxy  -N  node  -U  user  -P/-R  pswd
10       -EFJTVY]
11
12

DESCRIPTION

14       ipmiutil reset is a program that uses IPMI commands to perform a  hard‐
15       ware  reset of the chassis, or boot to a specific device.  This utility
16       can use either the /dev/ipmi0 driver from OpenIPMI, the /dev/imb driver
17       from  Intel,  the  /dev/ipmikcs  driver from valinux, direct user-space
18       IOs, or the IPMI LAN interface if -N.
19
20

OPTIONS

22       Command line options are described below.
23
24       -c     Power Cycle the system chassis
25
26       -d     Power Down the system chassis
27
28       -n     Send NMI to the system
29
30       -u     Power Up the system chassis
31
32       -r     Hard Reset the system chassis
33
34       -D     Do a soft shutdown of the OS, and then power  down.   Note  that
35              remote  soft shutdown (-D -N) for Intel S5000 baseboard requires
36              ipmiutil getevt -a running on the target server.
37
38       -o     Do a soft shutdown of the OS, and then reset.  Note that  remote
39              soft  shutdown (-o -N) for Intel S5000 baseboard requires ipmiu‐
40              til getevt -a running on the target server.
41
42       -k     Do a cold reset to restart the BMC firmware.
43
44       -m 002000s
45              Perform these function for a specific MC (e.g. bus  00,  sa  20,
46              lun  00).   The  trailing  character,  if present, indicates SMI
47              addressing if 's', or IPMB addressing if 'i' or not present.
48
49       -b     Do a hard reset and reboot to the  BIOS  Setup  menu,  for  this
50              reboot only.
51
52       -e     Do  a  hard  reset to EFI, if IPMI EFI boot is enabled, for this
53              reboot only.
54
55       -f     Do a hard reset to Floppy/Removable, for this reboot only.
56
57       -h     Do a hard reset to a Hard Disk, for this reboot only.
58
59       -i     Set the boot Initiator mailbox string, usually for PXE use.  The
60              string must be less than 78 characters.
61
62       -j     Set the IANA number used for the boot Initiator mailbox string.
63
64       -p     Do  a hard reset and network boot to PXE server, for this reboot
65              only.
66
67       -s     Do a hard reset and reboot to the Service/Diagnostic  Partition,
68              for this reboot only.  Reboots to the default if no service par‐
69              tition is configured.
70
71       -v     Do a hard reset to DVD/CDROM Media, for this reboot only.
72
73       -w     Wait for BMC ready after a reset before exiting the utility.
74
75       -x     Causes extra debug messages to be displayed.
76
77       -y     Yes, try to persist any boot  options  used  [-befhprsv].   This
78              requires  the IPMI firmware to ask the BIOS to change boot order
79              settings, so it may not be supported by all  BMC  firmware  ven‐
80              dors.
81
82       -N nodename
83              Nodename  or IP address of the remote target system.  If a node‐
84              name is specified, IPMI LAN interface is  used.   Otherwise  the
85              local system management interface is used.
86
87       -P/-R rmt_pswd
88              Remote  password  for the nodename given.  The default is a null
89              password.
90
91       -U rmt_user
92              Remote username for the nodename given.  The default is  a  null
93              username.
94
95       -E     Use the remote password from Environment variable IPMI_PASSWORD.
96
97       -F drv_t
98              Force  the  driver  type  to one of the followng: imb, va, open,
99              gnu, landesk, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
100              lan2  with  intelplus.   The  default is to detect any available
101              driver type and use it.
102
103       -J     Use  the  specified  LanPlus   cipher   suite   (0   thru   17):
104              0=none/none/none,       1=sha1/none/none,      2=sha1/sha1/none,
105              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
106              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.
107
108       -T     Use  a  specified  IPMI  LAN Authentication Type: 0=None, 1=MD2,
109              2=MD5, 4=Straight Password, 5=OEM.
110
111       -V     Use a specified IPMI  LAN  privilege  level.  1=Callback  level,
112              2=User level, 3=Operator level, 4=Administrator level (default),
113              5=OEM level.
114
115       -Y     Yes, do prompt the  user  for  the  IPMI  LAN  remote  password.
116              Alternatives for the password are -E or -P.
117
118
119

SEE ALSO

121       ipmiutil(8)   ialarms(8)  iconfig(8)  icmd(8)  idiscover(8)  ievents(8)
122       ifru(8) igetevent(8) ihealth(8) ilan(8) isel(8)  isensor(8)  iserial(8)
123       isol(8) iwdt(8)
124
125

WARNINGS

127       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
128       and any bug fix list.
129
130
132       Copyright (C) 2009  Kontron America, Inc.
133
134       See the file COPYING in the distribution  for  more  details  regarding
135       redistribution.
136
137       This  utility  is  distributed  in the hope that it will be useful, but
138       WITHOUT ANY WARRANTY.
139
140

AUTHOR

142       Andy Cress <arcress at users.sourceforge.net>
143
144
145
146
147                           Version 1.5: 01 Jul 2011                  IRESET(8)
Impressum