SANtricity 11.8 Commands ( CA08871-194 ~ 196 )
Download drive firmware
The download drive firmware
command downloads a firmware image to a drive.
Supported Series
This command applies to any individual storage system, including the HB2100/HB2200/HB2300, HB5100/HB5200, AB6100 and AB3100 series, as long as all SMcli packages are installed.
Roles
To execute this command on an HB2100/HB2200/HB2300, HB5100/HB5200, AB6100, or AB3100 storage system, you must have the Storage Admin or Support Admin role.
Context
Possible damage to the storage system configuration — Downloading drive firmware incorrectly can result in damage to the drives or a loss of data access. |
The |
This command is intended for downloading a firmware image to only one drive model at a time. If you use this command in a script, make sure that you use this command only once. If you use this command more than once, the operation can fail. You can download firmware images to all of the drives in a storage system at one time by using the download storageArray driveFirmware
command.
Syntax
download (drive \[trayID,[drawerID,slotID \| drives\ [trayID1,[drawerID1,slotID1 ... trayIDn,[drawerIDn,]slotIDn\]) [online|offline] firmware file="filename"
Parameters
Parameter | Description |
---|---|
|
For high-capacity drive trays, specify the tray ID value, the drawer ID value, and the slot ID value for the drive. For low-capacity drive trays, specify the tray ID value and the slot ID value for the drive. Tray ID values are All slot ID maximums are 24. Slot ID values either begin at 0 or 1, depending on the tray model. Drive trays compatible with HB2100/HB2200/HB2300 and HB5100/HB5200 controllers have slot ID numbers starting at 0. Enclose the tray ID value, the drawer ID value, and the slot ID value in square brackets ([ ]). |
|
Select |
|
The file path and the file name of the file that contains the firmware image. Enclose the file path and the file name of the firmware image in double quotation marks (" "). For example:
Valid file names have a |
|
Indicates to download controller firmware. |
Notes
Before trying to download drive firmware, take these precautions:
-
Unless you are using the
online
parameter, stop all I/O activity to the storage system before you download the firmware image. Thedownload drive firmware
command without theonline
parameter blocks all I/O activity until the download finishes or fails; however, as a precaution, make sure that all I/O activity that might affect the drive is stopped. -
Make sure that the firmware image file is compatible with the drive tray. If you download a firmware image file that is not compatible with the drive tray that you have selected, the drive tray might become unusable.
-
Do not make any configuration changes to the storage system while you download drive firmware. Trying to make a configuration change can cause the firmware download to fail and make the selected drives unusable.
-
For online drive firmware update requests issued using this command, the controller will remove RAID 0 volume group drives from the list of drives to which new firmware is downloaded. Individual drive return status will be set to
Never Attempted With Reason
.
When you download the firmware to the drives, you must provide the full path and file name to the firmware image that is stored on your system.
You can use download drive
command to test the firmware on one drive before you install the firmware on all of the drives in a storage system. The download returns one of these statuses:
-
Successful
-
Unsuccessful With Reason
-
Never Attempted With Reason
The drive
parameter supports both high-capacity drive trays and low-capacity drive trays. A high-capacity drive tray has drawers that hold the drives. The drawers slide out of the drive tray to provide access to the drives. A low-capacity drive tray does not have drawers. For a high-capacity drive tray, you must specify the identifier (ID) of the drive tray, the ID of the drawer, and the ID of the slot in which a drive resides. For a low-capacity drive tray, you need only specify the ID of the drive tray and the ID of the slot in which a drive resides. For a low-capacity drive tray, an alternative method for identifying a location for a drive is to specify the ID of the drive tray, set the ID of the drawer to 0
, and specify the ID of the slot in which a drive resides.