1IPMCTL-UPDATE-FIRMWARE(1)           ipmctl           IPMCTL-UPDATE-FIRMWARE(1)
2
3
4

NAME

6       ipmctl-update-firmware - Updates the firmware on one or more DCPMMs
7

SYNOPSIS

9       ipmctl load [OPTIONS] -source (path) -dimm (DimmIds) [TARGETS]
10

DESCRIPTION

12       Updates the firmware on one or more DCPMMs. On the next power cycle,
13       the firmware will become active.
14
15           Note
16           If Address Range Scrub (ARS) is in progress on any target DIMM, an
17           attempt will be made to abort ARS and the proceed with the firmware
18           update.
19
20           Note
21           A reboot is required to activate the updated firmware image and is
22           recommended to ensure ARS runs to completion.
23

OPTIONS

25       -x, -examine
26           Verifies the target DIMM is compatible with and ready to receive
27           the recovery firmware image specified in the source option. Return
28           the recovery firmware image version.
29
30       -f, -force
31           Downgrading the firmware to an older version is a potentially
32           destructive operation which requires confirmation from the user for
33           each DCPMM. This option suppresses the confirmation when attempting
34           to downgrade.
35
36       -h, -help
37           Displays help for the command.
38
39       -o (text|nvmxml), -output (text|nvmxml)
40           Changes the output format. One of: "text" (default) or "nvmxml".
41

TARGETS

43       -dimm (DimmIDs)
44           Updates the firmware on specific DCPMMs by supplying one or more
45           comma-separated DCPMM identifiers. However, this is not recommended
46           as it may put the system in an undesirable state. The default is to
47           update all manageable DCPMMs.
48

EXAMPLES

50       Updates the firmware on all DCPMMs in the system to the image in
51       sourcefile.pkg on the next power cycle.
52
53       ipmctl load -source sourcefile.pkg -dimm
54
55       Checks the firmware image in c:\sourcefile.pkg and retrieve the
56       version.
57
58       ipmctl load -examine -source sourcefile.pkg -dimm
59

LIMITATIONS

61       The specified DCPMM(s) must be manageable by the host software.
62
63       Firmware version (PN.RN.SV.bbbb) updates are supported as follows:
64
65       ·   The product number (PN) cannot be changed.
66
67       ·   The revision number (RN) can be upgraded when PN is the same.
68
69       ·   The security revision number (SV) can be upgraded when PN.RN is the
70           same. In some configurations it can also be downgraded when PN.RN
71           is the same; use the examine option to determine if the security
72           revision number can be downgraded.
73
74       ·   The build number (bbbb) can be upgraded or downgraded. However, if
75           the firmware API version in the firmware image is lower than is
76           supported by the host software and would make the DCPMM become
77           unmanageable, the downgrade is not supported.
78
79           Note
80           Once a firmware image is staged for execution, a power cycle is
81           required before another firmware image of the same type (production
82           or debug) can be staged for execution using this command.
83

RETURN DATA

85       When the examine option is provided, the firmware image is checked and
86       the version number and firmware type is provided. The firmware will
87       either be valid for the DCPMM, a downgrade or invalid meaning it cannot
88       be used for that DCPMM.
89

SAMPLE OUTPUT

91       (file path): MM.mm.hh.bbbb
92       Load FW on DIMM (DimmID): (Valid|Downgrade) [(with
93       confirmation or the force option)]
94
95       If the firmware is being downgraded and the force option is not
96       provided, the user will be prompted to confirm the downgrade for each
97       DCPMM. Otherwise, for each DCPMM, the CLI will indicate the status of
98       the operation.
99
100       Downgrade firmware on DIMM (DimmID)? (y or [n]) Downgrade firmware
101       on DIMM (DimmID)? (y or [n])
102
103       If a failure occurs when updating multiple DCPMMs, the process will
104       continue attempting to update the remaining DCPMMs requested. The
105       firmware will not become active until the next power cycle. Use the
106       command Section [Show Device Firmware] to view more detailed
107       information about the active and staged firmware.
108
109       Load FW on DIMM (DimmID): Success, a power cycle is required to
110       activate the FW.
111       Load FW on DIMM (DimmID): Success, a power cycle is required to
112       activate the FW.
113       Load FW on DIMM (DimmID): Error (Code) - (Description)
114
115
116
117ipmctl                            2019-04-10         IPMCTL-UPDATE-FIRMWARE(1)
Impressum