1metaparam(1M) System Administration Commands metaparam(1M)
2
3
4
6 metaparam - modify parameters of metadevices
7
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
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
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
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
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
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
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
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
151 mdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M), metahs(1M),
152 metainit(1M), metaoffline(1M), metaonline(1M), metarecover(1M), metare‐
153 name(1M), metareplace(1M), metaroot(1M), metaset(1M), metassist(1M),
154 metastat(1M), metasync(1M), metattach(1M), md.tab(4), md.cf(4),
155 mddb.cf(4), md.tab(4), attributes(5), md(7D)
156
157
158
159
160
161
162SunOS 5.11 26 Mar 2006 metaparam(1M)