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

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 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.

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 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.

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:

See Also

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)

Solaris Volume Manager Administration Guide