NAME

metaparam − modify parameters of metadevices and metamirrors

SYNOPSIS

/usr/etc/metaparam [ -r roundrobin | geometric | first ] [ -w parallel | serial ]

[ -e number ] [ -p pass_number ] metamirror

/usr/etc/metaparam [ -h hot_spare_pool | none ] metadevice | submirror

AVAILABILITY

This program is available with the Sun Online: DiskSuite software package. 

DESCRIPTION

metaparam is used to display or modify current parameters of metamirrors or metadevices.  The current parameters are identical to those displayed by the metastat(8) command. 

If only the metamirror or metadevice is given as an argument to metaparam, the current settings are displayed. 

metaparam allows for the changing of all metamirror and metadevice parameters with the exception of the interlace value.  Initially this must be done using the metainit(8) command or in the /etc/md.conf file.  On existing metadevices, the metaclear(8) command must be invoked prior to using metainit to change the interlace value. 

OPTIONS

The options for metaparam are divided into two classes; one for metamirrors and the second for metadevices. 

Metamirror Options

−r roundrobin | geometric | first
Modifies read option for a metamirror.  The −r option must be followed by either roundrobin, geometric, or first.  roundrobin, which is the default action under metainit(8), specifies reading the disks in a round-robin (load balancing) method.  geometric allows for faster performance on sequential reads.  first specifies reading only from the first submirror. 

−w parallel | serial
Modifies the write option for a metamirror.  The −w option must be followed by either parallel or serial.  parallel, the default action under metainit , specifies that all writes happen in parallel.  serial specifies that writes should occur in serial. 

−e number
Specifies an error threshold for read errors before taking a physical device off line.  Note that physical devices are taken off line as soon as the first write error occurs.

−p pass_number
A number in the range 0-to-9 that specifies the order in which a mirror is resynced during reboot.  Smaller pass numbers are resynced first.  Equal pass numbers are run concurrently.  When 0 is entered, the mirror resync is skipped (this should only be used for mirrors mounted read only).  The default is 1.

Metadevices Option

−h hot_spare_pool | none
Specifies the hot spare pool to be used by a metadevice.  If none is specified, no hot spare pool is used.  If a hot spare from a pool that was previously specified is currently in use, metaparam can not replace the hot spare pool with this option. 

SEE ALSO

md(4s), md.conf(5), mddb.conf(5), metatab(5), metaclear(8), metad(8), metadb(8), metahs(8), metainit(8), metaoffline(8), metareplace(8), metastat(8), metasync(8), metattach(8)

Sun Online: DiskSuite Administration Guide
System and Network Administration

Sun Release 4.1  —  Last change: 23 July 1991