CHAPTER 2

luxadm Subcommands

---

---

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.

Sun Enterprise Network Array	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Supported

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

TABLE 2-1 led

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

Example:

# 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

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.

Sun Enterprise Network Array	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Not Supported

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

TABLE 2-2 led_blink

Option/Argument	Description
enclosure	1 is the enclosure name of a Sun Enterprise Network 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.

Sun Enterprise Network Array	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 Sun Enterprise Network 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 Sun Enterprise Network Array this may or may not cause the yellow LED to turn off or stop blinking depending on the state of the Sun Enterprise Network Array. Refer to Sun Enterprise Network Array Instalationl 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.

Sun Enterprise Network Array	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 Sun Enterprise Network Arrays

Use the probe subcommand to display information about all attached Sun Enterprise Network Array. Information displayed includes the logical pathnames, the WWNs, and the enclosure names.

Sun Enterprise Network Array	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:dogbert Node WWN:1234123412341234 Logical Path:/dev/es/ses0 Logical Path:/dev/es/ses1 #

Example:

# luxadm probe -p Found SENA Name:dogbert Node WWN:1234123412341234 Logical Path:/dev/es/ses0 Physical Path:/devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/ ses@w1234123412341235,0:0 Logical Path:/dev/es/ses1 Physical Path:/devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/ ses@w1234123412341236,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.

Sun Enterprise Network Array	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 Sun Enterprise Network Array .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a Sun Enterprise Network Array, SPARCstorage Array, or a specific disk in an array1.

TABLE 2-6 display

Option/Argument	Description
-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 dogbert (luxadm version: 1.23 97/05/22) SENA DISK STATUS SLOT FRONT DISKS (Node WWN) REAR DISKS (Node WWN) 0 On (O.K.) 20000020370412ec On (O.K.) 200000203704141d 1 On (O.K.) 20000020370412e7 On (O.K.) 2000002037041375 2 On (O.K.) 2000002037041397 On (O.K.) 20000020370412be 3 On (O.K.) 200000203704139f On (O.K.) 2000002037041433 4 On (O.K.) 2000002037041418 On (O.K.) 2000002037041348 5 On (O.K.) 200000203704140f On (O.K.) 2000002037041333 6 On (O.K.) 200000203704143d On (O.K.) 2000002037041382 SUBSYSTEM STATUS Revision Level: 0.16 Node WWN: 1234123412341234Enclosure Name: dogbert Power Supplies (0,2 in front, 1 in rear) 0 O.K.(REV 0)1 O.K.(REV 0)2 O.K.(REV 0) Fans (0 in front, 1 in rear) 0 O.K.(REV 0)1 O.K.(REV 0) ESI Interface board(IB) (A top, B bottom) A: O.K. (mmma) GBIC module (1 on left, 0 on right in IB) 0 Not Installed1 O.K.(MODn) B: Not Installed Disk backplane (0 in front, 1 in rear) Temperature sensors (on front backplane) 0:42.C 1:42.C 2:40.C 3:39.C 4:40.C 5:40.C 6:42.C (All temperatures are NORMAL.) Temperature sensors (on rear backplane) 0:43.C 1:42.C 2:42.C 3:40.C 4:42.C 5:42.C 6:43.C (All temperatures are NORMAL.) Loop configurationThe loop is configured as a single loop. Language USA English #

Example:

# luxadm display -r dogbert (luxadm version: 1.23 97/05/22) SENA Information for FC Loop on port 0 of SOC+ Host Adapter at path: /devices/sbus@3,0/SUNW,socal@0,0:0 Version Resets Req_Q_Intrpts Qfulls Requests Sol_Resps Unsol_Resps Lips 1 2 0 0 0 0 0 1 Els_sent Els_rcvd Abts Abts_ok Offlines Onlines Online_loops 0 0 0 0 0 0 1 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 9e 0 0 0 0 0 0 0 b2 0 0 0 0 0 0 0 b1 0 0 0 0 0 0 0 ae 0 0 0 0 0 0 0 ad 0 0 0 0 0 0 0 ac 0 0 0 0 0 0 0 ab 0 0 0 0 0 0 0 aa 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 75 0 0 0 0 0 0 0 98 0 0 0 0 0 0 0 97 0 0 0 0 0 0 0 90 0 0 0 0 0 0 0 8f 0 0 0 0 0 0 0 88 0 0 0 0 0 0 0 84 0 0 0 0 0 0 0 82 0 0 0 0 0 0 0 #

Displaying inquiry Information

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

Sun Enterprise Network Array	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 Sun Enterprise Network Array .
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 Sun Enterprise Network Array, SPARCstorage Array, or a specific disk in an array.1

Example:

# luxadm inquiry dogbert INQUIRY: Physical path: /devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/ses@w1234123412341235,0:0 Vendor: SUN Product: SENA Revision: 0.16 Device type: 0xd (Enclosure services 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 35 12 34 12 34 12 34 12 34 00 00 00 00 00 00 00 00 .4.4.4.4........ 00 00 00 00 .... 95 64 6f 67 62 65 72 74 00 00 00 00 00 00 00 00 00 dogbert......... 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 Sun Enterprise Network Array Interface Board or on a SPARCstorage Array controller board.

In a Sun Enterprise Network Array, when the download is complete, the Sun Enterprise Network Array subsystem 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.

Sun Enterprise Network Array	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 Sun Enterprise Network 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 Sun Enterprise Network 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 Sun Enterprise Network Array 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 17.
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.

Sun Enterprise Network Array	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 SPARCstorage Array's World Wide Name. 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 in a SPARCstorage Array

Use the fc_s_download subcommand to download new fcode into all the FC/S Sbus Cards.

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.

---

Sun Enterprise Network Array	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 in a Sun Enterprise Network Array

Use the fcal_s_download subcommand to download new fcode into ALL the FC100/S Sbus Cards or to display the current version of the fcode in each FC100/S Sbus card

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.

---

Sun Enterprise Network Array	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 SSA's controller.

Displaying Environmental Information

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

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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 Sun Enterprise Network Array

Use the enclosure_name new_name subcommand to change the enclosure name of one or more Sun Enterprise Network Arrays. The new name must be 16 or less characters. The only allowed characters are alphabetic or numeric digits.

Sun Enterprise Network Array	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 Sun Enterprise Network Array .
pathname	is the physical or logical path name of a Sun Enterprise Network Array1.
1 See "Addressing a Sun Enterprise Network 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.

---

Sun Enterprise Network Array	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 - The Sun Enterprise Network Array 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 Enterprise Network Array 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.

Sun Enterprise Network Array	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 Sun Enterprise Network Array .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a Sun Enterprise Network Array, 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 Sun Enterprise Network Array disk drive, the power_on subcommand sets the specified disks to the normal start-up state.

Sun Enterprise Network Array	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 Sun Enterprise Network Array .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a Sun Enterprise Network Array or a specific disk in an array1.
1 See "Addressing a Sun Enterprise Network Array" on page 2.

Releasing Disks

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

Sun Enterprise Network Array	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Supported

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

TABLE 2-20 release

Option/Argument	Description
enclosure	1 is the enclosure name of a Sun Enterprise Network Array .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a Sun Enterprise Network 1 Array, 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.

Sun Enterprise Network Array	SPARCstorage Array	SPARCstorage RSM
Supported	Supported	Supported

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

TABLE 2-21 reserve

Option/Argument	Description
enclosure	1 is the enclosure name of a Sun Enterprise Network Array .
dev	1 is the name of a specific disk in an enclosure .
pathname	is the physical or logical path name of a Sun Enterprise Network Array, 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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

Sun Enterprise Network Array	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.

---

Remove, Insert, Replace

Removing Devices

Use the remove_device subcommand to hot remove a device or a chain of devices.

The remove_device subcommand interactively guides you through the hot removal of one or more devices. In the Sun Enterprise Network 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 removeda.

Sun Enterprise Network Array	SPARCstorage Array	SPARCstorage RSM
Supported	Not Supported	Supported

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

TABLE 2-29 remove_device

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

Example:

# luxadm remove_device macs3,r1 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 "macs3" rear slot 1 Please enter 'q' to Quit OR <Return> to Continue: offlining: Drive in "macs3" rear slot 1 Hit any key after inserting/removing drives:

You must physically remove the device at this time. After you hit a key, the following is displayed:

Drive in Box Name "macs3" rear slot 1 Removing Logical Nodes: Removing /dev/dsk/c1t81d0s0 Removing /dev/rdsk/c1t81d0s0 Removing /dev/dsk/c1t81d0s1 Removing /dev/rdsk/c1t81d0s1 Removing /dev/dsk/c1t81d0s2 Removing /dev/rdsk/c1t81d0s2 Removing /dev/dsk/c1t81d0s3 Removing /dev/rdsk/c1t81d0s3 Removing /dev/dsk/c1t81d0s4 Removing /dev/rdsk/c1t81d0s4 Removing /dev/dsk/c1t81d0s5 Removing /dev/rdsk/c1t81d0s5 Removing /dev/dsk/c1t81d0s6 Removing /dev/rdsk/c1t81d0s6 Removing /dev/dsk/c1t81d0s7 Removing /dev/rdsk/c1t81d0s7 #

Inserting Devices

Use the insert_device subcommand for hot insertion of a new device or a chain of new devices. 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 Sun Enterprise Network 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.

Sun Enterprise Network Array	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 Sun Enterprise Network Array .
dev	1 is the name of a specific disk in an enclosure .
1 See "Addressing a Sun Enterprise Network Array" on page 2.

Example:

# luxadm insert_device Please hit <enter> when you have finished adding the device(s):

You must physically install the disk drive at this time. After hitting any key, the following is displayed:

Waiting for Loop Initialization to complete... New Logical Nodes under /dev/es: New Logical Nodes under /dev/dsk and /dev/rdsk : c1t81d0s0 c1t81d0s1 c1t81d0s2 c1t81d0s3 c1t81d0s4 c1t81d0s5 c1t81d0s6 c1t81d0s7 #

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

Sun Enterprise Network Array	SPARCstorage Array	SPARCstorage RSM
Not Supported	Not Supported	Supported

luxadm [ -v ] replace_device pathname

TABLE 2-31 replace_device

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