2 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH METAIMPORT 1M "Oct 28, 2005"
8 metaimport \- imports disk sets into existing Solaris Volume Manager
13 \fBmetaimport\fR \fB-s\fR \fIsetname\fR [\fB-n\fR] [\fB-f\fR] [\fB-v\fR] [\fIdisks\fR]...
18 \fBmetaimport\fR \fB-r\fR [\fB-v\fR] [\fIdisks\fR]...
23 \fBmetaimport\fR \fB-V\fR
28 \fBmetaimport\fR \fB-?\fR
34 The \fBmetaimport\fR command allows the importing of disk sets, including
35 replicated disk sets, into an existing Solaris Volume Manager configuration.
36 Replicated disk sets are disk sets created using remote replication software.
39 The default Solaris Volume Manager configuration specifies a maximum number of
40 disk sets that can be configured. The \fBmetaimport\fR command fails if
41 importing the disk set would result in exceeding the number of disk sets
42 configured on the system. To increase the number of disk sets allowed on a
43 system, see the \fI\fR.
46 Use \fBmetaset\fR(1M) or \fBmetastat\fR(1M) to view the configuration of the
50 You must run \fBmetaimport\fR as root.
53 \fBmetaimport\fR requires a functional Solaris Volume Manager configuration
58 The following options are supported:
65 Force the import, even if a quorum of replicas from the imported disk set is
66 not available. This option could result in corrupt configurations and should
67 only be used when \fBmetaimport\fR fails with the "Insufficient quorum
68 detected; exiting" error. If only a partial disk set is available, this option
69 might be necessary to successfully import. Some or all data could be corrupted
70 or unavailable when importing a partial set or a set lacking a replica quorum.
79 Does not actually perform the operation, but shows the output or errors that
80 would have resulted from the operation, had it been run.
89 Report on the non-configured disk sets found on the system. If no disk device
90 or LUN is specified, \fBmetaimport\fR reports on all non-configured disk sets
91 attached to the system. When the name of one disk is specified,
92 \fBmetaimport\fR reports on the disk set (or virtual LUN) containing the
93 specified disk. If two or more disks are specified, metaimport reports on the
94 set (or sets, if they belong to different disk sets) containing the specified
95 disks. If two or more disks are specified, \fBmetaimport\fR reports on the set
96 (or sets, if they belong to different disk sets) containing the specified
99 This option can be used in conjunction with the \fB-v\fR option to give verbose
100 output on each disk set reported.
106 \fB\fB-s\fR \fIsetname\fR\fR
109 Specify the disk set name to use when importing. The imported disk set will be
110 called \fIsetname\fR, without regard to the name it may have had on a different
120 Verbose. Provides detailed information about the \fBmetadb\fR replica location
121 and status. It also provides detailed information about the disk set
122 configuration and status similar to the "\fBmetastat -c\fR" output.
140 Display a help message.
145 \fBExample 1 \fRImporting a Disk Set
148 The following example creates a disk set called \fBblue\fR and identifies
149 \fBc1t5d0\fR as a disk containing a state database replica from the disk set
155 # metaimport -s blue c1t5d0
161 \fBExample 2 \fRReporting Disk Sets to Import
164 The following example scans all disks and LUNs attached to the system and
165 configured as part of the system. It scans for disks that could be part of a
166 disk set to be imported. Components that are already part of the Solaris Volume
167 Manager configuration are ignored.
171 This use of \fBmetaimport\fR provides suggested forms of the \fBmetaimport\fR
172 command to use to actually import the disk sets that have been found. You can
173 specify a component on the command line to reduce the scope of the scan and
174 generate results more quickly.
191 Successful completion.
206 See \fBattributes\fR(5) for descriptions of the following attributes:
214 ATTRIBUTE TYPE ATTRIBUTE VALUE
216 Interface Stability Stable
222 \fBmdmonitord\fR(1M), \fBmetaclear\fR(1M), \fBmetadb\fR(1M),
223 \fBmetadetach\fR(1M), \fBmetahs\fR(1M), \fBmetainit\fR(1M),
224 \fBmetaoffline\fR(1M), \fBmetaonline\fR(1M), \fBmetaparam\fR(1M),
225 \fBmetarecover\fR(1M), \fBmetareplace\fR(1M), \fBmetaroot\fR(1M),
226 \fBmetaset\fR(1M), \fBmetastat\fR(1M), \fBmetasync\fR(1M), \fBmetattach\fR(1M),
227 \fBmd.tab\fR(4), \fBmd.cf\fR(4), \fBmddb.cf\fR(4), \fBattributes\fR(5)