C H A P T E R 6 |
Firmware Show and Download Commands |
This chapter provides the firmware, disk drive, SCSI Enclosure Services (SES), SCSI Accessed Fault-Tolerant Enclosure (SAF-TE), programmable logic device (PLD), and serial ATA (SATA) router and path controller show and download commands. Topics covered in this chapter include:
The following commands are explained in this section:
Sun StorEdge 3000 family SCSI devices only. The show safte-device command displays information returned by the SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device embedded in SCSI LVD RAID enclosures or JBODs. When this command is issued to an LVD SCSI RAID array 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 (an A indicates a RAID device and an D indicates an expansion unit or JBOD), SAF-TE firmware revision, 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.
The following example shows the SAF-TE device information for a Sun StorEdge 3310 SCSI array.
sccli> show safte-device Ch Id Chassis Vendor Product ID Rev Package --------------------------------------------------------- 0 14 002A4C SUN StorEdge 3310 A 1170 1170 |
The following example shows the SAF-TE device information for a Sun StorEdge 3120 SCSI array.
sccli> show safte-device Id Chassis Vendor Product ID Rev Package ------------------------------------------------------ 5 0064CA SUN StorEdge 3120 D 1170 1170 |
The show sata-mux command shows the SATA multiplexer (MUX) board information for all drives. Each drive has one MUX board. The information for the MUX board includes the channel number and ID of the drive attached to the MUX board, MUX board serial number, MUX board type (active-passive or active-active), path controller (PC150) firmware revision number, and PC150 boot revision.
The following example shows the MUX board information for the drives attached to the specified device. When no serial number has been programmed for the MUX board, n/a displays in the MUX-SN column.
The show sata-router command shows all accessible SATA routers behind the RAID controller. The information displayed includes the enclosure ID and enclosure serial number of the chassis that the SATA router resides in, the channel number that the router controls, slot position of the IOM board that the router resides on, router firmware revision number, SATA router boot revision, customer-specified behavior (CSB) parameter structure revision number (a collection of memory resident parameters that define operational behavior of the router), hardware revision number, and the self-test revision number.
The following example shows the data returned from a redundant configuration. Two routers are assigned to the same chassis in a redundant configuration. (The Encl-SN column displays the same chassis serial number for both routers.)
In the following example, no valid path exists on the lower router, so n/a displays to indicate that no data was returned.
Sun StorEdge 3000 family FC and SATA devices only. The show ses-devices command displays a list of SCSI Enclosure Services (SES) devices visible to the selected array controller or JBOD. The output includes the channel and target ID of the SES device, serial number of the chassis in which it is installed, vendor and product IDs, SES firmware revision, programmable logic device (PLD) firmware revision, worldwide node name (WWNN), worldwide port name (WWPN) for the device, and the loop location.
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.
Returned values include: channel number, SCSI ID, chassis number, vendor, product ID (an A indicates a RAID device and a D indicates an expansion unit or JBOD), revision, PLD revision, SES WWNN, SES WWPN, and SES topology (loop A, top slot, or loop B bottom slot).
The following example shows the SES devices for a Sun StorEdge 3510 FC RAID device.
The following commands are explained in this section:
Caution - All download commands are potentially dangerous. |
Caution - In redundant-controller configurations, download commands affect all LUNs on both controllers. After running a download command, run the selectcommand to reselect the device. |
Caution - Stop the Configuration Service agent if it is running. |
Note - If the download firmware files are not under the same directory as the Sun StorEdge CLI, you must specify the full path. |
The download controller-firmware command downloads firmware to the RAID controller. Before the command is executed, the firmware file is checked to ensure that it is appropriate for the target device. 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 shut down 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.
Specify the firmware file name for the file that you want to download. |
|
The following example downloads firmware to the RAID controller.
Note - To monitor the status of the automatic firmware update, use the Sun StorEdge CLI show redundancy-mode command. The Sun StorEdge CLI will display the progression of “Failed,” “Scanning,” “Detected,” and “Enabled” states. For details, see show redundancy-mode. |
Sun StorEdge 3000 family RAID arrays only. The download disk-firmware command downloads disk drive firmware to 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 Fujitsu firmware to a Seagate drive, the download fails.
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.
The following example shows the disk product ID on channel 2 ID 6 and then downloads the disk firmware to that drive.
The following example downloads the firmware to the disk in the JBOD unit /dev/rdsk/c6t0d0s2, which is attached to a RAID controller.
Fibre Channel and SATA devices only. The download pld-hardware command downloads PLD hardware into the SES microprocessor in a Sun StorEdge 3000 family FC RAID or JBOD device. To determine the PLD version on a device, use the show ses-devices command. For details, see show ses-devices.
Specify the firmware file name for the file that you want to download. |
The following example downloads the hardware using the SES device in the RAID controller with the IP address 192.168.0.1.
The following example downloads the hardware using the SES device to a FC JBOD unit.
Sun StorEdge 3000 family SCSI devices only. The download safte-firmware command downloads firmware into the microprocessors for the SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device within a SCSI RAID controller or JBOD. The firmware file contains code for the various microprocessors that monitor and control the enclosure. The Sun StorEdge CLI detects whether the firmware file is a more recent version. If the version is out of date, the Sun StorEdge 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.
The following example downloads SAF-TE firmware to the SAF-TE device in the RAID controller.
The following example downloads SAF-TE firmware to the SAF-TE device in the JBOD.
Sun StorEdge 3000 family SATA devices only. The download sata-path-controller-firmware command downloads the path controller microcode that resides on the multiplexer (MUX) boards behind the SATA router. Before downloading the SATA path controller firmware, the Sun StorEdge CLI checks the redundancy of all SATA routers. If the configuration is redundant, then a live upgrade (hot download) is performed.
Caution - All download commands are potentially dangerous. |
If the configuration is not redundant, the user cannot perform a live upgrade. Since routers can cause critical damage to the RAID system, in a non-redundant configuration, the controller must be shut down before the download and must be reset after the download. In single-controller and non-redundant configurations, the Sun StorEdge CLI prompts the user to continue. If the user specifies Y at the prompt, the Sun StorEdge CLI shuts down the controller, performs the download, and then resets the controller. When the controller shuts down, the host is prevented from performing I/O for several minutes.
Note - To manually check the array redundancy, run a show sata-router command. Two routers are assigned to the same chassis in a redundant configuration. (The Encl-SN column displays the same chassis serial number for both routers.) For details on the show sata-router command, see show sata-router. |
Specify the firmware file name for the file that you want to download. |
The following example downloads the path controller firmware to all SATA routers.
Sun StorEdge 3000 family SATA devices only. The download sata-router-firmware command downloads SR-1216 router firmware to all SATA routers in the SATA unit including SATA RAID controllers, expansion units, and JBODs. Before downloading the SATA router firmware, the Sun StorEdge CLI checks the redundancy of all SATA routers. If the configuration is redundant, then a live upgrade (hot download) is performed.
Caution - All download commands are potentially dangerous. |
If the configuration is not redundant, the user cannot perform a live upgrade. Since routers can cause critical damage to the RAID system, in a non-redundant configuration, the controller must be shut down before the download and must be reset after the download. In single-controller and non-redundant configurations, the Sun StorEdge CLI prompts the user to continue. If the user specifies Y at the prompt, the Sun StorEdge CLI shuts down the controller, performs the download, and then resets the controller. When the controller shuts down, the host is prevented from performing I/O for several minutes.
To manually check the array redundancy, run a show sata-router command. Two routers are assigned to the same chassis in a redundant configuration. (The Encl-SN column displays the same chassis serial number for both routers.) For details on the show sata-router command, see show sata-router.
Specify the firmware file name for the file that you want to download. |
|
The following example downloads SATA firmware to the specified device.
Sun StorEdge 3000 family FC and SATA devices only. The download ses-firmware command downloads firmware to the SCSI Enclosure Services (SES) device in a FC or SATA RAID array or JBOD unit.
Specify the firmware file name for the file that you want to download. |
The following example downloads SES firmware to the SES device with device name c2t0d0 in the RAID controller.
The following example downloads SES firmware to the SES device in the JBOD /dev/es/ses4.
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.