C H A P T E R 2 |
luxadm Subcommands |
This chapter discusses the luxadm subcommands and is divided into the following sections:
The following table lists the basic luxadm subcommands and indicates which commands are supported on the Sun StorEdge A5x00 disk array, the SPARCstorage Array, SPARCstorage RSM trays, and the Sun Fire 880 internal storage array. See Appendix A for information about expert mode subcommands and their supported platforms.
The following options are supported by all subcommands:
Run in expert mode. Use only if you are a qualified system administrator who is knowledgeable about the systems you are managing. |
|
Use the led subcommand to check the current state of the yellow LED associated with a specific disk. For a Sun Fire 880 internal disk, this is the OK-to-Remove LED.
SPARCstorage Array
SPARCstorage RSM
The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information. |
|
The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information. |
|
The physical path name, logical path name, or WWN of a specific disk in an array. |
# luxadm led /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w210000203717802c,0:c,raw LED state is OFF for device in location: front,slot 3 # |
Use the led_blink subcommand to make the LED associated with a specific disk blink or flash. For a Sun Fire 880 internal disk, this is the OK-to-Remove LED.
The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information. |
|
The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information. |
|
The physical path name, logical path name, or WWN of a specific disk in an array. |
Use the led_off subcommand to turn off the yellow LED associated with a specific disk. For a Sun Fire 880 internal disk, this is the OK-to-Remove LED.
The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information. |
|
The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information. |
|
The physical path name, logical path name, or WWN of a specific disk in an array. |
# luxadm led_off /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w210000203717802c,0:c,raw LED state is OFF for device in location: front,slot 0 # |
Use the led_on subcommand to turn on the OK-to-Remove LED associated with a specific disk.
The physical or logical path name of a SPARCStorage Array or a RSM controller ( cN name ) |
Use the probe subcommand to display information about all attached Sun StorEdge A5x00 disk arrays, Sun Fire 880 internal storage arrays, and individual FC-AL devices. The information displayed includes the logical path names, the World Wide Names (WWNs), and the enclosure names.
The following example shows the enclosure information displayed by the probe subcommand issued to a Sun Fire 880 system (DAKTEST) with an attached Sun StorEdge A5x00 disk array (DRIVEBAY).
Use the display subcommand to display enclosure specific or device specific data.
Enclosure data consists of enclosure environmental sense information and status for all subsystem devices including disks. Device data consists of inquiry, capacity, and configuration information.
Sun StorEdge A5x00
Sun Fire 880 internal storage array
Individual FC-AL devices
SPARCstorage Array
luxadm display enclosure[,dev]... | pathname... luxadm display -p pathname... luxadm display -r enclosure[,dev]... | pathname... luxadm display -v enclosure[,dev]... | pathname... |
The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information. |
|
The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information. |
|
The physical or logical path name of a Sun StorEdge A5x00 array or individual disk, SPARCStorage Array, RSM controller ( cN name ), Sun Fire 880 individual disk or enclosure; or the WWN of a Sun Fire 880 disk or SES or a Sun StorEdge A5x00 IB or disk. |
|
Display performance information for the specified device or subsystem. |
|
Display error information for the specified device or subsystem. |
|
Example: Display of Sun Fire 880 internal storage array enclosure information
Use the inquiry subcommand to display information for a specific disk.
Sun StorEdge A5x00
Sun Fire 880 internal storage array
Individual FC-AL devices
SPARCstorage Array
SPARCstorage RSM
The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information. |
|
The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information. |
|
The physical or logical path name of a Sun StorEdge A5x00 array or individual disk, SPARCStorage Array, RSM controller ( cN name ), Sun Fire 880 individual disk or enclosure; or the WWN of a Sun Fire 880 disk or SES, or a Sun StorEdge A5x00 IB or disk. |
Use the download subcommand to download a PROM image to the FEPROMs on a Sun StorEdge A5x00 disk array IB or a SPARCstorage Array controller board.
Use the download subcommand to restore the original flash image into the flash PROMs on both backplanes on a Sun Fire 880 system.
In a Sun StorEdge A5x00 disk array or Sun Fire 880 internal storage array, when the download is complete, the disk array is reset and the downloaded code is executed.
In a SPARCstorage Array, when the download is complete, you must reset the SPARCstorage Array to execute the downloaded code.
Sun StorEdge A5x00
Sun Fire 880 internal storage array
SPARCstorage Array
Caution Caution - When using the -s option, the download modifies the FEPROM in the Sun StorEdge A5x00 disk array. |
Saves the downloaded firmware in the FEPROM in a Sun StorEdge A5x00 disk array. If -s is not specified, the downloaded firmware will not be saved across power cycles. |
|
Downloads the PROM image in filename-path . If you do not specify the -f option, a default PROM image may be used. The default PROM image in a Sun StorEdge A5x00 is in the directory /usr/lib/locale/C/LC_MESSAGES and is named ibfirmware The default PROM image in a SPARCstorage Array is in the directory /usr/lib/firmware/ssa and is named ssafirmware . For the Sun Fire 880 internal storage array, the -f option is required. There is no default PROM image for the Sun Fire 880 system. You must load the image from the Supplement CD provided with the Solaris release. Once loaded, the image resides in the directory /usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw and you can use the -f option to download the image from there. |
|
This option is for the SPARCstorage Array only. See Changing a SPARCstorage Array WWN (download) . |
Use the download subcommand to change the WWN of a SPARCstorage Array controller board.
Use the
fc_s_download
subcommand to download new fcode into all the FC25/S SBus cards. (This is the 25-MHz host adapter card that connects to
SPARCstorage Arrays.)
The fc_s_download subcommand is interactive; it waits for user confirmation before downloading the fcode.
The version of the FC25/S SBus cards fcode that was released with this version of the operating system is located in the directory usr/lib/firmware/fc_s and is named fc_s_fcode .
SPARCstorage Array
Caution Caution - Ensure that you download the /usr/lib/firmware/fc_s/fc_s_fcode file. |
Caution Caution - Only use the fc_s_download subcommand in single-user mode; otherwise, the FC25/S card could be reset. |
Use the fcal_s_download subcommand to download new fcode into all the FC100/S SBus or FC100/P PCI host adapters or to display the current version of the fcode in each host adapter. (This is the 100-MHz host adapter card that connects to the Sun StorEdge A5x00 disk array.)
The fcal_s_download subcommand is interactive and waits for user confirmation before downloading the fcode.
Sun StorEdge A5x00
Caution Caution - Ensure that you download the /usr/lib/firmware/fc_s/fcal_s_fcode file. |
Caution Caution - Do not attempt to download fcode to a FC100/S SBus or FC100/P PCI card that is in your boot path. Boot from another device, such as a CD-ROM, and then download the fcode. |
Use the
fcode_download
subcommand to locate the FC/S, FC100/S, FC100/P, and FC100/2P host adapter cards, download the fcode contained in the directory
dir-name
to the appropriate cards, and to display the current version of the fcode in each host adapter.
The fcode_download subcommand is interactive and waits for user confirmation before downloading the fcode.
Sun StorEdge A5x00
Caution Caution - Only use the fcode_download subcommand in single-user mode; otherwise, the host adapter card could be reset. |
Use the qlgc_s_download subcommand to download the fcode contained in the file fcode-file into all the FC100/P and FC100/2P PCI host adapter cards or to display the current version of the fcode in each host adapter.
The qlgc_s_download subcommand is interactive and waits for user confirmation before downloading the fcode.
Sun StorEdge A5x00
Sun Fire 880 internal storage array
Caution Caution - Only use the qlgc_s_download subcommand in single-user mode; otherwise, the host adapter card could be reset. |
The env_display and various alarm subcommands apply only to an Enclosure Services Card (SES) in a RSM tray in a SPARCstorage Array. The RSM tray is addressed by using the logical or physical path of the SES device or by specifying the controller followed by the tray number. The controller is addressed by cN or the physical path to the controller in the SPARCstorage Array.
Use the env_display subcommand to display the environmental information for a SPARCstorage Array or SPARCstorage RSM.
An RSM tray number. tray-number is valid only for an RSM tray in a SPARCstorage Array. |
Use the alarm_off subcommand to disable the audible alarm for this enclosure. When invoked without an option, the current state of audible alarm is printed.
An RSM tray number. tray-number is valid only for an RSM tray in a SPARCstorage Array. |
Use the alarm_on subcommand to enable the audible alarm for this enclosure. When invoked without an option, the current state of audible alarm is printed.
An RSM tray number. tray-number is valid only for an RSM tray in a SPARCstorage Array. |
Use the alarm_set subcommand to set the duration of the audible alarm to a specified number of seconds.
An RSM tray number. tray-number is valid only for an RSM tray in a SPARCstorage Array. |
|
Use the enclosure_name subcommand to change the enclosure name of a Sun StorEdge A5x00 array or a Sun Fire 880 enclosure.
Use the perf_statistics subcommand to enable or disable the accumulation of performance statistics for a specific SPARCstorage Array controller.
SPARCstorage Array
Note Note - You must enable the accumulation of performance statistics before you can use the display -p subcommand. |
Use the power_off subcommand to set an enclosure to the power-save mode.
Note Note - Sun StorEdge A5x00 disk drives are not available when in the power-save mode. |
When an Enclosure Services Card in a SPARCstorage Array is addressed, the RSM tray is powered off.
When a disk drive in a Sun StorEdge A5x00 is addressed, the drive is set to the drive off/unmated state. When it is set to the drive off/unmated state, the drive is spun down (stopped) and put in the bypass mode.
The physical or logical path name of a Sun StorEdge A5x00, SPARCstorage Array, or a specific disk in an array |
Use the power_on subcommand to set a drive to its normal power-on state. If you specify a Sun StorEdge A5x00 disk drive, the power_on subcommand sets the specified disks to the normal start-up state.
The physical or logical path name of a Sun StorEdge A5x00 disk array or a specific disk in a disk array |
Use the release subcommand to release one or more disk drives from reservation.
The physical or logical path name of a Sun StorEdge A5x00 disk array, SPARCstorage Array, or a specific disk in a disk array |
Use the reserve subcommand to reserve the specified disk(s) for exclusive use by the host from which the subcommand was issued.
The physical or logical path name of a Sun StorEdge A5x00 disk array, SPARCstorage Array, or a specific disk in a disk array |
Use the set_boot_dev subcommand to set the boot device variable in the system PROM to a physical device name. The set_boot_dev subcommand normally runs interactively; it requests confirmation for setting the default boot device in the PROM.
Runs non-interactively; no confirmation is requested or required |
|
Use the start subcommand to spin up the specified disk(s). If pathname specifies the SPARCstorage Array controller, this action applies to all disks in the SPARCstorage Array.
The physical or logical path name of a SPARCstorage Array controller |
Use the stop subcommand to spin down one or more disks.
The physical or logical path name of a SPARCstorage Array controller |
Use the fast_write subcommand to enable or disable the use of the NVRAM to enhance the performance of writes in the SPARCstorage Array.
Causes the SPARCstorage Array to save the change so it will persist across power cycles |
|
Use the nvram_data subcommand to display the amount of fast write data in the NVRAM for a specific disk. This command can only be used for an individual disk.
Use the purge subcommand to purge any fast write data from NVRAM for one or more disks.
SPARCstorage Array
Caution Caution - Use the purge subcommand with caution, usually only when a drive has failed. |
Use the sync_cache subcommand to flush all outstanding writes for one or more disks from NVRAM to the media. If pathname specifies the controller, this action applies to all disks in the SPARCstorage Array subsystem.
This section discusses how to remove, insert, and replace disk drives, enclosures, or a chain of enclosures. For more detailed instructions on performing these operations with a Sun StorEdge A5x00 disk array or Sun Fire 880 internal storage array, see
Chapter 3
and refer to the service manual for your enclosure.
Use the remove_device subcommand to hot-plug a disk drive, enclosure, or a chain of enclosures. This subcommand interactively guides you through hot-plugging of one or more devices.
In the Sun StorEdge A5x00 disk array and the Sun Fire 880 internal storage array, the remove_device subcommand:
Informs you which device to remove by blinking the yellow LED on the Sun StorEdge A5x00 disk array and turning on an OK-to-Remove LED on the Sun Fire 880 internal storage array.
In the SPARCstorage RSM, the remove_device subcommand:
Takes the device offline.
Quiesces the bus for buses that support quiescing.
Informs you that you can safely replace the device.
Requests confirmation that the device has been replaced.
Unquiesces the bus for buses that support quiescing.
Brings the device back online.
Removes the logical device name for the device that was removed.
Forces the hot-plug operation on one or more devices even if those devices are being used by the host (and are, therefore, busy). Caution-- Removing devices that are in use will cause unpredictable results. Try to hot-plug normally (without -F ) first, resorting to this option only when you are sure of the consequences of overriding normal hot-plug checks. |
|
The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information. |
|
The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information. |
|
The physical or logical path name of an individual disk in an array, or of a Sun StorEdge A5x00 array, SPARCStorage Array, or RSM controller ( cN name ). You can also specifiy the WWN of an individual Sun Fire 880 or Sun StorEdge A5x00 disk, or a Sun StorEdge A5x00 IB. |
You must physically remove the device at this time. After you press a key, the following data is displayed:
Use the insert_device subcommand to hot-plug a new disk drive, enclosure, or chain of enclosures. If you specify more than one enclosure, you can perform concurrent hot-plug operations on multiple buses.
The insert_device subcommand interactively guides you through the hot-plug procedure of one or more devices. In the Sun StorEdge A5x00 disk array and the Sun Fire 880 internal storage array, the insert_device subcommand:
Informs you which slot to insert the new drive into by turning on an OK-to Remove LED (Sun Fire 880 systems only).
In the SPARCstorage RSM, the insert_device subcommand:
The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information. |
|
The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information. |
You must physically install the disk drive at this time. After pressing any key, the following data is displayed:
Drive in Box Name "macs1" front slot 1 Logical Nodes under /dev/dsk and /dev/rdsk : c2t1d0s0 c2t1d0s1 c2t1d0s2 c2t1d0s3 c2t1d0s4 c2t1d0s5 c2t1d0s6 c2t1d0s7 # |
Use the replace_device subcommand to hot-plug a device.
The replace_device subcommand interactively guides you through the hot- plug procedure of one or more devices. The replace_device subcommand:
Takes the device offline.
Quiesces the bus for buses that support quiescing.
Informs you that you can safely replace the device.
Requests confirmation that the device has been replaced.
Unquiesces the bus for buses that support quiescing.
Brings the device back online.
Copyright © 2002, Sun Microsystems, Inc. All rights reserved.