metaroot(1M) metaroot(1M)
NAME
metaroot - setup system files for root (/) metadevice
SYNOPSIS
/usr/sbin/metaroot -h
/usr/sbin/metaroot [-n] [-k system-name] [-v vfstab-name] [-c mddb.cf-name] [-m md.conf-name] [-R root-path] device
The metaroot command edits the /etc/vfstab and /etc/system files so that the system may be booted with the root file system (/) on an
appropriate metadevice. The only metadevices that support the root file system are a stripe with only a single slice or a mirror on a sin-
gle-slice stripe.
If necessary, the metaroot command can reset a system that has been configured to boot the root file system (/) on a metadevice so that it
uses a physical slice.
Root privileges are required for all of the following options except -h.
The following options are supported:
-c mddb.cf-name Use mddb.cf-name instead of the default /etc/lvm/mddb.cf file as a source of metadevice database locations.
-h Display a usage message.
-k system-name Edit a user-supplied system-name instead of the default /etc/system system configuration information file.
-m md.conf-name Edit the configuration file specified by md.conf-name rather than the default, /kernel/drv/md.conf.
-n Print what would be done without actually doing it.
-R root-path When metaroot modifies system files, it accesses them in their relative location under root-path.
The -R option cannot be used in combination with the -c, -k,-m, or -v options.
Note - The root file system of any non-global zones must not be referenced with the -R option. Doing so might damage the
global zone's file system, might compromise the security of the global zone, and might damage the non-global zone's
file system. See zones(5).
-v vfstab-name Edit vfstab-name instead of the default /etc/vfstab table of file system defaults.
The following operands are supported:
device Specifies either the metadevice or the conventional disk device (slice) used for the root file system (/).
Example 1: Specifying Root File System on Metadevice
The following command edits /etc/system and /etc/vfstab to specify that the root file system is now on metadevice d0.
# metaroot d0
Example 2: Specifying Root File System on SCSI Disk
The following command edits /etc/system and /etc/vfstab to specify that the root file system is now on the SCSI disk device
/dev/dsk/c0t3d0s0.
# metaroot /dev/dsk/c0t3d0s0
/etc/system System configuration information file. See system(4).
/etc/vfstab File system defaults.
/etc/lvm/mddb.cf Metadevice state database locations.
/kernel/drv/md.conf Configuration file for the metadevice driver, md.
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWmdu |
+-----------------------------+-----------------------------+
mdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M), metahs(1M), metainit(1M), metaoffline(1M), metaonline(1M), metaparam(1M),
metarecover(1M), metarename(1M), metareplace(1M), metaset(1M), metassist(1M), metastat(1M), metasync(1M), metattach(1M), md.tab(4),
md.cf(4), mddb.cf(4), md.tab(4), attributes(5), md(7D)
6 Apr 2005 metaroot(1M)