METAINIT(1M)

NAME

metainit − configure metadevices

SYNOPSIS

/usr/opt/SUNWmd/sbin/metainit [−s setname ] [ −h ] [ −n ] [ −f ] [ −a | metadevice ]

/usr/opt/SUNWmd/sbin/metainit [−s setname ] [ −n ] [ −f ] md.tab-entry

/usr/opt/SUNWmd/sbin/metainit [−s setname ] −r

AVAILABILITY

This program is available with the Solstice DiskSuite software package (SUNWmd).

DESCRIPTION

metainit configures metadevices using configuration information specified either on the command line or in the /etc/opt/SUNWmd/md.tab file. All metadevices must be set up by metainit before they can be used.

The /etc/opt/SUNWmd/md.tab file contains one configuration entry per line. Each entry specifies a metadevice, a mirror, a metadevice state database, a metatrans device, a RAID device, or a hot spare pool. When metainit is invoked with only a single argument, it searches /etc/opt/SUNWmd/md.tab to find an entry matching that argument.

A complete configuration entry may also be specified on the command line. The entry has the same form as a line from /etc/opt/SUNWmd/md.tab and overrides any entry in that file. For instance, the commands

# metainit d10 2 1 /dev/dsk/c0t1d0s2 1 /dev/dsk/c0t2d0s2
# metainit d1 -m d10

first create a concatenation of two devices and then make a one-way mirror.

The /usr/opt/SUNWmd/sbin/metainit -r command is used when the system is being brought back on-line following either a crash or a shutdown. The command configures all metadevices that were configured prior to the crash or shutdown. Information about the metadevice configuration is obtained from the metadevice state database.

OPTIONS

−a Activates all metadevices defined in /etc/opt/SUNWmd/md.tab.

−h Displays usage message.

−n Checks the syntax of an md.tab entry without setting up the metadevices. If −n is used with −a, all the devices are checked but not initialized.

−r Sets up all metadevices that were configured before the system crashed or was shut down. The information about previously configured metadevices is stored in the metadevice state database (see metadb(1M)).

−f Force metainit to continue even if one of the components is mounted or swapped on. This is useful for setting up mirrors on root, swap, and /usr.

−s setname
Specifies the name of the diskset on which metainit will work. Using the −s option will cause the command to perform its administrative function within the specified diskset. Without this option, the command will perform its function on your local metadevices and/or hot spare pools.

FILES

/etc/opt/SUNWmd/md.tab
Contains list of metadevice configurations.

ERRORS

metainit should not be used to create two-way mirrors when there is already data on the device. Doing so can compromise data integrity. The safest method is to create a one-way mirror using metainit and then use metattach to create the other half of the mirror.

If you use metainit to create a mirror with multiple submirrors, the following message is displayed:

WARNING: This form of metainit is not recommended.
The submirrors may not have the same data.
Please see ERRORS in metainit(1M) for additional information.

Museum

Related Articles