This chapter discusses the luxadm subcommands and is divided into the following sections:
For information on how to specify (address) a disk array, see "Addressing".
The 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
Subcommand |
StorEdge A5000 |
SPARCstorage Array |
SPARCstorage RSM |
---|---|---|---|
yes | yes | ||
| yes | yes | |
| yes | yes | |
yes | yes |
|
|
yes | yes |
|
|
yes |
|
|
|
|
| yes | |
| yes |
|
|
| yes |
|
|
yes |
|
|
|
yes | yes | yes | |
yes |
| yes | |
yes | yes | yes | |
yes |
|
|
|
yes | yes |
|
|
| yes | yes | |
| yes |
|
|
| yes |
|
|
yes | yes |
|
|
yes |
|
|
|
yes |
|
|
|
| yes |
|
|
yes | yes | yes | |
yes |
| yes | |
|
| yes | |
yes | yes |
|
|
n/a |
n/a |
n/a |
|
| yes |
|
|
| yes |
|
|
| yes |
|
Use the led subcommand to check the current state of the yellow LED associated with a specific disk.
StorEdge A5000
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] led { enclosure,dev... | pathname...}
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in an enclosure |
pathname |
The physical or logical path name of a specific disk in an array |
# 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 #
Use the led_blink subcommand to make the yellow LED associated with a specific disk blink or flash.
StorEdge A5000
luxadm [ -v ] led_blink { enclosure,dev... | pathname...}
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in an enclosure |
pathname |
The physical or logical path name of a specific disk in an array |
# 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 #
Use the led_off subcommand to turn off the yellow LED associated with a specific disk.
StorEdge A5000
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] led_off { enclosure,dev... | pathname...}
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in an enclosure |
pathname |
The physical or logical path name of a specific disk in an array |
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 #
Use the led_on subcommand to turn on the yellow LED associated with a specific disk.
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] led_on pathname
Option/Argument |
Description |
---|---|
dev |
The name of a specific disk in an enclosure |
pathname |
The physical or logical path name of a specific disk in an array |
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.
StorEdge A5000
luxadm [ -v ] probe [-p]
Option |
Description |
---|---|
-p |
Also displays the physical path name |
# 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 #
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.
StorEdge A5000
SPARCstorage Array
luxadm [ -v ] display enclosure[,dev]... | pathname...
Option/Argument |
Description |
---|---|
-v |
Displays mode sense data |
enclosure |
The enclosure name of a StorEdge A5000 |
dev |
The name of a specific disk in an enclosure |
pathname |
The physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array |
-p |
Displays performance information for the specified device or subsystem |
-r |
Displays error information for the specified device or subsystem |
# 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
Use the inquiry subcommand to display inquiry information for a specific disk
StorEdge A5000
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] inquiry { enclosure[,dev]... | pathname...}
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 |
dev |
The name of a specific disk in an enclosure |
pathname |
The physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array |
# 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 ................ #
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.
StorEdge A5000
SPARCstorage Array
luxadm [ -v ] download [-s] [-f filename-path ]
When using the -s option, the download modifies the FEPROM in the StorEdge A5000 disk array.
The -s option does not apply to the SPARCstorage Array controller, as it always writes the downloaded firmware into the FEPROM.
Option/Argument |
Description |
---|---|
-s |
Saves the downloaded firmware in the FEPROM in a StorEdge A5000 disk array . If -s is not specified, the downloaded firmware will not be saved across power cycles. |
-f filename |
Downloads the prom image in filename. If you do not specify a filename, the default prom image is used. The default prom image in a StorEdge A5000 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. |
-w WWN |
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.
SPARCstorage Array
luxadm [ -v ] download [-w WWN] pathname
Option/Argument |
Description |
---|---|
pathname |
A SPARCstorage Array controller |
-w WWN |
Changes the World Wide Name for the SPARCstorage Array. WWN is a twelve-digit hex number; leading zeros are required. The new SPARCstorage Array controller's image will have the least-significant 6 bytes of the 8-byte WWN modified to WWN. |
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.
SPARCstorage Array
Ensure that you download the usr/lib/firmware/fc_s/fc_s_fcode file.
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]
Option |
Description |
---|---|
-F |
Forcibly downloads the fcode. The subcommand expects user confirmation before the download. |
-f fcode-file |
The name of the file that has the new fcode. When the fc_s_download subcommand is invoked without the [-f fcode-file] option, the current version of the fcode in each FC/S SBus card is printed. |
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.
StorEdge A5000
Ensure that you download the /usr/lib/firmware/fc_s/fcal_s_fcode file.
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 ]
Option |
Description |
---|---|
-f fcode-file |
This is the name of the file that has the new fcode. If you invoke the fcal_s_download subcommand without the [ -f fcode-file ] option, the current version of the fcode in each FC100/S SBus card is displayed. The version of the FC100/S SBus Cards fcode released with the operating system is located in the directory usr/lib/firmware/fc_s and is named fcal_s_fcode. |
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.
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] env_display { pathname | controller tray-number }
Option/Argument |
Description |
---|---|
pathname |
The path to an SES device |
controller |
The path to a SPARCstorage Array controller |
tray-number |
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.
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] alarm_off { pathname | controller tray-number }
Option/Argument |
Description |
---|---|
pathname |
The path to an SES device |
controller |
iThe path to a SPARCstorage Array controller |
tray-number |
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.
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] alarm_on { pathname | controller tray-number }
Option/Argument |
Description |
---|---|
pathname |
The path to an SES device |
controller |
The path to a SPARCstorage Array controller |
tray-number |
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.
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] alarm_set { pathname | controller tray-number } [seconds]
Option/Argument |
Description |
---|---|
pathname |
The path to an SES device |
controller |
The path to a SPARCstorage Array controller |
tray-number |
An RSM tray number. tray-number is valid only for an RSM tray in a SPARCstorage Array |
seconds |
The number of seconds |
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.
StorEdge A5000
luxadm [ -v ] enclosure_name new-name enclosure... | pathname...
Option/Argument |
Description |
---|---|
new-name |
The new enclosure name |
enclosure |
The enclosure name of a StorEdge A5000 disk array |
pathname |
The physical or logical path name of a StorEdge A5000 disk array |
Use the perf_statistics subcommand to enable or disable the accumulation of performance statistics for a specific SPARCstorage Array controller.
SPARCstorage Array
The accumulation of performance statistics must be enabled before the display -p subcommand can be used.
luxadm [ -v ] perf_statistics [ -e ] pathname
Option/Argument |
Description |
---|---|
pathname |
A SPARCstorage Array controller |
-e |
Enables the accumulation of performance statistics |
Use the power_off subcommand to set an enclosure to the power-save mode.
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.
StorEdge A5000
SPARCstorage Array
luxadm [ -v ] power_off { enclosure[,dev]... | pathname...}
Option/Argument |
Description |
---|---|
enclosure |
is the enclosure name of a StorEdge A50001. |
dev |
is the name of a specific disk in an enclosure1. |
pathname |
is the physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array1. |
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.
StorEdge A5000
luxadm [ -v ] power_on { enclosure[,dev]... | pathname...}
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in a disk array |
pathname |
The physical or logical path name of a StorEdge A5000 disk array or a specific disk in a disk array |
Use the release subcommand to release one or more disk drives from reservation.
StorEdge A5000
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] release { pathname...}
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in a disk array |
pathname |
The physical or logical path name of a StorEdge A5000 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.
StorEdge A5000
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] reserve { pathname...}
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in a disk array |
pathname |
The physical or logical path name of a StorEdge A5000 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_device subcommand normally runs interactively; it requests confirmation for setting the default boot-device in the PROM.
StorEdge A5000
SPARCstorage Array
SPARCstorage RSM
luxadm [ -v ] set_boot_dev [ -y ] pathname
Option/Argument |
Description |
---|---|
pathname |
A block special device or a mount-point |
-y |
Runs non-interactively; no confirmation is requested or required |
Use the start subcommand to spin up one or more disks.
SPARCstorage Array
luxadm [ -v ] start [ -t tray-number ] pathname
Option/Argument |
Description |
---|---|
-t tray-number |
The tray number |
pathname |
The physical or logical path name of a SPARCstorage Array, or a specific disk in a disk array |
Use the stop subcommand to spin down one or more disks.
SPARCstorage Array
luxadm [ -v ] stop [ -t tray-number ] pathname
Option/Argument |
Description |
---|---|
-t tray-number |
is the tray number. |
pathname |
is the physical or logical path name of a SPARCstorage Array, or a specific disk in a disk array |
Use the fast_write subcommand to enable or disable the use of the NVRAM to enhance the performance of writes in the SPARCstorage Array.
SPARCstorage Array
luxadm [ -v ] fast_write [-s] -c pathname
Option/Argument |
Description |
---|---|
pathname |
A SPARCstorage Array controller or an individual disk |
-e |
Causes the SPARCstorage Array to save the change so it will persist across power-cycles |
-c |
Enables fast writes for synchronous writes only |
-e |
Enables fast writes |
-d |
Disables fast writes |
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.
SPARCstorage Array
luxadm [ -v ] nvram_data pathname
Option/Argument |
Description |
---|---|
pathname |
A SPARCstorage Array controller or an individual disk |
Use the purge subcommand to purge any fast write data from NVRAM for one or more disks.
SPARCstorage Array
Use the purge subcommand with caution, usually only when a drive has failed.
luxadm [ -v ] purge pathname
Option/Argument |
Description |
---|---|
pathname |
A SPARCstorage Array controller or an individual disk. If you specify a SPARCstorage Array controller, fast write data for all disks associated with that controller will be purged |
Use the sync_cache subcommand to flush all outstanding writes for one or more disks from NVRAM to the media
SPARCstorage Array
luxadm [ -v ] sync_cache pathname
Option/Argument |
Description |
---|---|
pathname |
A SPARCstorage Array controller or an individual disk. If you specify a SPARCstorage Array controller, outstanding writes for all disks associated with that controller will be flushed |
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 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.
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.
StorEdge A5000
SPARCstorage RSM
In the StorEdge A5000 disk array, the remove_device subcommand:
Checks whether the device is busy and if so warns you.
Offlines the device (this fails if the disk is open).
Informs you when device(s) can be safely removed.
Informs you which device to remove by blinking the activity LED on the enclosure.
Requests confirmation that the list(s) is/are as expected.
Removes the logical device(s) names for the device that was removed.
In the SPARCstorage RSM, the remove_device subcommand:
Takes the device offline.
Quiesces the bus for buses that support quiescing.
Informs you that the device can be safely replaced.
Requests confirmation that the device has been replaced.
Unquiesces the bus for buses that support quiescing.
Brings the (now removed) device back online.
Removes the logical device name for the device that was removed.
luxadm [ -v ] remove_device [ -F ] { enclosure,dev... | pathname... }
Option/Argument |
Description |
---|---|
-F |
Forces the hot-plugging 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-plugging checks. |
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in a disk array |
pathname |
The physical or logical path name of a StorEdge A5000 or a specific disk in an array |
# 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 #
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.
StorEdge A5000
SPARCstorage RSM
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:
Informs you when the device(s) can be safely inserted.
Requests confirmation that the list(s) is as expected.
Creates the logical device names for the new devices.
Displays the logical path name for the devices.
In the SPARCstorage RSM, the insert_device subcommand:
Quiesces the bus for buses that support quiescing.
Informs you that the device can be safely inserted.
Requests confirmation that the device has been inserted.
Unquiesces the bus for buses that support quiescing.
Creates the logical device name for the new device.
luxadm [ -v ] insert_device enclosure,dev...
Option/Argument |
Description |
---|---|
enclosure |
The enclosure name of a StorEdge A5000 disk array |
dev |
The name of a specific disk in a disk array |
# 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 #
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:
Takes the device offline.
Quiesces the bus for buses that support quiescing.
Informs you that the device can be safely replaced.
Requests confirmation that the device has been replaced.
Unquiesces the bus for buses that support quiescing.
Brings the device back online.
SPARCstorage RSM
luxadm [ -v ] replace_device [ -F ] pathname
Option/Argument |
Description |
---|---|
-F |
Forces the hot-plugging operation on one or more devices even if those devices are being used by the host (and are, therefore, busy). Caution-- Replacing devices which 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-plugging checks. |
pathname |
A SPARCstorage Array controller or an individual disk |