NAME

metainit − configure metadevices specified in /etc/md.conf

SYNOPSIS

/usr/etc/metainit [ −h ] [ −n ] [ −f ] [ −a | metadevice ]

/usr/etc/metainit -r

/usr/etc/metainit [ −n ] [ −f ] md.conf-entry

AVAILABILITY

This program is available with the Sun Online: DiskSuite software package. 

DESCRIPTION

metainit configures metadevices using configuration information specified either on the command line or in the /etc/md.conf file and invokes metad(8) if the daemon is not already running.  All metadevices must be set up by metainit before they can be used. 

The /etc/md.conf file contains one configuration entry per line.  Each entry specifies a metadevice, a mirror, a metadevice state database, or a hot spare pool.  When metainit is invoked with only a single argument, it searches /etc/md.conf 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/md.conf and overrides any entry in that file.  For instance, the commands

# metainit /dev/md0b 2 1 /dev/id001a 1 /dev/id002a
# metainit /dev/md0a -m /dev/md0b

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

The /usr/etc/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/md.conf. 

−h Displays usage message. 

−n Check validity of /etc/md.conf 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(8)).  The command, /usr/etc/metainit -r should be added to the /etc/rc.boot file, before fsck(8) so that metadevices are configured automatically during reboot. 

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

FILES

/etc/md.conf Contains list of metadevice configurations. 

SEE ALSO

md(4s), md.conf(5), mddb.conf(5), metatab(5), metaclear(8), metad(8), metadb(8), metahs(8), metaoffline(8), metaparam(8), metareplace(8), metastat(8), metasync(8), metattach(8)

Sun Online: DiskSuite Administration Guide
System and Network Administration

Sun Release 4.1  —  Last change: 23 July 1991