2 .\" Copyright (c) 2003, 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 METAROOT 1M "Mar 26, 2006"
8 metaroot \- setup system files for root (/) metadevice
12 \fB/usr/sbin/metaroot\fR \fB-h\fR
17 \fB/usr/sbin/metaroot\fR [\fB-n\fR] [\fB-k\fR \fIsystem-name\fR] [\fB-v\fR \fIvfstab-name\fR]
18 [\fB-c\fR \fImddb.cf-name\fR] [\fB-m\fR \fImd.conf-name\fR] [\fB-R\fR \fIroot-path\fR] \fIdevice\fR
24 The \fBmetaroot\fR command edits the \fB/etc/vfstab\fR and \fB/etc/system\fR
25 files so that the system may be booted with the root file system (\fB/\fR) on
26 an appropriate metadevice. The only metadevices that support the root file
27 system are a stripe with only a single slice or a mirror on a single-slice
31 If necessary, the \fBmetaroot\fR command can reset a system that has been
32 configured to boot the root file system (\fB/\fR) on a metadevice so that it
33 uses a physical slice.
37 Root privileges are required for all of the following options except \fB-h\fR.
40 The following options are supported:
44 \fB\fB-c\fR \fImddb.cf-name\fR\fR
47 Use \fImddb.cf-name\fR instead of the default \fB/etc/lvm/mddb.cf\fR file as a
48 source of metadevice database locations.
57 Display a usage message.
63 \fB\fB-k\fR \fIsystem-name\fR\fR
66 Edit a user-supplied \fIsystem-name\fR instead of the default \fB/etc/system\fR
67 system configuration information file.
73 \fB\fB-m\fR \fImd.conf-name\fR\fR
76 Edit the configuration file specified by \fImd.conf-name\fR rather than the
77 default, \fB/kernel/drv/md.conf\fR.
86 Print what would be done without actually doing it.
92 \fB\fB-R\fR \fIroot-path\fR\fR
95 When metaroot modifies system files, it accesses them in their relative
96 location under \fIroot-path\fR.
98 The \fB-R\fR option cannot be used in combination with the \fB-c\fR,
99 \fB-k\fR,\fB-m\fR, or \fB-v\fR options.
104 The root file system of any non-global zones must not be referenced with the
105 \fB-R\fR option. Doing so might damage the global zone's file system, might
106 compromise the security of the global zone, and might damage the non-global
107 zone's file system. See \fBzones\fR(5).
114 \fB\fB-v\fR \fIvfstab-name\fR\fR
117 Edit \fIvfstab-name\fR instead of the default \fB/etc/vfstab\fR table of file
124 The following operands are supported:
131 Specifies either the metadevice or the conventional disk device (slice) used
132 for the root file system (\fB/\fR).
137 \fBExample 1 \fRSpecifying Root File System on Metadevice
140 The following command edits \fB/etc/system\fR and \fB/etc/vfstab\fR to specify
141 that the root file system is now on metadevice \fBd0\fR.
153 The following example shows the same command using a desriptive name for the
159 # metaroot newrootfilesystem
165 \fBExample 2 \fRSpecifying Root File System on SCSI Disk
168 The following command edits \fB/etc/system\fR and \fB/etc/vfstab\fR to specify
169 that the root file system is now on the SCSI disk device
170 \fB/dev/dsk/c0t3d0s0\fR.
175 # metaroot /dev/dsk/c0t3d0s0
184 \fB\fB/etc/system\fR\fR
187 System configuration information file. See \fBsystem\fR(4).
193 \fB\fB/etc/vfstab\fR\fR
196 File system defaults.
202 \fB\fB/etc/lvm/mddb.cf\fR\fR
205 Metadevice state database locations.
211 \fB\fB/kernel/drv/md.conf\fR\fR
214 Configuration file for the metadevice driver, \fBmd\fR.
220 The following exit values are returned:
227 Successful completion.
242 See \fBattributes\fR(5) for descriptions of the following attributes:
250 ATTRIBUTE TYPE ATTRIBUTE VALUE
252 Interface Stability Stable
258 \fBmdmonitord\fR(1M), \fBmetaclear\fR(1M), \fBmetadb\fR(1M),
259 \fBmetadetach\fR(1M), \fBmetahs\fR(1M), \fBmetainit\fR(1M),
260 \fBmetaoffline\fR(1M), \fBmetaonline\fR(1M), \fBmetaparam\fR(1M),
261 \fBmetarecover\fR(1M), \fBmetarename\fR(1M), \fBmetareplace\fR(1M),
262 \fBmetaset\fR(1M), \fBmetassist\fR(1M), \fBmetastat\fR(1M), \fBmetasync\fR(1M),
263 \fBmetattach\fR(1M), \fBmd.tab\fR(4), \fBmd.cf\fR(4), \fBmddb.cf\fR(4),
264 \fBmd.tab\fR(4), \fBattributes\fR(5), \fBmd\fR(7D)