metaroot(1M) System Administration Commands metaroot(1M)NAMEmetaroot - 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
DESCRIPTION
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 single-
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.
OPTIONS
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 data‐
base 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 ta‐
ble of file system defaults.
OPERANDS
The following operands are supported:
device Specifies either the metadevice or the conventional
disk device (slice) used for the root file system (/).
EXAMPLES
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
FILES
/etc/system System configuration information file. See sys‐
tem(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.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWmdu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M), metahs(1M),
metainit(1M), metaoffline(1M), metaonline(1M), metaparam(1M), metare‐
cover(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)
Solaris Volume Manager Administration Guide
SunOS 5.10 6 Apr 2005 metaroot(1M)
