Firmware Show and Download Commands

C H A P T E R 6

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:

Show Commands

Download Commands

Note - To prevent unauthorized access to administrative functions of the RAID controller, the Sun StorEdge CLI requires superuser or system administrator privileges for inband 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 safte-device

show sata-mux

show sata-router

show ses-devices

`show safte-device`

Description

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.

Syntax

show safte-device

Examples

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

`show sata-mux`

Description

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.

Syntax

 show sata-mux

Examples

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.

# sccli 206.111.111.111 show sata-mux
sccli: selected se3000://206.111.111.111:58632 [SUN StorEdge 3511 SN#07EEA0]
24 mux boards found
 
Ch Id  Mux-SN Mux-Type PC150/Rev PC150/Boot
-------------------------------------------
 2   0 00075D A/A      BB42      0300
 2   1 00075E A/A      BB42      0300
 2   2 00075F A/A      BB42      0300
 2   3 000760 A/A      BB42      0300
 2   4 000761 A/A      BB42      0300
 2   5 000762 A/A      BB42      0300
 2   6 000763 A/A      BB42      0300
 2   7 000764 A/A      BB42      0300
 2   8 000765 A/A      BB42      0300
 2   9 000869 A/A      BB42      0300
 2  10 000767 A/A      BB42      0300
 2  11 000768 A/A      BB42      0300
 2  16 000C9D A/A      BB42      0300
 2  17 000C9E A/A      BB42      0300
 2  18 000C9F A/A      BB42      0300
 2  19 000CA0 A/A      BB42      0300
 2  20 000CA1 A/A      BB42      0300
 2  21 000CA2 A/A      BB42      0300
 2  22 000CA3 A/A      BB42      0300
 2  23 000CA4 A/A      BB42      0300
 2  24 000CA5 A/A      BB42      0300
 2  25 000CA6 A/A      BB42      0300
 2  26 000CA7 A/A      BB42      0300
 2  27 000CA8 A/A      BB42      0300

`show sata-router`

Description

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 .

Syntax

show sata-router

Examples

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.)

sccli> show sata-router
Encl-ID Encl-SN Ch Slot  Rev      Boot-rev CSB  HW-rev ST-rev
-------------------------------------------------------------
0       07ECC0  2  upper DP0553   0548     0500 11     0552
0       07ECC0  3  lower DP0553   0548     0500 11     0552

In the following example, no valid path exists on the lower router, so n/a displays to indicate that no data was returned.

# sccli  206.6.180.20 show sata-router
sccli: selected se3000://206.1.111.11:58632 [SUN StorEdge 3511 SN#07ECDF]
Encl-ID Encl-SN Ch Slot  Rev      Boot-rev CSB  HW-rev ST-rev
------------------------------------------------------------
0       07ECDF  2  upper DP0548   0509     0500 00     0552
0       07ECDF  3  lower n/a      n/a      n/a  n/a    n/a

`show ses-devices`

Description

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).

Syntax

show ses-devices

Examples

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

sccli> show ses-devices
Ch  Id Chassis Vendor/Product ID     Rev  PLD  WWNN             WWPN
------------------------------------------------------------------------------
 2  12 003CE3  SUN StorEdge 3510F A  1046 1000 204000C0FF003CE3 214000C0FF003CE3
                                                     Topology: loop(a)
 3  12 003CE3  SUN StorEdge 3510F A  1046 1000 204000C0FF003CE3 224000C0FF003CE3
                                                     Topology: loop(b)

Download Commands

The following commands are explained in this section:

download controller-firmware

download disk-firmware

download pld-hardware

download safte-firmware

download sata-path-controller-firmware

download sata-router-firmware

download ses-firmware

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 - 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 Sun StorEdge CLI, you must specify the full path.

`download controller-firmware`

Description

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.

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.

Syntax

download controller-firmware filename [-r | --reset]

Arguments

TABLE 6-1 Arguments for `download controller-firmware`
Argument	Description
filename	Specify the firmware file name for the file that you want to download.
[-r \| --reset]	Reset the controller after the download completes.

Examples

The following example downloads firmware to the RAID controller.

sccli> download controller-firmware SUN411G-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

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.

`download disk-firmware`

Caution - Do not use this command with the Solaris operating system. Disk drive firmware is provided through Sun disk firmware patches which include the required download utility. Sun disk firmware patches are separate from the Sun StorEdge 3000 family firmware patches. For details, refer to the Release Notes for your array.

Description

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.

Note - The download disk-firmware command does not support a live upgrade (a hot download operation). This command 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:

All daemons that access the RAID controller must be stopped.

I/O is interrupted.

The controller is reset after disks are flashed.

Syntax

download disk-firmware filename product-id

Arguments

TABLE 6-2 Arguments for `download disk-firmware`
Argument	Description
filename	Specify the firmware file name for the file that you want to download.
product-id	Specify the product ID of the disk inquiry string. For example, type `ST336607FSUN36G` or `ST373453FSUN37G`. If there is a character space in the inquiry string, use quotation marks (““) where the space occurs. For example, type “`ST336607 SUN36G`“ or `ST373453`““`SUN37G`. To determine the disk inquiry string, run the `show disks` command.

Examples

The following example shows the disk product ID on channel 2 ID 6 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 pld-hardware`

Description

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.

Note - The download pld-hardware command does not support a live upgrade (a hot download operation). Shut down the array before performing this command. When the download completes, restart the device to activate the new hardware.

Syntax

download pld-hardware filename

Arguments

TABLE 6-3 Arguments for `download pld-hardware`
Argument	Description
filename	Specify the firmware file name for the file that you want to download.

Examples

The following example downloads the hardware using the SES device in the RAID controller with the IP address 192.168.0.1.

# sccli 192.168.0.1 download pld-hardware pld1r10.s3r

The following example downloads the hardware using the SES device to a FC JBOD unit.

# sccli /dev/es/ses3 download pld-hardware pld1r10.s3r

`download safte-firmware`

Description

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.

Syntax

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

Arguments

TABLE 6-4 Arguments for `download safte-firmware`
Argument	Description
[`-f` \| `--force`]	Specify the firmware is downloaded unconditionally, regardless of the version detected.
filename	Specify the firmware file name for the file that you want to download.

Examples

The following example downloads SAF-TE firmware to the SAF-TE device in the RAID controller.

# sccli c2t0d0 download safte-firmware saftefw_3310_1180.bin

The following example downloads SAF-TE firmware to the SAF-TE device in the JBOD.

# sccli /dev/es/ses2 download safte-firmware saftefw_3310_1180.bin

`download sata-path-controller-firmware`

Description

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.

Syntax

download sata-path-controller-firmware filename

Arguments

TABLE 6-5 Arguments for `download sata-path-controller-firmware`
Argument	Description
filename	Specify the firmware file name for the file that you want to download.

Examples

The following example downloads the path controller firmware to all SATA routers.

# sccli 192.168.0.1 download sata-path-controller-firmware PC_BB42.dat

`download sata-router-firmware`

Description

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.

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.

Syntax

download sata-router-firmware filename [-r | --reset]

Arguments

TABLE 6-6 Arguments for `download sata-router-firmware`
Argument	Description
filename	Specify the firmware file name for the file that you want to download.
[`-r` \| `--reset`]	Reset the controller after the download completes.

Examples

The following example downloads SATA firmware to the specified device.

# sccli 192.168.0.1 download sata-router-firmware FW-DP0555.dlf

`download ses-firmware`

Description

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.

Syntax

download ses-firmware filename

Arguments

TABLE 6-7 Arguments for `download ses-firmware`
Argument	Description
filename	Specify the firmware file name for the file that you want to download.

Examples

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

# sccli c2t0d0 download ses-firmware ses-1103.s3r

The following example downloads SES firmware to the SES device in the JBOD /dev/es/ses4.

# sccli /dev/es/ses4 download ses-firmware sesfw_sunfc_1046.s3r