metaparam(1M)                                             System Administration Commands                                             metaparam(1M)

NAME

       metaparam - modify parameters of metadevices

SYNOPSIS

       /usr/sbin/metaparam -h

       /usr/sbin/metaparam [-s setname] [ concat/stripe or RAID5 options] concat/stripe RAID

       /usr/sbin/metaparam [-s setname] [ mirror options] mirror

DESCRIPTION

       The metaparam command is used to display or modify current parameters of metadevices.

       If just the metadevice is specified as an argument to the metaparam command, the current settings are displayed.

       The  metaparam  command enables most metadevice (volume) parameters to be changed. Only the interlace value cannot be changed by metaparam,
       because it is established when the metadevice is created and cannot be changed thereafter.

OPTIONS

       Root privileges are required for all of the options.

       The following options are supported:

       -h              Displays usage message.

       -s setname      Specify the name of the diskset on which metaparam works. Using the -s option causes the command to perform its administra-
                       tive function within the specified diskset. Without this option, the command performs its function on local metadevices.

CONCAT
/STRIPE OR RAID5 OPTIONS
       -h hot_spare_pool | none        Specifies the hot spare pool to be used by a metadevice. If none is specified, the metadevice is disassoci-
                                       ated with the hot spare pool assigned to it. If the metadevice is currently using a hot spare,  then  meta-
                                       param cannot replace the hot spare pool.

       concat/stripe | RAID            Specifies  the  metadevice  name of the concatenation, stripe, or concatenation of stripes, or of the RAID5
                                       metadevice.

MIRROR OPTIONS

       -r roundrobin | geometric | first       Modifies the read option for a mirror. The -r option must be followed by either roundrobin, geomet-
                                               ric,  or first. roundrobin, which is the default action under the metainit command, specifies read-
                                               ing 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  mirror.  The -w option must be followed by either parallel or
                                               serial. parallel, the default action under the metainit command, specifies that all writes are par-
                                               allel. serial specifies that all writes are serial.

       -p pass_number                          A  number  from  0-to-9  that  specifies the order in which a mirror is resynced during reboot. The
                                               default is 1. Smaller pass numbers are resynced first. Equal pass numbers are run concurrently.  If
                                               0 is used, the mirror resync is skipped. 0 should only be used for mirrors mounted as read-only, or
                                               as swap.

       mirror                                  Specifies the metadevice name of the mirror.

EXAMPLES

       Example 1:  Associating Hot Spare Pool with RAID5 Metadevice

       This example associates a hot spare pool, hsp005, with a RAID5 metadevice, d80.

       # metaparam -h hsp005 d80

       Example 2: Changing Read Option to Geometric

       This example changes the read option on a mirror d50 from the default of roundrobin to geometric.

       # metaparam -r geometric d50

EXIT STATUS

       The following exit values are returned:

       0        Successful completion.

       >0       An error occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWmdu                      |
       +-----------------------------+-----------------------------+

SEE ALSO

       mdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M),  metahs(1M),  metainit(1M),  metaoffline(1M),  metaonline(1M),  metarecover(1M),
       metarename(1M),  metareplace(1M), metaroot(1M), metaset(1M), metassist(1M), metastat(1M), metasync(1M), metattach(1M), md.tab(4), md.cf(4),
       mddb.cf(4), md.tab(4), attributes(5), md(7D)

       Solaris Volume Manager Administration Guide

SunOS 5.10                                                          2 Jun 1004                                                       metaparam(1M)