C H A P T E R  6

Firmware Show and Download Commands

This chapter provides the firmware, disk drive, and NVRAM show and download commands. Topics covered in this chapter include:



Note - To prevent unauthorized access to administrative functions of the RAID controller, the CLI requires superuser or system administrator privileges for in-band access, and uses the controller password to authorize users of the out-of-band interface.




Show Commands

The following commands are explained in this section:

show pld-revision

Standalone Fibre Channel expansion chassis SES devices only. This command displays the PLD firmware revision of the specified standalone Sun StorEdge 3510 FC expansion chassis SES device. The FC expansion chassis must be connected directly to the host (not to an array controller), and the SES device must be specified explicitly with the select command.

show pld-revision

To retrieve the PLD firmware revision of an array controller chassis, or of an expansion chassis connected to an array controller, use the show ses-devices command instead. For details, see show ses-devices.

show safte-devices

SCSI devices only. This command displays information returned by the SAF-TE device embedded in SCSI LVD RAID enclosures or JBODs. When this command is issued to a LVD SCSI RAID with one or more expansion chassis attached, the output includes one line for the RAID chassis and one line for each expansion chassis, since each enclosure contains a separate SAF-TE device.

The output includes the channel and target ID of the SAF-TE device, the serial number of the chassis in which it is installed, the vendor and product IDs and SAF-TE firmware revision, the status of the overall health of the enclosure, and the "SAF-TE firmware package" revision, which refers to firmware for other microprocesses in the chassis that are managed by the SAF-TE processor.

show safte-devices

The following example shows the SAF-TE device information for a Sun StorEdge 3310.

# sccli /dev/device show safte
sccli: selected /dev/device [SUN StorEdge 3310 SN#000187]
Ch  Id  Chassis  Vendor  Product ID        Rev   Package Status
---------------------------------------------------------------
 0  14  00476F   SUN     StorEdge 3310 A   1150  1025     OK

The following example shows the SAF-TE device information for a Sun StorEdge 3120.

# sccli /dev/device show safte
sccli: selected /dev/device [SUN StorEdge 3120 SN#000187]
Ch  Id  Chassis  Vendor  Product ID        Rev   Package Status
---------------------------------------------------------------
 0  14  012345   SUN     StorEdge 3120  D  1159  1159     OK

show ses-devices

Fibre Channel devices only. This command displays a list of enclosure services devices visible to the selected array controller or JBOD. The output includes the channel and target ID of the SES device, the serial number of the chassis in which it is installed, the vendor and product IDs and the SES firmware revision, the PLD firmware revision, the status of the overall health of the enclosure, and the FC World Wide Port Name for the device.

In redundant configurations, SES devices are installed in pairs in a single chassis. Therefore, two devices show the same chassis serial number. It is important to ensure the SES firmware and PLD revisions are consistent for SES devices installed in the same chassis. Any firmware revision mismatches that might result from replacement of an SES device FRU are flagged with an asterisk ("*"), as well as by a visual indicator on the chassis itself.

Information is shown for the array device's enclosure, as well as any expansion chassis that might be connected to the array. To view information about an SES device in an expansion chassis connected directly to the host instead of an array controller, use the select command to specify an SES device in the expansion chassis, and issue a show inquiry and show pld-revision command to each device.

show ses-devices

Returned values include: Channel Number, SCSI ID, Chassis Number, Vendor, Product ID, Revision, PLD Revision, SES WWNN, SES WWPN, SES Topology (loop A, top slot, or loop B bottom slot), and Status.

The following example shows the SES devices for a Sun StorEdge 3510.

# sccli /dev/device show ses
sccli: selected /dev/device [SUN StorEdge 3510 SN#000187]
Ch  Id Chassis Vendor/Product ID    Rev  PLD  WWNN             WWPN
------------------------------------------------------------------------------
 2  12 000187  SUN StorEdge 3510F D 1000 1000 204000C0FF000187 214000C0FF000187
                                              Topology: loop(a)  Status: OK


Download Commands

The following commands are explained in this section:



caution icon

Caution - All download commands are potentially dangerous. Use only as instructed.





caution icon

Caution - In redundant-controller configurations, download commands affect all LUNs on both controllers. After running a download command, you need to run the select command to reselect the device.





caution icon

Caution - Stop the Configuration Service agent if it is running.





Note - Although redundant controller configurations support live firmware upgrades using its failover capability, the failover operation itself might cause warning messages to be displayed on the console or system log. These messages can be ignored.





Note - If the download firmware files are not under the same directory as the CLI, you need to specify the full path.



download controller-firmware

This command downloads firmware to the RAID controller. In a dual-controller configuration, the failover capability of the redundant controller pair is used to activate the new firmware without requiring the array to be shutdown in what is known as a live upgrade or hot firmware download operation. In a single controller configuration, the new firmware is activated by resetting the controller.

If the -r or --reset option is specified, the controllers are always reset instead of performing a live upgrade. This option is faster and is recommended when a live upgrade is not required.



caution icon

Caution - All reset commands cause the array to stop responding to I/O requests from the host for a period of time. This might result in data loss unless all I/O activity is suspended by halting all applications that are accessing the array, and unmounting any file systems that are mounted from the array. In redundant-controller configurations, these commands affect all LUNs on both controllers.



download controller-firmware filename 

The following example downloads firmware to the RAID controller:

sccli> download controller-firmware SUN327Q-3510.bin
sccli: selected se3000://199.249.246.28:58632 [Sun StorEdge 3510 SN#000187]
The controllers will be reset sequentially.
One controller will remain online while the other restarts.
This should not affect normal I/O activity.
Are you sure? yes
  :

download disk-firmware

This command downloads disk driver firmware into disk drives connected to the array. The disk-model is matched against SCSI INQUIRY data to determine which drives should be programmed. The disk firmware file is matched to the capacity, family, and drive type of the drive to which you are downloading. For instance, if you attempt to download 73 Gbyte drive Fuji firmware to a Seagate drive, the download fails.

This function shuts down the array controller first, preventing the host from performing I/O for several minutes.

This command only upgrades firmware in drives attached to RAID array controllers. To upgrade disk firmware in drives contained within a standalone expansion chassis (JBOD), use the procedure documented in the README file provided with the firmware.

When using this command:

 

The following example shows the disk model on channel 2 ID 6 to discover the disk model name and then downloads the disk firmware to that drive:

sccli> show disks
Ch  Id      Size   Speed  LD     Status   IDs
-----------------------------------------------------------------------
 2   6   33.92GB   200MB  ld0    ONLINE   SEAGATE ST336753FSUN36G 0349
                                              S/N 3HX0YEJT00007349
 2   7   33.92GB   200MB  ld0    ONLINE   SEAGATE ST336753FSUN36G 0349
                                              S/N 3HX0Y6J300007349
 2   8   33.92GB   200MB  ld1    ONLINE   SEAGATE ST336753FSUN36G 0349
                                              S/N 3HX0YC1Y00007349
 2   9   33.92GB   200MB  ld1    ONLINE   SEAGATE ST336753FSUN36G 0349
                                              S/N 3HX0Y7W100007349
 2  10   33.92GB   200MB  GLOBAL STAND-BY SEAGATE ST336753FSUN36G 0349
                                              S/N 3HX0YAQF00007349
sccli> download disk-firmware newfile ST336753FSUN36G

The following example downloads the firmware to the disk in the JBOD unit /dev/rdsk/c6t0d0s2, which is attached to a RAID controller:

# sccli /dev/rdsk/c6t0d0s2 download disk-firmware new_disk_fw 

download nvram

This command restores the NVRAM configuration from a NVRAM file to the RAID controller. The binary NVRAM file contains information specific to the host device, such as channel settings, RAID controller parameters, and so on. The IP address, password, controller name and unique ID are not downloaded from the NVRAM file to the host device since these settings differ for each controller. After the download completes, reset the controller for the NVRAM settings to take effect.

download nvram filename [-r | --reset]

The following example downloads the NVRAM file, tmpsn2-1.nvram, and then resets the controller:

# sccli 192.168.0.1 download nvram /tmpsn2-1.nvram -r 

download pld-firmware

Fibre Channel devices only. This command downloads PLD firmware into the SES microprocessor in a FC or JBOD device.

download pld-firmware filename

The following example downloads the firmware using the SES device in the RAID controller with the IP address 192.168.0.1:

# sccli 192.168.0.1 download pld-firmware pld-file 

The following example downloads the firmware using the SES device to a FC JBOD unit:

# sccli /dev/scsi/ses/c6t12d0 download pld-firmware pld-file 

download safte-firmware

SCSI devices only. This command downloads firmware into the microprocessors within a SCSI RAID controller or JBOD. The firmware file contains code for the various microprocessors that monitor and control the enclosure. The CLI utility detects whether the firmware file is a more recent version. If the version is out-of-date, the CLI will not download the firmware. However, you can use the -f or --force command to download the firmware unconditionally.

This procedure can be performed "live" without resetting the controller. However, the updated firmware version number might not correctly display in the firmware Telnet or serial menu interface until the controller is reset.

download safte-firmware [-f | --force] filename

TABLE 6-2 Arguments for download safte-firmware

Argument

Description

[-f | --force]

Specify the firmware is downloaded unconditionally, regardless of the version detected.

filename

Specify the firmware filename for the file that you want to download.


 

The following example downloads SAF-TE firmware to the SAF-TE device in the RAID controller with the device name c2t0d0:

# sccli c2t0d0 download safte-firmware safte-fw-file

The following example downloads SAF-TE firmware to the SAF-TE device in the JBOD /dev/scsi/processor/c6t15d0:

# sccli /dev/scsi/processor/c6t15d0 download safte-firmware safte-fw-file

download ses-firmware

Fibre Channel devices only. This command downloads firmware to the SES device in a FC RAID controller or JBOD unit.

download ses-firmware filename

The following example downloads SES firmware to the SES device in the RAID controller with device name c2t0d0:

# sccli c2t0d0 download ses-firmware ses-fw-file 

The following example downloads SES firmware to the SES device in the JBOD /dev/scsi/processor/c6t15d0:

# sccli /dev/scsi/processor/c6t15d0 download ses-firmware ses-fw-file