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  following
     options except -h.

     -h    Displays usage message.

     -s setname
           Specifies the name of the diskset on  which  metaparam
           will  work. Using the -s option will cause the command
           to perform  its  administrative  function  within  the
           specified  diskset.  Without  this option, the command
           will perform 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  metadev-
           ice.  If none is specified, the metadevice is disasso-
           ciated 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, geometric, or
           first. roundrobin, which is the default  action  under
           the metainit command, 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 mirror. The -w  option
           must  be followed by either parallel or serial. paral-
           lel, the default action under  the  metainit  command,
           specifies  that all writes are parallel. serial speci-
           fies 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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWmdu                     |
    |_____________________________|_____________________________|

SEE ALSO

     metaclear(1M),   metadb(1M),   metadetach(1M),   metahs(1M),
     metainit(1M),        metaoffline(1M),        metaonline(1M),
     metareplace(1M),  metaroot(1M),  metaset(1M),  metastat(1M),
     metasync(1M), metattach(1M), md.tab(4), md.cf(4), mddb.cf(4)

     Solaris Volume Manager Administration Guide