C H A P T E R  2

luxadm Subcommands

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


Subcommand Support Matrix

The following table lists the basic luxadm subcommands and indicates which commands are supported on the Sun StorEdge A5x00 disk array, the SPARCstorage Array, SPARCstorage RSM trays, and the Sun Fire 880 internal storage array. See Appendix A for information about expert mode subcommands and their supported platforms.

TABLE 2-1 Subcommand Support Matrix

Subcommand

Sun StorEdge A5x00 Array

SPARCstorage Array

SPARCstorage RSM

Sun Fire 880 Internal Storage Subsystem

alarm_off

yes

yes

alarm_on

yes

yes

alarm_set

yes

yes

display

yes

yes

yes

download

yes

yes

yes

enclosure_name

yes

yes

env_display

yes

fast_write

yes

fc_s_download

yes

fcal_s_download

yes

fcode_download

yes

inquiry

yes

yes

yes

yes

insert_device

yes

yes

yes

led

yes

yes

yes

yes

led_blink

yes

yes

led_off

yes

yes

yes

led_on

yes

yes

nvram_data

yes

perf_statistics

yes

power_off

yes

yes

power_on

yes

probe

yes

yes

purge

yes

qlgc_s_download

yes

yes

release

yes

yes

yes

remove_device

yes

yes

yes

replace_device

yes

reserve

yes

yes

set_boot_dev

n/a

n/a

n/a

start

yes

stop

yes

sync_cache

yes


Subcommand Options

The following options are supported by all subcommands:

-e

Run in expert mode. Use only if you are a qualified system administrator who is knowledgeable about the systems you are managing.

-v

Run in verbose mode.



Checking and Setting Disk LEDs

Checking 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. For a Sun Fire 880 internal disk, this is the OK-to-Remove LED.

Supported on:

Example:

# luxadm led /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w210000203717802c,0:c,raw
LED state is OFF for device in location: front,slot 3
#

Setting a Disk LED to the Blink Mode (led_blink)

Use the led_blink subcommand to make the LED associated with a specific disk blink or flash. For a Sun Fire 880 internal disk, this is the OK-to-Remove LED.

Supported on:

TABLE 2-3 led_blink Options and Arguments

Option/Argument

Description

enclosure

The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information.

dev

The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information.

pathname

The physical path name, logical path name, or WWN of a specific disk in an array.


Example:

# luxadm led_blink dak,s3
LED state is BLINKING for device in location: slot 3
#

Turning Off a Disk LED (led_off)

Use the led_off subcommand to turn off the yellow LED associated with a specific disk. For a Sun Fire 880 internal disk, this is the OK-to-Remove LED.

Supported on:

TABLE 2-4 led_off Options and Arguments

Option/Argument

Description

enclosure

The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information.

dev

The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information.

pathname

The physical path name, logical path name, or WWN of a specific disk in an array.




Note Note - On a Sun StorEdge A5x00 disk array this may or may not cause the yellow OK-to-Remove LED to turn off or stop blinking, depending on the state of the StorEdge A5x00 disk array. Refer to the Sun StorEdge A5x00 Installation and Service Manual for details.



Example:

# luxadm led_off /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w210000203717802c,0:c,raw
LED state is OFF for device in location: front,slot 0
#

Turning On a Disk LED (led_on)

Use the led_on subcommand to turn on the OK-to-Remove LED associated with a specific disk.

Supported on:

TABLE 2-5 led_on Options and Arguments

Option/Argument

Description

pathname

The physical or logical path name of a SPARCStorage Array or a RSM controller ( cN name )



Displaying Enclosure and Disk Information

Probing for Sun StorEdge A5x00 Disk Arrays and Sun Fire 880 Internal Storage Arrays (probe)

Use the probe subcommand to display information about all attached Sun StorEdge A5x00 disk arrays, Sun Fire 880 internal storage arrays, and individual FC-AL devices. The information displayed includes the logical path names, the World Wide Names (WWNs), and the enclosure names.

Supported on:

TABLE 2-6 probe Options and Arguments

Option

Description

-p

Displays the physical path name


The following example shows the enclosure information displayed by the probe subcommand issued to a Sun Fire 880 system (DAKTEST) with an attached Sun StorEdge A5x00 disk array (DRIVEBAY).

Example:

# luxadm probe
Found Enclosure(s):
SUNWGS INT FCBPL   Name: DAKTEST   Node WWN:50000800208618f7
 Logical Path:/dev/es/ses0
 Logical Path:/dev/es/ses1
SENA           Name: DRIVEBAY   Node WWN:500008002000000eda0 
  Logical Path:/dev/es/ses4
  Logical Path:/dev/es/ses5
#

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.

Supported on:

TABLE 2-7 display Options and Arguments

Option/Argument

Description

enclosure

The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information.

dev

The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information.

pathname

The physical or logical path name of a Sun StorEdge A5x00 array or individual disk, SPARCStorage Array, RSM controller ( cN name ), Sun Fire 880 individual disk or enclosure; or the WWN of a Sun Fire 880 disk or SES or a Sun StorEdge A5x00 IB or disk.

-p

Display performance information for the specified device or subsystem.

-r

Display error information for the specified device or subsystem.

-v

Display in verbose mode, including mode sense data.


Example: Display of Sun Fire 880 internal storage array enclosure information

# luxadm display DAKTEST
											 										
SUNWGS INT FCBPL
DISK STATUS 
SLOT   DISKS             (Node WWN) 
0      On (O.K.)         20000020371b1edd    
1      On (O.K.)         20000020371b153f    
2      On (O.K.)         200000203708c412    
3      Not Installed                         
4      Not Installed                         
5      On (O.K.)         20000020371b1f06    
6      On (O.K.)         20000020371b1fa8    
7      On (O.K.)         200000203708c525    
8      On (O.K.)         20000020371b1fe3    
9      Not Installed                         
10     Not Installed                         
11     On (O.K.)         200000203708c468 
SUBSYSTEM STATUS
FW Revision:9203   Box ID:0
Node WWN:50000800208618f7    Enclosure Name:DAKTEST
SSC100's - 0=Base Bkpln, 1=Base LoopB, 2=Exp Bkpln, 3=Exp LoopB 
      SSC100 #0:    O.K.(11.A)
      SSC100 #1:    Not Installed
      SSC100 #2:    O.K.(11.A)
      SSC100 #3:    Not Installed
           Temperature Sensors - 0 Base, 1 Expansion                       
           0:27ºC 1:24ºC  (All temperatures are NORMAL.)   
 
 Default Language is USA English, ASCII 
#

# luxadm display /dev/es/ses5
                                  DISK STATUS 
 SLOT   FRONT DISKS       (Node WWN)          REAR DISKS        (Node WWN)
 0      On (O.K.)         20000020370bd55a    On (O.K.)         20000020370bc45b
 1      On (O.K.)         20000020370bd634    On (O.K.)         20000020370bd23a
 2      On (O.K.)         20000020370b8b7b    On (O.K.)         20000020370bcaba
 3      On (O.K.)         20000020370bd633    On (O.K.)         20000020370bbcb0
 4      On (O.K.)         20000020370bafbe    On (O.K.)         20000020370bab00
 5      On (O.K.)         20000020370bd574    On (O.K.)         20000020370bd55e
 6      On (O.K.)         20000020370bb713    On (O.K.)         20000020370bc835
                                 SUBSYSTEM STATUS
FW Revision:1.09   Box ID:0   Node WWN: 508002000000eda0  Enclosure Name:DRIVEBAY
 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.(mod.-01)
                 1 Not Installed
         B: O.K.(rev.-04)
                 GBIC module (1 on left, 0 on right in IB)
                 0 Not Installed
                 1 Not Installed
 Disk backplane (0 in front, 1 in rear)
         Front Backplane: O.K.(rev.-04)
           Temperature sensors (on front backplane)
           0:34ºC 1:36ºC 2:37ºC 3:36ºC 4:36ºC 5:36ºC 
           6:36ºC  (All temperatures are NORMAL.)
         Rear Backplane:  O.K.(rev.-04)
           Temperature sensors (on rear backplane)
           0:37ºC 1:36ºC 2:34ºC 3:37ºC 4:36ºC 5:37ºC 
           6:36ºC  (All temperatures are NORMAL.)
 Interconnect assembly
         O.K.(rev.-02)
 Loop  configuration
         Loop A is configured as a single loop.
         Loop B is configured as a single loop.
 Language        USA English   
 
#

Example: Display of Sun StorEdge A5x00 enclosure information

Displaying Disk Information (inquiry)

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

Supported on:

TABLE 2-8 inquiry Options and Arguments

Option/Argument

Description

enclosure

The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information.

dev

The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information.

pathname

The physical or logical path name of a Sun StorEdge A5x00 array or individual disk, SPARCStorage Array, RSM controller ( cN name ), Sun Fire 880 individual disk or enclosure; or the WWN of a Sun Fire 880 disk or SES, or a Sun StorEdge A5x00 IB or disk.


Example:

# luxadm inquiry macs1
INQUIRY:
  Physical path:
  /devices/pci@8,700000/pci@2/SUNW,qlc@4/fp@0,0/ses@w5080020000061899,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 fcode

Downloading Firmware (download)

Use the download subcommand to download a PROM image to the FEPROMs on a Sun StorEdge A5x00 disk array IB or a SPARCstorage Array controller board.

Use the download subcommand to restore the original flash image into the flash PROMs on both backplanes on a Sun Fire 880 system.

In a Sun StorEdge A5x00 disk array or Sun Fire 880 internal storage array, when the download is complete, the disk array is reset and the downloaded code is executed.

In a SPARCstorage Array, when the download is complete, you must reset the SPARCstorage Array to execute the downloaded code.

Supported on:

TABLE 2-9 download Options and Arguments

Option/Argument

Description

-s

Saves the downloaded firmware in the FEPROM in a Sun StorEdge A5x00 disk array. If -s is not specified, the downloaded firmware will not be saved across power cycles.

-f filename

Downloads the PROM image in filename-path . If you do not specify the -f option, a default PROM image may be used.

The default PROM image in a Sun StorEdge A5x00 is in the directory

/usr/lib/locale/C/LC_MESSAGES and is named ibfirmware

The default PROM image in a SPARCstorage Array is in the directory /usr/lib/firmware/ssa and is named ssafirmware .

For the Sun Fire 880 internal storage array, the -f option is required. There is no default PROM image for the Sun Fire 880 system. You must load the image from the Supplement CD provided with the Solaris release. Once loaded, the image resides in the directory /usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw and you can use the -f option to download the image from there.

-w WWN

This option is for the SPARCstorage Array only. See Changing a SPARCstorage Array WWN (download) .


Changing a SPARCstorage Array WWN (download)

Use the download subcommand to change the WWN of a SPARCstorage Array controller board.

Supported on:

TABLE 2-10 download Options and Arguments

Option/Argument

Description

pathname

A SPARCstorage Array controller.

-w WWN

Changes the World Wide Name for the SPARCstorage Array. WWN is a 12-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 .


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 FC25/S SBus cards fcode that was released with this version of the operating system is located in the directory usr/lib/firmware/fc_s and is named fc_s_fcode .

Supported on:

TABLE 2-11 fc_s_download Options and Arguments

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 FC25/S SBus card is printed.


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 that connects to the Sun StorEdge A5x00 disk array.)

The fcal_s_download subcommand is interactive and waits for user confirmation before downloading the fcode.

Supported on:

TABLE 2-12 fcal_s_download Options and Arguments

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 .


Downloading fcode to FC/S, FC100/S, FC100/P, and FC100/2P Host Adapters (fcode_download)

Use the fcode_download subcommand to locate the FC/S, FC100/S, FC100/P, and FC100/2P host adapter cards, download the fcode contained in the directory
dir-name to the appropriate cards, and to display the current version of the fcode in each host adapter.

The fcode_download subcommand is interactive and waits for user confirmation before downloading the fcode.

Supported on:

TABLE 2-13 fcode_download Options

Option

Description

-p

Displays the current version of the fcode in each host adapter card. When the -p option is used, no download is performed.

-d dir-name

The name of the directory that contains the new fcode. When the fcode_download subcommand is invoked without the [-d dir-name] option, the default directory usr/lib/firmware/fc_s is used.


Downloading fcode to FC100/P and FC100/2P Host Adapters (qlgc_s_download)

Use the qlgc_s_download subcommand to download the fcode contained in the file fcode-file into all the FC100/P and FC100/2P PCI host adapter cards or to display the current version of the fcode in each host adapter.

The qlgc_s_download subcommand is interactive and waits for user confirmation before downloading the fcode.

Supported on:

TABLE 2-14 qlgc_s_download Options

Option

Description

-f fcode-file

The name of the file that contains the new fcode. When the qlgc_s_download subcommand is invoked without the [-f fcode-file ] option, the current version of the fcode in each FC100/2P host adapter card is printed.



Accessing the Enclosure Services Card

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.

Displaying Environmental Information (env_display)

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

Supported on:

TABLE 2-15 env_display Options and Arguments

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.


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.

Supported on:

TABLE 2-16 alarm_off Options and Arguments

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.


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.

Supported on:

TABLE 2-17 alarm_on Options and Arguments

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.


Setting the Alarm (alarm_set)

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

Supported on:

TABLE 2-18 alarm_set Options and Arguments

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 of the audible alarm.



Performing Enclosure and Disk Operations

Renaming a Sun StorEdge A5x00 Disk Array or Sun Fire 880 Internal Storage Array (enclosure_name)

Use the enclosure_name subcommand to change the enclosure name of a Sun StorEdge A5x00 array or a Sun Fire 880 enclosure.

Supported on:

TABLE 2-19 enclosure_name Options and Arguments

Option/Argument

Description

new-name

The name you assign to the enclosure. The new name must

be 16 or fewer alphabetic or numeric characters. New-name specifies the box_name of the enclosure or interface board.

enclosure

The enclosure name of a Sun StorEdge A5x00 disk array or a Sun Fire 880 internal storage array. Use the probe subcommand to list the enclosure name.

pathname

The physical or logical path name of a Sun StorEdge A5x00 disk array or Sun Fire 880 internal storage array. Use a path name instead of enclosure if you do not know the enclosure name. Use the probe or probe-p command to list the path names and World Wide Name.


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.

Supported on:

TABLE 2-20 perf_statistics Options and Arguments

Option/Argument

Description

pathname

A SPARCstorage Array controller

-e

Enables the accumulation of performance statistics


Powering Off an Enclosure or Disk Drive (power_off)

Use the power_off subcommand to set an enclosure to the power-save mode.



Note Note - Sun StorEdge A5x00 disk drives are not available when in the power-save mode.



When an Enclosure Services Card in a SPARCstorage Array is addressed, the RSM tray is powered off.

When a disk drive in a Sun StorEdge A5x00 is addressed, the drive is set to the drive off/unmated state. When it is set to the drive off/unmated state, the drive is spun down (stopped) and put in the bypass mode.

Supported on:

TABLE 2-21 power_off Options and Arguments

Option/Argument

Description

enclosure

The enclosure name of a Sun StorEdge A5x00

dev

The name of a specific disk in an enclosure

pathname

The physical or logical path name of a Sun StorEdge A5x00, SPARCstorage Array, or a specific disk in an array


Powering On an Enclosure or Disk Drive (power_on)

Use the power_on subcommand to set a drive to its normal power-on state. If you specify a Sun StorEdge A5x00 disk drive, the power_on subcommand sets the specified disks to the normal start-up state.

Supported on:

TABLE 2-22 power_on Options and Arguments

Option

Description

enclosure

The enclosure name of a Sun StorEdge A5x00 disk array

dev

The name of a specific disk in a disk array

pathname

The physical or logical path name of a Sun StorEdge A5x00 disk array or a specific disk in a disk array


Releasing Disks (release)

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

Supported on:

TABLE 2-23 release Options and Arguments

Option

Description

pathname

The physical or logical path name of a Sun StorEdge A5x00 disk array, SPARCstorage Array, or a specific disk in a disk array


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.

Supported on:

TABLE 2-24 reserve Options and Arguments

Option

Description

pathname

The physical or logical path name of a Sun StorEdge A5x00 disk array, SPARCstorage Array, or a specific disk in a disk array


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_dev subcommand normally runs interactively; it requests confirmation for setting the default boot device in the PROM.

Supported on:

TABLE 2-25 set_boot_dev Options and Arguments

Option

Description

-y

Runs non-interactively; no confirmation is requested or required

pathname

A block special device or a mount point


Starting Disks (start)

Use the start subcommand to spin up the specified disk(s). If pathname specifies the SPARCstorage Array controller, this action applies to all disks in the SPARCstorage Array.

Supported on:

TABLE 2-26 start Options and Arguments

Option

Description

-t

Spin up all disks in the tray specified by tray-number

pathname

The physical or logical path name of a SPARCstorage Array controller


Stopping Disks (stop)

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

Supported on:

TABLE 2-27 stop Options and Arguments

Option

Description

-t

Spin down all disks in the tray specified by tray-number

pathname

The physical or logical path name of a SPARCstorage Array controller



Displaying and Setting NVRAM

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

Supported on:

TABLE 2-28 fast_write Options and Arguments

Option

Description

pathname

A SPARCstorage Array controller or an individual disk

-s

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


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.

Supported on:

TABLE 2-29 nvram_data Options and Arguments

Option

Description

pathname

A SPARCstorage Array controller or an individual disk


Purging Fast Write Data From NVRAM (purge)

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

Supported on:

TABLE 2-30 purge Options and Arguments

Option

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


Flushing NVRAM (sync_cache)

Use the sync_cache subcommand to flush all outstanding writes for one or more disks from NVRAM to the media. If pathname specifies the controller, this action applies to all disks in the SPARCstorage Array subsystem.

Supported on:

TABLE 2-31 sync_cache Options and Arguments

Option

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



Removing, Inserting, and Replacing Enclosures and Disks

This section discusses how to remove, insert, and replace disk drives, enclosures, or a chain of enclosures. For more detailed instructions on performing these operations with a Sun StorEdge A5x00 disk array or Sun Fire 880 internal storage array, see
Chapter 3 and refer to the service manual for your enclosure.

Removing Devices (remove_device )

Use the remove_device subcommand to hot-plug a disk drive, enclosure, or a chain of enclosures. This subcommand interactively guides you through hot-plugging of one or more devices.

Supported on:

In the Sun StorEdge A5x00 disk array and the Sun Fire 880 internal storage array, the remove_device subcommand:

In the SPARCstorage RSM, the remove_device subcommand:

TABLE 2-32 remove_device Options and Arguments

Option/Argument

Description

-F

Forces the hot-plug operation on one or more devices even if those devices are being used by the host (and are, therefore, busy). Caution-- Removing devices that are in use will cause unpredictable results. Try to hot-plug normally (without -F ) first, resorting to this option only when you are sure of the consequences of overriding normal hot-plug checks.

enclosure

The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information.

dev

The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information.

pathname

The physical or logical path name of an individual disk in an array, or of a Sun StorEdge A5x00 array, SPARCStorage Array, or RSM controller ( cN name ). You can also specifiy the WWN of an individual Sun Fire 880 or Sun StorEdge A5x00 disk, or a Sun StorEdge A5x00 IB.


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

Sun StorEdge A5x00 remove_device display

You must physically remove the device at this time. After you press a key, the following data 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 to hot-plug a new disk drive, enclosure, or chain of enclosures. If you specify more than one enclosure, you can perform concurrent hot-plug operations on multiple buses.

Supported on:

The insert_device subcommand interactively guides you through the hot-plug procedure of one or more devices. In the Sun StorEdge A5x00 disk array and the Sun Fire 880 internal storage array, the insert_device subcommand:

In the SPARCstorage RSM, the insert_device subcommand:

TABLE 2-33 insert_device Options and Arguments

Option/Argument

Description

enclosure

The box_name of a Sun StorEdge A5x00 IB or Sun Fire 880 SES that you assign with the luxadm enclosure_name subcommand. See About Addressing a Disk or Disk Array for more information.

dev

The slot number of a specific disk in an enclosure. For a Sun StorEdge A5x00 device this is [ ,f ] or [ ,r ] and the slot number; for a Sun Fire 880 device this is [ ,s ] and the slot number. See About Addressing a Disk or Disk Array for more information.


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

Sun StorEdge A5x00 insert_device display

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

 Drive in Box Name "macs1" front slot 1
  Logical Nodes under /dev/dsk and /dev/rdsk :
	c2t1d0s0
	c2t1d0s1
	c2t1d0s2
	c2t1d0s3
	c2t1d0s4
	c2t1d0s5
	c2t1d0s6
	c2t1d0s7
#

Replacing Devices (replace_device)

Use the replace_device subcommand to hot-plug a device.

The replace_device subcommand interactively guides you through the hot- plug procedure of one or more devices. The replace_device subcommand:

Supported on:

TABLE 2-34 replace_device Options and Arguments

Option/Argument

Description

-F

Forces the hot-plug operation on one or more devices even if those devices are being used by the host (and are, therefore, busy). Caution-- 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-plug checks.

pathname

A SPARCstorage Array controller or an individual disk.