metaparam

 

---

 
 
 
 Maintenance Commands                                metaparam(1M)
 
 
 


NAME
      metaparam - modify parameters of metadevices
 


SYNOPSIS
      metaparam -h
      metaparam [ -s setname ] [ concat/stripe or RAID5 options ]
                concat/stripe | RAID
      metaparam [ -s setname ] [ mirror options ] mirror
 
 


DESCRIPTION
      The metaparam command is used to display or  modify  current
      parameters  of  metadevices.   The current parameters can be
      displayed by the metastat command.
 
      If just the metadevice is specified as an  argument  to  the
      metaparam command, the current settings are displayed.
 
      The metaparam command enables metadevice  parameters  to  be
      changed  with  the  exception  of the interlace value, which
      initially must be set using the metainit command.
 
 


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 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 th 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
      This example associates a hot spare  pool,  hsp005,  with  a
      RAID5 metadevice, d80.
 
      # metaparam -h hsp005 d80
 
      This example changes the read option on a  mirror  d50  from
      the default of roundrobin to geometric.
 
      # metaparam -r geometric d50
 
 
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      bute:   box; cbp-1 | cbp-1 l | l .  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)
 
      Solstice DiskSuite User's Guide, Solstice  DiskSuite  Reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8            Last change: 1 Oct 1999                    3
 
 
 

---