Platform Notes: Using luxadm Software

Performing Enclosure and Disk Operations

Renaming a StorEdge A5000 Disk Array (`enclosure_name`)

Use the enclosure_name subcommand to change the enclosure name of one or more StorEdge A5000 disk arrays. The new name must be 16 or less characters. The only allowed characters are alphabetic or numeric digits.

Supported on:

StorEdge A5000

luxadm [ -v ] enclosure_name new-name enclosure... | pathname...

Table 2-17 enclosure_name Options and Arguments


Option/Argument	Description
`new-name`	The new enclosure name
`enclosure`	The enclosure name of a StorEdge A5000 disk array
`pathname`	The physical or logical path name of a StorEdge A5000 disk array

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:

SPARCstorage Array

Note -

The accumulation of performance statistics must be enabled before the display -p subcommand can be used.

luxadm [ -v ] perf_statistics [ -e ] pathname

Table 2-18 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 -

StorEdge A5000 disk drives are not available when in the power-save mode.

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

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

Supported on:

StorEdge A5000
SPARCstorage Array

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

Table 2-19 power_off Options and Arguments


Option/Argument	Description
`enclosure`	is the enclosure name of a StorEdge A50001.
`dev`	is the name of a specific disk in an enclosure1.
`pathname`	is the physical or logical path name of a StorEdge A5000, SPARCstorage Array, or a specific disk in an array1.

Powering On Enclosures or Disk Drives (`power_on`)

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.

Supported on:

StorEdge A5000

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

Table 2-20 power_on 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
`pathname`	The physical or logical path name of a StorEdge A5000 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:

StorEdge A5000
SPARCstorage Array
SPARCstorage RSM

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

Table 2-21 release 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
`pathname`	The physical or logical path name of a StorEdge A5000 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:

StorEdge A5000
SPARCstorage Array
SPARCstorage RSM

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

Table 2-22 reserve 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
`pathname`	The physical or logical path name of a StorEdge A5000 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_device subcommand normally runs interactively; it requests confirmation for setting the default boot-device in the PROM.

Supported on:

StorEdge A5000
SPARCstorage Array
SPARCstorage RSM

luxadm [ -v ] set_boot_dev [ -y ] pathname

Table 2-23 set_boot_dev Options and Arguments


Option/Argument	Description
`pathname`	A block special device or a mount-point
`-y`	Runs non-interactively; no confirmation is requested or required

Starting Disks (`start`)

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

Supported on:

SPARCstorage Array

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

Table 2-24 start Options and Arguments


Option/Argument	Description
`-t` `tray-number`	The tray number
`pathname`	The physical or logical path name of a SPARCstorage Array, or a specific disk in a disk array

Stopping Disks (`stop`)

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

Supported on:

SPARCstorage Array

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

Table 2-25 stop Options and Arguments


Option/Argument	Description
`-t` `tray-number`	is the tray number.
`pathname`	is the physical or logical path name of a SPARCstorage Array, or a specific disk in a disk array

Performing Enclosure and Disk Operations

Renaming a StorEdge A5000 Disk Array (enclosure_name)

Collecting Performance Statistics (perf_statistics)

Powering Off an Enclosure or Disk Drive (power_off)

Powering On Enclosures or Disk Drives (power_on)

Releasing Disks (release)

Reserving Disks (reserve)

Setting the Boot Device Variable (set_boot_dev)

Starting Disks (start)

Stopping Disks (stop)

Renaming a StorEdge A5000 Disk Array (`enclosure_name`)

Collecting Performance Statistics (`perf_statistics`)

Powering Off an Enclosure or Disk Drive (`power_off`)

Powering On Enclosures or Disk Drives (`power_on`)

Releasing Disks (`release`)

Reserving Disks (`reserve`)

Setting the Boot Device Variable (`set_boot_dev`)

Starting Disks (`start`)

Stopping Disks (`stop`)