NAME    [Toc]    [Back]

       rmvol - Removes a volume from an existing domain

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/rmvol [-f] [-v] special domain

OPTIONS    [Toc]    [Back]

       Forces  the  removal of a volume that contains one or more
       stripe segments  without  first  requesting  confirmation.
       Displays  messages that describe which files are moved off
       the specified volume. Using this option  slows  the  rmvol
       process.

OPERANDS    [Toc]    [Back]

       Specifies  the  block  device  special  file name, such as
       /dev/disk/dsk2c, of the volume that you are removing  from
       the  domain.  This command supports shorthand device names
       for block special  devices.  For  example,  if  you  enter
       dsk2g,  it  will be translated to /dev/disk/dsk2g.  Specifies
 the name of the domain.

DESCRIPTION    [Toc]    [Back]

       The rmvol utility enables you to decrease  the  number  of
       volumes  within  an  existing  domain. When you attempt to
       remove a volume, the file  system  automatically  migrates
       the  contents  of  that  volume  to  another volume in the
       domain.

       The logical structure of the filesets in a domain is unaffected
  when  you  remove a volume. If you remove a volume
       that contains a stripe segment, the  rmvol  utility  moves
       the  segment  to another volume that does not already contain
 a stripe segment of the  same  file.  If  a  file  is
       striped  across  all  volumes  in  the domain, the utility
       requests confirmation before placing a second stripe  segment
 on a volume that has one.

       Before you can remove a volume from a domain, all filesets
       in the domain must be mounted. If you try to remove a volume
  from  an  active domain that includes unmounted filesets,
 the system displays an error message indicating that
       a fileset is unmounted. This message is repeated until you
       mount all filesets in the domain.

       If you attempt to remove a volume from an inactive domain,
       the  system  returns  the ENO_SUCH_DOMAIN error message. A
       domain is inactive when none of its filesets  is  mounted.
       In  this  case, the rmvol command does not remove the volume.


       If there is not enough free space on other volumes in  the
       domain  to  accept  the offloaded files from the departing
       volume, the rmvol utility moves as many files as  possible
       to  free space on other volumes. Then a message is sent to
       the console indicating that there is not enough  space  to
       complete  the procedure. The files that were not yet moved
       remain on the original volume.

       You can interrupt the rmvol process without damaging  your
       domain.  AdvFS  will  stop removing files from the volume.
       Files already removed from the volume will remain in their
       new  location. Interrupting an rmvol operation with a system
 crash, a power failure, loosing the remote  login,  or
       the  kill  command can leave the volume in an inaccessible
       state. If a volume does not allow new allocations after an
       rmvol  operation,  use  the chvol -A command to reactivate
       the volume.

RESTRICTIONS    [Toc]    [Back]

       You cannot run the rmvol  utility  while  the  defragment,
       balance,  rmfset,  or rmvol utility is running on the same
       domain.

       You must be the root user to use this utility.

NOTES    [Toc]    [Back]

       This command  supports  shorthand  names  for  LSM  volume
       names.  For  example,  if you enter the following: # rmvol
       testdg.vol1 dom1

       the  volume  name  will  be   translated   to:   #   rmvol
       /dev/vol/testdg/vol1 dom1

EXAMPLES    [Toc]    [Back]

       The  following  example  removes  a  volume from an active
       domain called accounts_dmn. The domain contains  two  volumes,
  /dev/disk/dsk1c  and  /dev/disk/dsk2c. This example
       removes volume /dev/disk/dsk1c from the  domain:  #  rmvol
       dsk1c accounts_dmn

              The  /etc/fdmns/accounts_dmn  subdirectory  now has
              only one entry, the entry for /dev/disk/dsk2c.  The
              following  example removes one volume from a threevolume
 domain.  Each  volume  in  the  accounts_dmn
              domain  contains  one segment of /usr/myfile, which
              is  a  three-way  striped  file:  #   rmvol   dsk3c
              accounts_dmn

              rmvol:   Removing   volume  '/dev/disk/dsk3c'  from
              domain 'accounts_dmn'

              This  volume  contains  one   stripe   segment   of
              /usr/myfile,  which will be moved to another volume
              in the domain that already contains a  stripe  segment
 of /usr/myfile.

              Do you want to continue? (y/n):y

              One  volume in the accounts_dmn domain now contains
              two stripe segments of myfile, which is  no  longer
              an optimally striped file.

FILES    [Toc]    [Back]

       Specifies  the  command  path.   Contains domain names and
       devices.

SEE ALSO    [Toc]    [Back]

       addvol(8),  advfs(4),  advscan(8),   chvol(8),   fdmns(4),
       mkfdmn(8), stripe(8)



                                                         rmvol(8)