metaparam(1m)

1metaparam(1M)           System Administration Commands           metaparam(1M)
2
3
4

NAME

6       metaparam - modify parameters of metadevices
7

SYNOPSIS

9       /usr/sbin/metaparam -h
10
11
12       /usr/sbin/metaparam [-s setname]
13            [concat/stripe or RAID5 options] concat/stripe RAID
14
15
16       /usr/sbin/metaparam [-s setname] [mirror options] mirror
17
18

DESCRIPTION

20       The  metaparam  command is used to display or modify current parameters
21       of metadevices.
22
23
24       If just the metadevice is specified as an  argument  to  the  metaparam
25       command, the current settings are displayed.
26
27
28       The metaparam command enables most metadevice (volume) parameters to be
29       changed. Only the interlace  value  cannot  be  changed  by  metaparam,
30       because  it is established when the metadevice is created and cannot be
31       changed thereafter.
32

OPTIONS

34       Root privileges are required for all of the options.
35
36
37       The following options are supported:
38
39       -h
40
41           Displays usage message.
42
43
44       -s setname
45
46           Specify the name of the diskset on which metaparam works. Using the
47           -s option causes the command to perform its administrative function
48           within the specified diskset. Without this option, the command per‐
49           forms its function on local metadevices.
50
51

CONCAT/STRIPE OR RAID5 OPTIONS

53       -hhot_spare_pool | none
54
55           Specifies the hot spare pool to be used by a metadevice. If none is
56           specified, the metadevice is disassociated with the hot spare  pool
57           assigned  to  it. If the metadevice is currently using a hot spare,
58           then metaparam cannot replace the hot spare pool.
59
60
61       concat/stripe |RAID
62
63           Specifies the metadevice name of the concatenation, stripe, or con‐
64           catenation of stripes, or of the RAID5 metadevice.
65
66

MIRROR OPTIONS

68       -r roundrobin | geometric | first
69
70           Modifies  the  read option for a mirror. The -r option must be fol‐
71           lowed by either roundrobin, geometric, or first. roundrobin,  which
72           is the default action under the metainit command, specifies reading
73           the disks in  a  round-robin  (load  balancing)  method.  geometric
74           allows  for faster performance on sequential reads. first specifies
75           reading only from the first submirror.
76
77
78       -w parallel | serial
79
80           Modifies the write option for a mirror. The -w option must be  fol‐
81           lowed  by  either  parallel or serial. parallel, the default action
82           under the metainit command, specifies that all writes are parallel.
83           serial specifies that all writes are serial.
84
85
86       -p pass_number
87
88           A  number from 0-to-9 that specifies the order in which a mirror is
89           resynced during reboot. The default is 1. Smaller pass numbers  are
90           resynced  first.  Equal  pass numbers are run concurrently. If 0 is
91           used, the mirror resync is skipped. 0 should only be used for  mir‐
92           rors mounted as read-only, or as swap.
93
94
95       mirror
96
97           Specifies the metadevice name of the mirror.
98
99

EXAMPLES

101       Example 1 Associating Hot Spare Pool with RAID5 Metadevice
102
103
104       This  example  associates  a  hot  spare  pool, user_pool, with a RAID5
105       metadevice, user_raid.
106
107
108         # metaparam -h user_pool user_raid
109
110
111
112       Example 2 Changing Read Option to Geometric
113
114
115       This example changes the read option on a mirror d50 from  the  default
116       of roundrobin to geometric.
117
118
119         # metaparam -r geometric d50
120
121
122

EXIT STATUS

124       The following exit values are returned:
125
126       0
127
128           Successful completion.
129
130
131       >0
132
133           An error occurred.
134
135

ATTRIBUTES

137       See attributes(5) for descriptions of the following attributes:
138
139
140
141
142       ┌─────────────────────────────┬─────────────────────────────┐
143       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
144       ├─────────────────────────────┼─────────────────────────────┤
145       │Availability                 │SUNWmdu                      │
146       ├─────────────────────────────┼─────────────────────────────┤
147       │Interface Stability          │Stable                       │
148       └─────────────────────────────┴─────────────────────────────┘
149