metaroot(1m) [linux man page]
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)
Check Out this Related Man Page
metaclear(1M) System Administration Commands metaclear(1M) NAME
metaclear - delete active metadevices and hot spare pools SYNOPSIS
/usr/sbin/metaclear -h /usr/sbin/metaclear [-s setname] -a [-f] /usr/sbin/metaclear component /usr/sbin/metaclear [-s setname] [-f] metadevice... hot_spare_pool... /usr/sbin/metaclear [-s setname] -r [-f] metadevice... hot_spare_pool... /usr/sbin/metaclear [-s setname] -p component /usr/sbin/metaclear [-s setname] -p metadevice DESCRIPTION
The metaclear command deletes the specified metadevice or hot_spare_pool., or purges all soft partitions from the designated component. Once a metadevice or hot spare pool is deleted, it must be re-created using metainit before it can be used again. Any metadevice currently in use (open) cannot be deleted. OPTIONS
Root privileges are required for all of the following options except -h. -a Deletes all metadevices and configured hot spare pools in the set named by -s, or the local set by default. -f Deletes (forcibly) a metadevice that contains a subcomponent in an error state. -h Displays usage message. -p Deletes (purges) all soft partitions from the specified metadevice or component. -r Recursively deletes specified metadevices and hot spare pools, but does not delete metadevices on which others depend. -s setname Specifies the name of the diskset on which metaclear will work. Using the -s option causes the command to perform its administrative function within the specified diskset. Without this option, the command performs its function on local metadevices and/or hot spare pools. OPERANDS
metadevice ... Specifies the name(s) of the metadevice(s) to be deleted. component Specifies the c*d*t*s* name(s) of the components containing soft partitions to be deleted. hot_spare_pool ... Specifies the name(s) of the hot spare pools to be deleted in the form hspnnn, where nnn is a number in the range 000-999. EXAMPLES
Example 1: Deleting Various Devices The following example deletes a metadevice named d10. # metaclear /dev/md/dsk/d10 The following example deletes all local metadevices and hot spare pools on the system. # metaclear -a The following example deletes a mirror, d20, with an submirror in an error state. # metaclear -f d20 The following example deletes a hot spare pool, hsp001. # metaclear hsp001 The following example deletes a soft partition, d23. # metaclear d23 The following example purges all soft partitions on the slice c2t3d5s2 if those partitions are not being used by other metadevices or are not open. # metaclear -p c2t3d5s2 The following example purges soft partitions from a metadevice. # metaclear -p d2 d3: Soft Partition is cleared d4: Soft Partition is cleared d5: Soft Partition is cleared 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 ALSO
mdmonitord(1M), metadb(1M), metadetach(1M), metahs(1M), metainit(1M), metaoffline(1M), metaonline(1M), metaparam(1M), metarecover(1M), metarename(1M), metareplace(1M), metaroot(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 8 Aug 2003 metaclear(1M)