CHAPTER 4

Subcommands for the SPARCstorage Array

---

---

NVRAM Operations

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.

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

TABLE 4-1 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.

luxadm [ -v ] nvram_data pathname

TABLE 4-2 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.

luxadm [ -v ] purge pathname

TABLE 4-3 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.

luxadm [ -v ] sync_cache pathname

TABLE 4-4 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".

---

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.

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

TABLE 4-5 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.

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

TABLE 4-6 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.

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

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

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

TABLE 4-8 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".

---

Other Operations

Downloading fcode

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 correct file: usr/lib/firmware/fc_s/ fc_s_fcode.

---

---

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

---

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

TABLE 4-9 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.

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.

---

luxadm [ -v ] perf_statistics [ -e ] pathname

TABLE 4-10 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".

Changing the World Wide Name

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

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

TABLE 4-11 download

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.

Starting Disks

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

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

TABLE 4-12 start

Option/Argument	Description
-t tray-number	spins up all disks in the tray. pathname must specifiy the SPARCstorage Array controller.
pathname	is the physical or logical path name of a SPARCstorage Array, or a specific disk in an array1.
1 See "Addressing a SPARCstorage Array" on page 3".

Stopping Disks

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

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

TABLE 4-13 stop

Option/Argument	Description
-t tray-number	spins down all disks in the tray. pathname must specifiy the SPARCstorage Array controller.
pathname	is the physical or logical path name of a SPARCstorage Array, or a specific disk in an array1 .
1 See "Addressing a SPARCstorage Array" on page 3".

Turning On a Disk LED

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

luxadm [ -v ] led_on pathname

TABLE 4-14 led_off

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