metaonline

 

---

 
 
 
 Maintenance Commands                              metaoffline(1M)
 
 
 


NAME
      metaoffline,  metaonline  -  place  submirrors  offline  and
      online
 


SYNOPSIS
      metaoffline -h
      metaoffline [ -s setname ] [ -f ] mirror submirror
      metaonline -h
      metaonline [ -s setname ] mirror submirror
 
 


DESCRIPTION
      The metaoffline command prevents DiskSuite from reading  and
      writing to the submirror that has been taken offline.  While
      the submirror is offline, all writes to the mirror  will  be
      kept  track of (by region) and will be written when the sub-
      mirror is brought back online. The metaoffline  command  can
      also  be  used  to  perform online backups: one submirror is
      taken offline and backed up while the mirror remains  acces-
      sible.  (However,  if  this is a two-way mirror, data redun-
      dancy is lost while one submirror is offline.) The  metaoff-
      line  command differs from the metadetach command because it
      does not sever the logical association between the submirror
      and the mirror. To completely remove a submirror from a mir-
      ror, use the metadetach command.
 
      A submirror that has been taken  offline  will  only  remain
      offline  until the metaonline command is invoked or the sys-
      tem is rebooted.
 
      When the metaonline command is used, reading from and  writ-
      ing  to  the  submirror  resumes.  A resync is automatically
      invoked to resync the regions written  while  the  submirror
      was  offline.  Writes  are  directed to the submirror during
      resync. Reads, however, will come from a  different  submir-
      ror.  Once  the resync operation completes, reads and writes
      are performed on that submirror.  The metaonline command  is
      only  effective  on  a  submirror  of a mirror that has been
      taken offline.
 
      Note: A submirror that has been taken offline with the meta-
      offline command can only be mounted as read-only.
 
 


OPTIONS
      Root privileges  are  required  for  all  of  the  following
      options except -h.
 
      -f   Forces offlining of submirrors that have slices requir-
           ing maintenance.
 
      -h   Displays usage message.
 
      -s setname
           Specifies the name of the diskset on which  metaoffline
           and  metaonline  will  work.   Using the -s option will
           cause the command to perform its  administrative  func-
           tion   within  the  specified  diskset.   Without  this
           option, the command will perform its function on  local
           metadevices.
 
      mirror
           Specifies the metadevice name of the mirror from  which
           the  submirror  will  be  either  taken  offline or put
           online.
 
      submirror
           Specifies the metadevice name of the  submirror  to  be
           either taken offline or put online.
 
 
 EXAMPLES
      This example takes one submirror, d9,  offline  from  mirror
      d10.
 
      # metaoffline d10 d9
 
 
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      bute:   box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE
      VALUE = Availability   SUNWmdu
 
 


SEE ALSO
      metaclear(1M),   metadb(1M),   metadetach(1M),   metahs(1M),
      metainit(1M),  metaparam(1M), metareplace(1M), metaroot(1M),
      metaset(1M),  metastat(1M),   metasync(1M),   metattach(1M),
      md.tab(4), md.cf(4), mddb.cf(4)
 
      Solstice DiskSuite User's Guide, Solstice  DiskSuite  Refer-
      ence
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8            Last change: 1 Oct 1999                    2
 
 
 

---