1metaoffline(1M) System Administration Commands metaoffline(1M)
2
6 metaoffline, metaonline - place submirrors offline and online
7
9 /usr/sbin/metaoffline -h
10 /usr/sbin/metaoffline [-s setname] [-f] mirror submirror
13 /usr/sbin/metaonline -h
16 /usr/sbin/metaonline [-s setname] mirror submirror
19
22 The metaoffline command prevents Solaris Volume Manager from reading
23 and writing to the submirror that has been taken offline. While the
24 submirror is offline, all writes to the mirror will be kept track of
25 (by region) and will be written when the submirror is brought back
26 online. The metaoffline command can also be used to perform online
27 backups: one submirror is taken offline and backed up while the mirror
28 remains accessible. (However, if this is a two-way mirror, data redun‐
29 dancy is lost while one submirror is offline.) The metaoffline command
30 differs from the metadetach command because it does not sever the logi‐
31 cal association between the submirror and the mirror. To completely
32 remove a submirror from a mirror, use the metadetach command.
33 A submirror that has been taken offline will only remain offline until
36 the metaonline command is invoked or the system is rebooted.
37 When the metaonline command is used, reading from and writing to the
40 submirror resumes. A resync is automatically invoked to resync the
41 regions written while the submirror was offline. Writes are directed to
42 the submirror during resync. Reads, however, will come from a different
43 submirror. Once the resync operation completes, reads and writes are
44 performed on that submirror. The metaonline command is only effective
45 on a submirror of a mirror that has been taken offline.
46 The metaoffline and metaonline commands can not be used on RAID 1 vol‐
49 umes in application-based recovery (ABR) mode.
50 A submirror that has been taken offline with the metaoffline command
53 can only be mounted as read-only.
54
56 Root privileges are required for all of the following options except
57 -h.
58 -f Forces offlining of submirrors that have slices requiring
60 maintenance.
61 -h Displays usage message.
64 -s setname Specifies the name of the diskset on which metaoffline
67 and metaonline will work. Using the -s option will cause
68 the command to perform its administrative function within
69 the specified diskset. Without this option, the command
70 will perform its function on local metadevices.
71 mirror Specifies the metadevice name of the mirror from which
74 the submirror will be either taken offline or put online.
75 submirror Specifies the metadevice name of the submirror to be
78 either taken offline or put online.
79
82 Example 1 Taking a Submirror Offline
83 This example takes one submirror, mymirror_sub1, offline from mirror
86 mymirror.
87 # metaoffline mymirror mymirror_sub1
90
94 The following exit values are returned:
95 0 Successful completion.
97 >0 An error occurred.
100
103 See attributes(5) for descriptions of the following attributes:
104 ┌─────────────────────────────┬─────────────────────────────┐
109 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
110 ├─────────────────────────────┼─────────────────────────────┤
111 │Availability │SUNWmdu │
112 ├─────────────────────────────┼─────────────────────────────┤
113 │Interface Stability │Stable │
114 └─────────────────────────────┴─────────────────────────────┘
115
117 mdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M), metahs(1M),
118 metainit(1M), metaparam(1M), metarecover(1M), metarename(1M), metare‐
119 place(1M), metaroot(1M), metaset(1M), metassist(1M), metastat(1M),
120 metasync(1M), metattach(1M), md.tab(4), md.cf(4), mddb.cf(4),
121 md.tab(4), attributes(5), md(7D)
122
127 The metaonline and metaoffline commands are not applicable to mirrors
128 in application-based recovery (ABR) mode.
129SunOS 5.11 26 Mar 2006 metaoffline(1M)