CHAPTER 2

luxadm Subcommands

---

This chapter discusses the luxadm subcommands and is divided into the following sections:

• Disk LEDs--page 7
• Displaying--page 10
• Downloading--page 17
• Enclosure Services Card--page 21
• Enclosure and Disk Operations--page 24
• NVRAM--page 30
• Removing, Inserting, and Replacing--page 33

---

Disk LEDs

Displaying the Current State of a Disk LED

Use the led subcommand to display the current state of the yellow LED associated with a specific disk.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Supported

luxadm [ -v ] led { enclosure,dev... | pathname...}

TABLE 2-1 led Options and Arguments

Option/Argument Description 1 enclosureis the enclosure name of a StorEdge A5000 disk array . 1 devis the name of a specific disk in an enclosure . 1 pathnameis the physical or logical path name of a specific disk in an array . 1See "Addressing" on page 2. Example: Setting a Disk LED to the Blink Mode Use the led_blink subcommand to start blinking (flashing) the yellow LED associated with a specific disk. The led_blink subcommand only applies to subsystems that support this functionality. StorEdge A5000 SPARCstorage Array SPARCstorage RSM Supported Not Supported Not Supported

# 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 #

luxadm [ -v ] led_blink { enclosure,dev... | pathname...}

TABLE 2-2 led_blink

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 disk array .
dev	1 is the name of a specific disk in an enclosure .
pathname	1 is the physical or logical path name of a specific disk in an array .
1 See "Addressing" on page 2.

Example:

# 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

Use the led_off subcommand to turn off the yellow LED associated with a specific disk.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Supported

luxadm [ -v ] led_off { enclosure,dev... | pathname...}

TABLE 2-3 led_off

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 disk array .
dev	1 is the name of a specific disk in an enclosure .
pathname	1 is the physical or logical path name of a specific disk in an array .
1 See "Addressing" on page 2.

---

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.

---

Example:

# 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

Use the led_on subcommand to turn on the yellow LED associated with a specific disk.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Supported

luxadm [ -v ] led_on pathname

TABLE 2-4 led_on

Option/Argument	Description
dev	1 is the name of a specific disk in an enclosure .
pathname	1 is the physical or logical path name of a specific disk in an array .
1 See "Addressing" on page 2.

---

Displaying

Probing for StorEdge A5000 Disk Arrays

Use the probe subcommand to display information about all attached StorEdge A5000 disk arrays. Information displayed includes the logical pathnames, the WWNs, and the enclosure names.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Not Supported

luxadm [ -v ] probe [-p]

TABLE 2-5 probe

Option	Description
-p	also displays the physical pathname.

Example:

# luxadm probe Found SENA Name:macs1 Node WWN:1234123412341234 Logical Path:/dev/es/ses0 Logical Path:/dev/es/ses1 #

Example:

# 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

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	SPARCstorage RSM
Supported	Supported	Not Supported

luxadm [ -v ] display enclosure[,dev]... | pathname...

TABLE 2-6 display

Option/Argument	Description
-v	mode sense data is also displayed
enclosure	1 is the enclosure name of a StorEdge A5000 .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array1.
-p	displays performance information for the specified device or subsystem
-r 1See "Addressing" on page 2.	displays error information for the specified device or subsystem

Example:

# 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 #

Example:

# 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 inquiry Information

Use the inquiry subcommand to display inquiry information for a specific disk.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Supported

luxadm [ -v ] inquiry { enclosure[,dev]... | pathname...}

TABLE 2-7 inquiry

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 .
dev	1 is the name of a specific disk in an enclosure .
pathname 1See "Addressing" on page 2.	is the physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array.1

Example:

# 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

Downloading Firmware

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 will be reset and the downloaded code will be 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	SPARCstorage RSM
Supported	Supported	Not Supported

luxadm [ -v ] download [-s] [-f filename-path ]

---

Caution - When using the -s option the download modifies the FEPROM in the StorEdge A5000 disk array and should be used with caution.

---

---

Note - The -s option does not apply to the SPARCstorage Array controller as it always writes the downloaded firmware into the FEPROM.

---

TABLE 2-8 download

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 will be 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 World Wide Name" on page 18.
1 See "Addressing" on page 2.

Changing a SPARCstorage Array World Wide Name

Use the download subcommand to change the World Wide Name of a SPARCstorage Array controller board.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] download [-w WWN] pathname

TABLE 2-9

Option/Argument	Description
pathname	is 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 World Wide Name modified to WWN.

Downloading fcode to a FC25/S Host Adapters

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 which connects to SPARCstorage Arrays.)

The fc_s_download subcommand is interactive and expects 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 kept 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.

---

---

Note - The fc_s_download subcommand should be used only in single user mode; otherwise the FC/S card could be reset.

---

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] fc_s_download [-F] [-f fcode-file]

TABLE 2-10 fc_s_download

Option	Description
-F	Forcibly downloads the fcode. The subcommand still expects user confirmation before the download.
-f fcode-file	is 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.

Downloading fcode to FC100 Host Adapters

Use the fcal_s_download subcommand to download new fcode into sll 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 100MHz host adapter card which connects to StorEdge A5000 disk arrays.)

When downloading new fcode, the fcal_s_download subcommand is interactive and expects 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 dowload the fcode.

---

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Not Supported

luxadm [ -v ] fcal_s_download [ -f fcode-file ]

TABLE 2-11 fcal_s_download

Option	Description
-f fcode-file	fcode-file 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 this operating system is kept in the directory usr/lib/firmware/fc_s and is named fcal_s_fcode.

---

Enclosure Services Card

The env_display and 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 inthe SSA .

Displaying Environmental Information

Use the env_display subcommand to display the environmental information for a SPARCstorage Array.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Supported

luxadm [ -v ] env_display { pathname | controller tray-number }

TABLE 2-12 env_display

Option/Argument	Description
pathname	1 is the path to an SES device .
controller	1 is the path to a SPARCstorage Array controller .
tray-number	is an RSM tray number. tray-number is only valid for an RSM tray in a SPARCstorage Array.
1See "Addressing a SPARCstorage Array" on page 3.

Disabling the Alarm

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.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Supported

luxadm [ -v ] alarm_off { pathname | controller tray-number }

TABLE 2-13 alarm_off

Option/Argument	Description
pathname	1 is the path to an SES device .
controller	1 is the path to a SPARCstorage Array controller .
tray-number	is an RSM tray number. tray-number is only valid for an RSM tray in a SPARCstorage Array.
1 See "Addressing a SPARCstorage Array" on page 3.

Enabling the Alarm

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.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Supported

luxadm [ -v ] alarm_on { pathname | controller tray-number }

TABLE 2-14 alarm_on

Option/Argument	Description
pathname	1 is the path to an SES device .
controller	1 is the path to a SPARCstorage Array controller .
tray-number	is an RSM tray number. tray-number is only valid for an RSM tray in a SPARCstorage Array.
1 See "Addressing a SPARCstorage Array" on page 3.

Setting the Alarm

Use the alarm_set subcommand to set the duration of the audible alarm to a specified number of seconds.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Supported

luxadm [ -v ] alarm_set { pathname | controller tray-number } [seconds]

TABLE 2-15 alarm_set

Option/Argument	Description
pathname	1 is the path to an SES device .
controller	1 is the path to a SPARCstorage Array controller .
tray-number	is an RSM tray number. tray-number is only valid for an RSM tray in a SPARCstorage Array.
seconds	is the number of seconds.
1 See "Addressing a SPARCstorage Array" on page 3.

---

Enclosure and Disk Operations

Renaming a StorEdge A5000 Disk Array

Use the enclosure_name new_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	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Not Supported

luxadm [ -v ] enclosure_name #### enclosure... | pathname...

TABLE 2-16 enclosure_name

Option/Argument	Description
####	is the new enclosure name.
enclosure	1 is the enclosure name of a StorEdge A5000 .
pathname	1 is the physical or logical path name of a StorEdge A5000 .
1 See "Addressing a StorEdge A5000 Disk Array" on page 2.

Collecting Performance 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 using the display -p subcommand.

---

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] perf_statistics [ -e ] pathname

TABLE 2-17 perf_statistics

Option/Argument	Description
pathname	1 is a SPARCstorage Array controller .
-e	Enable the accumulation of performance statistics.
1 See "Addressing a SPARCstorage Array" on page 3.

Powering Off an Enclosure or Disk Drive

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 set to the drive off/unmated state, the drive is spun down (stopped) and put in the bypass mode.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Not Supported

luxadm [ -v ] power_off { enclosure[,dev]... | pathname...}

TABLE 2-18 power_off

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array1.
1 See "Addressing" on page 2.

Powering On Enclosures or Disk Drives

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	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Not Supported

luxadm [ -v ] power_on { enclosure[,dev]... | pathname...}

TABLE 2-19 power_on

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a StorEdge A5000 or a specific disk in an array1.
1 See "Addressing a StorEdge A5000 Disk Array" on page 2.

Releasing Disks

Use the release subcommand to release one or more disk drives from reservation.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Supported

luxadm [ -v ] release { pathname...}

TABLE 2-20 release

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a StorEdge A5000, 1 SPARCstorage Array, or a specific disk in an array .
1 See "Addressing" on page 2.

Reserving Disks

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
Supported	Supported	Supported

luxadm [ -v ] reserve { pathname...}

TABLE 2-21 reserve

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array1.
1 See "Addressing" on page 2.

Setting the Boot Device Variable

Use the set_boot_dev subcommand to set the boot-device variable in the system PROM to 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
n/a	n/a	n/a

luxadm [ -v ] set_boot_dev [ -y ] pathname

TABLE 2-22 set_boot_dev

Option/Argument	Description
pathname	1 is a block special device or a mount-point .
-y	runs non-interactively; no confirmation is requested or required.
1 See "Addressing" on page 2.

Starting Disks

Use the start subcommand to spin up one or more disks.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] start [ -t tray number ] pathname

TABLE 2-23 start

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 an array1.
1 See "Addressing" on page 2.

Stopping Disks

Use the stop subcommand to spin down one or more disks.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] stop [ -t tray-number ] pathname

TABLE 2-24 stop

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 an array1.
1 See "Addressing" on page 2.

---

NVRAM

Enabling and Disabling Fast Writes

Use the fast_write subcommand to enable or disable the use of the NVRAM to enhance the performance of writes in the SPARCstorage Array.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] fast_write [-s] -c pathname

TABLE 2-25 fast_write

Option/Argument	Description
pathname	pathname is a SPARCstorage Array controller or an individual disk1.
-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.
1 See "Addressing a SPARCstorage Array" on page 3.

Displaying Fast Write 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.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] nvram_data pathname

TABLE 2-26 nvram_data

Option/Argument	Description
pathname	pathname is a SPARCstorage Array controller or an individual disk1.
1 See "Addressing a SPARCstorage Array" on page 3.

Purging Fast Write Data from NVRAM

---

Caution - The purge subcommand should be used with caution, usually only when a drive has failed.

---

Use the purge subcommand to purge any fast write data from NVRAM for one or more disks.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] purge pathname

TABLE 2-27 purge

Option/Argument	Description
pathname	is 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 purged1.
1 See "Addressing a SPARCstorage Array" on page 3.

Flushing NVRAM

Use the sync_cache subcommand to flush all outstanding writes for one or more disks from NVRAM to the media.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Supported	Not Supported

luxadm [ -v ] sync_cache pathname

TABLE 2-28 sync_cache

Option/Argument	Description
pathname	is 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 flushed1.
1 See "Addressing a SPARCstorage Array" on page 3.

---

Removing, Inserting, and Replacing

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 and refer to the Sun StorEdge A5000 Installation and Service Manual, part number 802-7573.

Removing Devices

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:

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

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Supported

luxadm [ -v ] remove_device [ -F ] { enclosure,dev... | pathname... }

TABLE 2-29 remove_device

Option/Argument	Description
-F	force 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 which are in use will cause unpredictable results. You should attempt to hot-plug normally (without -F) first, only resorting to this option when you are sure of the consequences of overriding normal hot-plugging checks.
enclosure	1 is the enclosure name of a StorEdge A5000 disk array .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a StorEdge A5000 or a specific disk in an array1.
1 See "Addressing a StorEdge A5000 Disk Array" on page 2.

Example:

# 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

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

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/are 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.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Supported

luxadm [ -v ] insert_device enclosure,dev...

TABLE 2-30 insert_device

Option/Argument	Description
enclosure	1 is the enclosure name of a StorEdge A5000 .
dev	1 is the name of a specific disk in an enclosure .
1 See "Addressing a StorEdge A5000 Disk Array" on page 2.

Example:

# 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

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.

StorEdge A5000	SPARCstorage Array	SPARCstorage RSM
Not Supported	Not Supported	Supported

luxadm [ -v ] replace_device [ -F ] pathname

TABLE 2-31 replace_device

Option/Argument	Description
-F	force 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. You should attempt to hot-plug normally (without -F) first, only resorting to this option when you are sure of the consequences of overriding normal hot-plugging checks.
pathname	pathname is a SPARCstorage Array controller or an individual disk1.
1 See "Addressing a SPARCstorage RSM Tray" on page 4.