|
|  以 PDF 格式下载本书 (127 KB)
Chapter 2 luxadm SubcommandsThis chapter discusses the luxadm subcommands and is divided into the following sections: For information on how to specify (address) a disk array, see "Addressing". Subcommand Support MatrixThe following basic luxadm subcommands are supported on the StorEdge A5000 disk array, the SPARCstorage Array, and SPARCstorage RSM trays. See Appendix A, Expert Mode Subcommands for information about export mode subcommands and their supported platforms. Table 2-1 Subcommand Support Matrix
Checking and Setting Disk LEDsChecking the Current State of a Disk LED (led)Use the led subcommand to check the current state of the yellow LED associated with a specific disk.
luxadm [ -v ] led { enclosure,dev... | pathname...}
Table 2-2 led Options and Arguments
# luxadm led /devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/ssd@w21000020370412ec,0:c,raw LED state is OFF for device in location: front,slot 0 # Setting a Disk LED to the Blink Mode (led_blink)Use the led_blink subcommand to make the yellow LED associated with a specific disk blink or flash.
luxadm [ -v ] led_blink { enclosure,dev... | pathname...}
Table 2-3 led_blink Options and Arguments
# luxadm led_blink /devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/ssd@w21000020370412ec,0:c,raw LED state is BLINKING for device in location: front,slot 0 # Turning Off a Disk LED (led_off)Use the led_off subcommand to turn off the yellow LED associated with a specific disk.
luxadm [ -v ] led_off { enclosure,dev... | pathname...}
Table 2-4 led_off Options and Arguments
Note - On a StorEdge A5000 disk array this may or may not cause the yellow LED to turn off or stop blinking depending on the state of the StorEdge A5000 disk array. Refer to StorEdge A5000 Installation and Service Manual for details. # luxadm led_off /devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/ssd@w21000020370412ec,0:c,raw LED state is OFF for device in location: front,slot 0 # Turning On a Disk LED (led_on)Use the led_on subcommand to turn on the yellow LED associated with a specific disk.
luxadm [ -v ] led_on pathname Table 2-5 led_on Options and Arguments
Displaying Enclosure and Disk InformationProbing for StorEdge A5000 Disk Arrays (probe)Use the probe subcommand to display information about all attached StorEdge A5000 disk arrays. The information displayed includes the logical path names, the WWNs, and the enclosure names.
luxadm [ -v ] probe [-p] Table 2-6 probe Options
# luxadm probe Found SENA Name:macs1 Node WWN:1234123412341234 Logical Path:/dev/es/ses0 Logical Path:/dev/es/ses1 # # luxadm probe -p Found SENA Name:macs1 Node WWN:5080020000000598 Logical Path:/dev/es/ses0 Physical Path:/devices/sbus@1f,0/SUNW,socal@0,0/sf@1,0/ses@w5080020000000599,0:0 Logical Path:/dev/es/ses1 Physical Path:/devices/sbus@1f,0/SUNW,socal@0,0/sf@1,0/ses@w508002000000059a,0:0 Logical Path:/dev/es/ses2 Physical Path:/devices/sbus@1f,0/SUNW,socal@0,0/sf@1,0/ses@w5080020000000599,0:0 Logical Path:/dev/es/ses3 Physical Path:/devices/sbus@1f,0/SUNW,socal@0,0/sf@1,0/ses@w508002000000059a,0:0 # Displaying Enclosure or Device Specific Data (display)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.
luxadm [ -v ] display enclosure[,dev]... | pathname... Table 2-7 display Options and Arguments
# luxadm display macs1
(luxadm version: 1.36 98/03/10)
SENA
DISK STATUS
SLOT FRONT DISKS (Node WWN) REAR DISKS (Node WWN)
0 On (O.K.) 2000002037049dfa Not Installed
1 On (O.K.) 2000002037070608 On (O.K.) 200000203704a9e1
2 On (O.K.) 2000002037070498 On (O.K.) 200000203704a285
3 On (O.K.) 2000002037049f31 On (O.K.) 200000203704a252
4 On (O.K.) 20000020370705e1 On (O.K.) 2000002037049d61
5 On (O.K.) 2000002037049b32 On (O.K.) 200000203704a8f1
6 On (O.K.) 2000002037049987 On (O.K.) 200000203704a9de
SUBSYSTEM STATUS
FW Revision:1.05 Box ID:0 Node WWN:5080020000000598 Enclosure Name:macs1
Power Supplies (0,2 in front, 1 in rear)
0 O.K.(rev.-02) 1 O.K.(rev.-02) 2 O.K.(rev.-02)
Fans (0 in front, 1 in rear)
0 O.K.(rev.-05) 1 O.K.(rev.-00)
ESI Interface board(IB) (A top, B bottom)
A: O.K.(rev.-04)
GBIC module (1 on left, 0 on right in IB)
0 O.K.(rev.-05) 1 O.K. (rev.-05): Not Installed
B: O.K.(rev.-04)
GBIC module (1 on left, 0 on right in IB)
0 O.K.(rev.-05) 1 O.K. (rev.-05): Not Installed
Disk backplane (0 in front, 1 in rear)
Front Backplane: O.K.(rev.-05)
Temperature sensors (on front backplane)
0:42ºC 1:42ºC 2:40ºC 3:39ºC 4:40ºC 5:42ºC
6:43ºC (All temperatures are NORMAL.)
Rear Backplane: O.K.(rev.-05)
Temperature sensors (on rear backplane)
0:37ºC 1:37ºC 2:39ºC 3:39ºC 4:39ºC 5:40ºC
6:42ºC (All temperatures are NORMAL.)
Interconnect assembly
O.K.(rev.-03)
Loop configuration
Loop A is configured as a single loop.
Loop B is configured as a single loop.
Language USA English
#
# luxadm display -r macs1
(luxadm version: 1.36 98/03/10)
SENA
Information for FC Loop on port 0 of FC100/S Host Adapter
at path: /devices/sbus@1f,0/SUNW,socal@0,0:0
Version Resets Req_Q_Intrpts Qfulls Requests Sol_Resps Unsol_Resps Lips
1 0 0 0 0 0 0 2
Els_sent Els_rcvd Abts Abts_ok Offlines Onlines Online_loops
0 0 18 18 4 0 5
Information from sf driver:
Version Lip_count Lip_fail Alloc_fail #_cmds Throttle_limit Pool_size
1 0 0 0 0 1024 1
TARGET ERROR INFORMATION:
AL_PA Els_fail Timouts Abts_fail Tsk_m_fail Data_ro_mis Dl_len_mis Logouts
1 0 5 0 0 0 0 0
d2 0 2 0 0 0 0 0
ef 0 3 0 0 0 0 0
e8 0 0 0 0 0 0 0
e4 0 0 0 0 0 0 0
e2 0 2 0 0 0 0 0
e1 0 2 0 0 0 0 0
e0 0 0 0 0 0 0 0
dc 0 0 0 0 0 0 0
b5 0 0 0 0 0 0 0
cc 0 0 0 0 0 0 0
cb 0 0 0 0 0 0 0
ca 0 0 0 0 0 0 0
c9 0 0 0 0 0 0 0
c7 0 0 0 0 0 0 0
c6 0 0 0 0 0 0 0
Displaying Disk Information (inquiry)Use the inquiry subcommand to display inquiry information for a specific disk
luxadm [ -v ] inquiry { enclosure[,dev]... | pathname...}
Table 2-8 inquiry Options and Arguments
# luxadm inquiry macs1
INQUIRY:
Physical path:
/devices/sbus@1f,0/SUNW,socal@0,0/sf@1,0/ses@w5080020000000599,0:0
Vendor: SUN
Product: SENA
Revision: 1.05
Device type: 0xd (SES device)
Removable media: no
Medium Changer Element: no
ISO version: 0
ECMA version: 0
ANSI version: 3 (Device complies to SCSI-3)
Terminate task: no
Response data format: 2
Additional length: 0x7b
Command queueing: no
VENDOR-SPECIFIC PARAMETERS
Byte# Hex Value ASCII
51 00 00 00 00 ....
95 6d 61 63 73 31 00 00 00 00 00 00 00 00 00 00 00 macs1...........
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
#
Downloading Firmware and fcodeDownloading Firmware (download)Use the download subcommand to download a prom image to the FEPROMs on a StorEdge A5000 disk array IB or on a SPARCstorage Array controller board. In a StorEdge A5000 disk array, when the download is complete, the disk array is be 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.
luxadm [ -v ] download [-s] [-f filename-path ]  Caution - When using the -s option, the download modifies the FEPROM in the StorEdge A5000 disk array. Note - The -s option does not apply to the SPARCstorage Array controller, as it always writes the downloaded firmware into the FEPROM. Table 2-9 download Options and Arguments
Changing a SPARCstorage Array WWN (download)Use the download subcommand to change the WWN of a SPARCstorage Array controller board.
luxadm [ -v ] download [-w WWN] pathname Table 2-10 download Options and Arguments
Downloading fcode to FC25/S Host Adapters (fc_s_download)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 FC/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.
Caution - Ensure that you download the usr/lib/firmware/fc_s/fc_s_fcode file. Caution - Only use fc_s_download subcommand in single user mode; otherwise the FC/S card could be reset. luxadm [ -v ] fc_s_download [-F] [-f fcode-file] Table 2-11 fc_s_download Options
Downloading fcode to FC100 Host Adapters (fcal_s_download)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 which connects to StorEdge A5000 disk arrays.) The fcal_s_download subcommand is interactive and waits for user confirmation before downloading the fcode.
Caution - Ensure that you download the /usr/lib/firmware/fc_s/fcal_s_fcode file. Caution - Do not attempt to download fcode to a FC100/S SBus Card that is in your boot path. Boot from another device, such as a CDROM, and then download the fcode. luxadm [ -v ] fcal_s_download [ -f fcode-file ] Table 2-12 fcal_s_download Options
Accessing the Enclosure Services CardThe 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. Displaying Environmental Information (env_display)Use the env_display subcommand to display the environmental information for a SPARCstorage Array.
luxadm [ -v ] env_display
{ pathname | controller tray-number }
Table 2-13 env_display Options and Arguments
Disabling the Alarm (alarm_off)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.
luxadm [ -v ] alarm_off { pathname | controller tray-number }
Table 2-14 alarm_off Options and Arguments
Enabling the Alarm (alarm_on)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.
luxadm [ -v ] alarm_on { pathname | controller tray-number }
Table 2-15 alarm_on Options and Arguments
Setting the Alarm (alarm_set)Use the alarm_set subcommand to set the duration of the audible alarm to a specified number of seconds.
luxadm [ -v ] alarm_set { pathname | controller tray-number } [seconds]
Table 2-16 alarm_set Options and Arguments
Performing Enclosure and Disk OperationsRenaming a StorEdge A5000 Disk Array (enclosure_name)Use the enclosure_name subcommand to change the enclosure name of one or more StorEdge A5000 disk arrays. The new name must be 16 or less characters. The only allowed characters are alphabetic or numeric digits.
luxadm [ -v ] enclosure_name new-name enclosure... | pathname... Table 2-17 enclosure_name Options and Arguments
Collecting Performance Statistics (perf_statistics)Use the perf_statistics subcommand to enable or disable the accumulation of performance statistics for a specific SPARCstorage Array controller.
Note - The accumulation of performance statistics must be enabled before the display -p subcommand can be used. luxadm [ -v ] perf_statistics [ -e ] pathname Table 2-18 perf_statistics Options and Arguments
Powering Off an Enclosure or Disk Drive (power_off)Use the power_off subcommand to set an enclosure to the power-save mode. Note - StorEdge A5000 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 StorEdge A5000 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.
luxadm [ -v ] power_off { enclosure[,dev]... | pathname...}
Table 2-19 power_off Options and Arguments
Powering On Enclosures or Disk Drives (power_on)Use the power_on subcommand to set a drive to its normal power-on state. If you specify a StorEdge A5000 disk drive, the power_on subcommand sets the specified disks to the normal start-up state.
luxadm [ -v ] power_on { enclosure[,dev]... | pathname...}
Table 2-20 power_on Options and Arguments
Releasing Disks (release)Use the release subcommand to release one or more disk drives from reservation.
luxadm [ -v ] release { pathname...}
Table 2-21 release Options and Arguments
Reserving Disks (reserve)Use the reserve subcommand to reserve the specified disk(s) for exclusive use by the host from which the subcommand was issued.
luxadm [ -v ] reserve { pathname...}
Table 2-22 reserve Options and Arguments
Setting the Boot Device Variable (set_boot_dev)Use the set_boot_dev subcommand to set the boot-device variable in the system PROM to a physical device name. The set_boot_device subcommand normally runs interactively; it requests confirmation for setting the default boot-device in the PROM.
luxadm [ -v ] set_boot_dev [ -y ] pathname Table 2-23 set_boot_dev Options and Arguments
Starting Disks (start)Use the start subcommand to spin up one or more disks.
luxadm [ -v ] start [ -t tray-number ] pathname Table 2-24 start Options and Arguments
Stopping Disks (stop)Use the stop subcommand to spin down one or more disks.
luxadm [ -v ] stop [ -t tray-number ] pathname Table 2-25 stop Options and Arguments
Displaying and Setting NVRAMEnabling and Disabling Fast Write (fast_write )Use the fast_write subcommand to enable or disable the use of the NVRAM to enhance the performance of writes in the SPARCstorage Array.
luxadm [ -v ] fast_write [-s] -c pathname Table 2-26 fast_write Options and Arguments
Displaying Fast Write Data (nvram_data)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.
luxadm [ -v ] nvram_data pathname Table 2-27 nvram_data Options and Arguments
Purging Fast Write Data from NVRAM (purge)Use the purge subcommand to purge any fast write data from NVRAM for one or more disks.
Caution - Use the purge subcommand with caution, usually only when a drive has failed. luxadm [ -v ] purge pathname Table 2-28 purge Options and Arguments
Flushing NVRAM (sync_cache)Use the sync_cache subcommand to flush all outstanding writes for one or more disks from NVRAM to the media
luxadm [ -v ] sync_cache pathname Table 2-29 sync_cache Options and Arguments
Removing, Inserting, and Replacing Enclosures and DisksThis 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 StorEdge A5000 disk array, see Chapter 3, StorEdge A5000 Disk Array Hot-Plugging Procedures and refer to the Sun StorEdge A5000 Installation and Service Manual. Removing Devices (remove_device )Use the remove_device subcommand to hot remove a disk drive, enclosure, or a chain of enclosures. This subcommand interactively guides you through the hot removal of one or more devices.
In the StorEdge A5000 disk array, the remove_device subcommand:
In the SPARCstorage RSM, the remove_device subcommand:
luxadm [ -v ] remove_device [ -F ] { enclosure,dev... | pathname... }
Table 2-30 remove_device Options and Arguments
# luxadm remove_device macs1,f1 WARNING!!! Please ensure that no filesystems are mounted on these device(s). All data on these devices should have been backed up. The list of devices which will be removed is: 1: Box Name "macs1" frontslot 1 Please enter 'q' to Quit OR <Return> to Continue: stopping: Drive in "macs1" front slot 1....Done offlining: Drive in "macs1" front slot 1....Done Hit <Return> after removing the device(s). You must physically remove the device at this time. After you hit a key, the following is displayed:
Drive in Box Name "macs1" front slot 1
Removing Logical Nodes:
Removing c2t1d0s0
Removing c2t1d0s1
Removing c2t1d0s2
Removing c2t1d0s3
Removing c2t1d0s4
Removing c2t1d0s5
Removing c2t1d0s6
Removing c2t1d0s7
#
Inserting Devices (insert_device)Use the insert_device subcommand for hot insertion of a new disk drive, enclosure, or chain of enclosures. If you specify more than one enclosure, you can perform concurrent hot insertions on multiple buses.
The insert_device subcommand interactively guides you through the hot insertion of one or more devices. In the StorEdge A5000 disk array the insert_device subcommand:
In the SPARCstorage RSM, the insert_device subcommand:
luxadm [ -v ] insert_device enclosure,dev... Table 2-31 insert_device Options and Arguments
# luxadm insert_device, macs1,f1 The list of devices which will be inserted is: 1: Box Name "macs1" front slot 1 Please enter 'q' to Quit or <Return> to Continue: Hit <Return> after inserting the device(s). You must physically install the disk drive at this time. After hitting any key, the following 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 # Replacing Devices (replace_device)Use the replace_device subcommand to hot replace a device. The replace_device subcommand interactively guides you through the hot insertion of one or more devices. The replace_device subcommand:
luxadm [ -v ] replace_device [ -F ] pathname Table 2-32 replace_device Options and Arguments
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|