Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandsmetaparam(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 metadevice. If none is specified, the metadevice is disassociated with the hot spare pool assigned to it. If the metadevice is currently using a hot spare, then metaparam 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. parallel, the default action under the metainit command, specifies that all writes are parallel. 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWmdu

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


SunOS 5.9Go To TopLast Changed 18 Dec 2001

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.