Platform Notes: Using luxadm Software

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 StorEdge A5000 disk array, see Chapter 3, StorEdge A5000 Disk Array Hot-Plugging Procedures and refer to the Sun StorEdge A5000 Installation and Service Manual.

Removing Devices (remove_device )

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

Supported on:

In the StorEdge A5000 disk array, the remove_device subcommand:

In the SPARCstorage RSM, the remove_device subcommand:


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

Table 2-30 remove_device Options and Arguments

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 

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 (insert_device)

Use the insert_device subcommand for hot insertion of a new disk drive, enclosure, or chain of enclosures. If you specify more than one enclosure, you can perform concurrent hot insertions on multiple buses.

Supported on:

The insert_device subcommand interactively guides you through the hot insertion of one or more devices. In the StorEdge A5000 disk array the insert_device subcommand:

In the SPARCstorage RSM, the insert_device subcommand:


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

Table 2-31 insert_device Options and Arguments

Option/Argument 

Description 

enclosure

The enclosure name of a StorEdge A5000 disk array 

dev

The name of a specific disk in a disk array 

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 (replace_device)

Use the replace_device subcommand to hot replace a device.

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

Supported on:


luxadm [ -v ] replace_device [ -F ] pathname

Table 2-32 replace_device Options and Arguments

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