metaoffline(1M)
NAME
metaoffline, metaonline - place submirrors offline and
online
SYNOPSIS
/usr/sbin/metaoffline -h
/usr/sbin/metaoffline [-s setname] [-f] mirror submirror
/usr/sbin/metaonline -h
/usr/sbin/metaonline [-s setname] mirror submirror
DESCRIPTION
The metaoffline command prevents Solaris Volume Manager from
reading and writing to the submirror that has been taken
offline. While the submirror is offline, all writes to the
mirror will be kept track of (by region) and will be written
when the submirror is brought back online. The metaoffline
command can also be used to perform online backups: one sub-
mirror is taken offline and backed up while the mirror
remains accessible. (However, if this is a two-way mirror,
data redundancy is lost while one submirror is offline.) The
metaoffline command differs from the metadetach command
because it does not sever the logical association between
the submirror and the mirror. To completely remove a submir-
ror from a mirror, use the metadetach command.
A submirror that has been taken offline will only remain
offline until the metaonline command is invoked or the sys-
tem is rebooted.
When the metaonline command is used, reading from and writ-
ing to the submirror resumes. A resync is automatically
invoked to resync the regions written while the submirror
was offline. Writes are directed to the submirror during
resync. Reads, however, will come from a different submir-
ror. Once the resync operation completes, reads and writes
are performed on that submirror. The metaonline command is
only effective on a submirror of a mirror that has been
taken offline.
The metaoffline and metaonline commands can not be used on
RAID 1 volumes in application-based recovery (ABR) mode.
A submirror that has been taken offline with the metaoffline
command can only be mounted as read-only.
OPTIONS
Root privileges are required for all of the following
options except -h.
-f Forces offlining of submirrors that have slices
requiring maintenance.
-h Displays usage message.
-s setname
Specifies the name of the diskset on which metaoffline
and metaonline will work. Using the -s option will
cause the command to perform its administrative func-
tion within the specified diskset. Without this
option, the command will perform its function on local
metadevices.
mirror
Specifies the metadevice name of the mirror from which
the submirror will be either taken offline or put
online.
submirror
Specifies the metadevice name of the submirror to be
either taken offline or put online.
EXAMPLES
Example 1: Taking submirror offline
This example takes one submirror, d9, offline from mirror
d10.
# metaoffline d10 d9
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWmdu |
|_____________________________|_____________________________|
SEE ALSO
metaclear(1M), metadb(1M), metadetach(1M), metahs(1M),
metainit(1M), metaparam(1M), metareplace(1M), metaroot(1M),
metaset(1M), metastat(1M), metasync(1M), metattach(1M),
md.tab(4), md.cf(4), mddb.cf(4), attributes(5)
Solaris Volume Manager Administration Guide
NOTES
The metaonline and metaoffline commands are not applicable
to mirrors in application-based recovery (ABR) mode.
Man(1) output converted with
man2html