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 administrative function within the specified
diskset. Without this option, the command performs its
function on local metadevices.
CONCAT/STRIPE OR RAID5 OPTIONS
-hhotsparepool none
Specifies the hot spare pool to be used by a metadevice.
SunOS 5.11 Last change: 26 Mar 2006 1
System Administration Commands metaparam(1M)
If none is specified, the metadevice is disassociated
with the hot spare pool assigned to it. If the metadev-
ice is currently using a hot spare, then metaparam can-
not 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.
MIROR 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 speci-
fies 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 passnumber
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
SunOS 5.11 Last change: 26 Mar 2006 2
System Administration Commands metaparam(1M)
This example associates a hot spare pool, userpool, with a
RAID5 metadevice, userraid.
# metaparam -h userpool userraid
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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWmdu
Interface Stability Stable
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),
SunOS 5.11 Last change: 26 Mar 2006 3
System Administration Commands metaparam(1M)
metasync(1M), metattach(1M), md.tab(4), md.cf(4),
mddb.cf(4), md.tab(4), attributes(5), md(7D)
SunOS 5.11 Last change: 26 Mar 2006 4
|
