Manual Pages for UNIX Operating System command usage for man metaroot

System Administration Commands                       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


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
                        metadevice database locations.


     -h                 Display a usage message.


     -k system-name     Edit a user-supplied system-name  instead
                        of  the default /etc/system system confi-
                        guration 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.





SunOS 5.11          Last change: 26 Mar 2006                    1






System Administration Commands                       metaroot(1M)



     -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  combina-
                        tion 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  conven-
               tional  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




     The following example shows the same command using a desrip-
     tive name for the metadevice.


       # metaroot newrootfilesystem






SunOS 5.11          Last change: 26 Mar 2006                    2






System Administration Commands                       metaroot(1M)



     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  attri-
     butes:
















SunOS 5.11          Last change: 26 Mar 2006                    3






System Administration Commands                       metaroot(1M)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | storage/svm                 |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


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)




































SunOS 5.11          Last change: 26 Mar 2006                    4