Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

metaroot


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

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  metadev-
     ices  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 meta-
                     device 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 sys-
                             tem, 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  con-
                     ventional  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  metadev-
                             ice 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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWmdu                     |
    |_____________________________|_____________________________|


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








Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments