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

NAME

6       ipmiutil_hpm - PICMG HPM.1 Upgrade Agent
7
8

SYNOPSIS

10       ipmiutil hpm [-mxNUPREFJTVY] parameters
11
12

DESCRIPTION

14       This  ipmiutil  hpm subcommand updates HPM components using PICMG HPM.1
15       file
16
17       This utility can use either the /dev/ipmi0 driver  from  OpenIPMI,  the
18       /dev/imb  driver  from  Intel,  the  /dev/ipmikcs  driver from valinux,
19       direct user-space IOs, or the IPMI LAN interface if -N.
20
21

OPTIONS

23       Command line options are described below.
24
25       -m 002000
26              Target a specific MC (e.g. bus 00, sa 20, lun 00).   This  could
27              be  used  for PICMG or ATCA blade systems.  The trailing charac‐
28              ter, if present,  indicates  SMI  addressing  if  's',  or  IPMB
29              addressing if 'i' or not present.
30
31       -x     Causes extra debug messages to be displayed.
32
33       -N nodename
34              Nodename  or IP address of the remote target system.  If a node‐
35              name is specified, IPMI LAN interface is  used.   Otherwise  the
36              local system management interface is used.
37
38       -U rmt_user
39              Remote  username  for the nodename given.  The default is a null
40              username.
41
42       -P/-R rmt_pswd
43              Remote password for the nodename given.  The default is  a  null
44              password.
45
46       -E     Use the remote password from Environment variable IPMI_PASSWORD.
47
48       -F drv_t
49              Force  the  driver  type  to one of the followng: imb, va, open,
50              gnu, landesk, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
51              lan2  with  intelplus.   The  default is to detect any available
52              driver type and use it.
53
54       -J     Use  the  specified  LanPlus   cipher   suite   (0   thru   17):
55              0=none/none/none,       1=sha1/none/none,      2=sha1/sha1/none,
56              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
57              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.
58
59       -T     Use  a  specified  IPMI  LAN Authentication Type: 0=None, 1=MD2,
60              2=MD5, 4=Straight Password, 5=OEM.
61
62       -V     Use a specified IPMI  LAN  privilege  level.  1=Callback  level,
63              2=User level, 3=Operator level, 4=Administrator level (default),
64              5=OEM level.
65
66       -Y     Yes, do prompt the  user  for  the  IPMI  LAN  remote  password.
67              Alternatives for the password are -E or -P.
68
69

PARAMETERS

71       hpm parameters
72
73
74              check
75                     Check the target information.
76
77
78              check filename
79                     Display  both  the existing target version and image ver‐
80                     sion on the screen.
81
82
83              download filename
84                     Download specified firmware.
85
86
87              upgrade filename [all] [component x] [activate]
88                     Upgrade the firmware using a valid HPM.1 image  file.  If
89                     no option is specified, the firmware versions are checked
90                     first and the firmware is upgraded only if they are  dif‐
91                     ferent.
92
93
94                     all
95                            Upgrade  all  components even if the firmware ver‐
96                            sions are the same  (use  this  only  after  using
97                            "check" command).
98
99
100                     component x
101                            Upgrade only given component from the given file.
102                            component 0 - BOOT
103                            component 1 - RTK
104
105
106                     activate
107                            Activate new firmware right away.
108
109
110
111              activate
112                     Activate the newly uploaded firmware.
113
114
115              targetcap
116                     Get the target upgrade capabilities.
117
118
119              compprop id opt
120                     Get  the  specified component properties. Valid component
121                     id: 0-7.  Opt can be one of following:
122                     0 - General properties
123                     1 - Current firmware version
124                     2 - Description string
125                     3 - Rollback firmware version
126                     4 - Deferred firmware version
127
128
129              abort
130                     Abort the on-going firmware upgrade.
131
132
133              upgstatus
134                     Show status of the last long duration command.
135
136
137              rollback
138                     Perform manual rollback on the IPM Controller firmware.
139
140
141              rollbackstatus
142                     Show the rollback status.
143
144
145              selftestresult
146                     Query the self test results.
147
148
149

EXAMPLES

151       ipmiutil hpm targetcap
152       Gets HPM target capabilities
153
154       ipmiutil hpm -N 192.168.1.1 -U root -P pswd download firmware.img
155       Downloads the HPM firmware version contained in firmware.img over  IPMI
156       LAN.
157
158
159

SEE ALSO

161       ipmiutil(8)   ialarms(8)  iconfig(8)  idiscover(8)  ievents(8)  ifru(8)
162       igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8)
163       isol(8) iwdt(8)
164
165

WARNINGS

167       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
168       and any bug fix list.
169
170
172       Copyright (C) 2010  Kontron America, Inc.
173
174       See the file COPYING in the distribution  for  more  details  regarding
175       redistribution.
176
177       This  utility  is  distributed  in the hope that it will be useful, but
178       WITHOUT ANY WARRANTY.
179
180

AUTHOR

182       Andy Cress <arcress at users.sourceforge.net>
183
184
185
186
187                           Version 1.0: 25 Aug 2010                    IHPM(8)
Impressum