Index for Section 8

Alphabetical listing for R

Bottom of page

rmvol(8)
NAME
  rmvol - Removes a volume from an existing domain

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

OPTIONS
  -f  Forces the removal of a volume that contains one or more stripe
      segments without first requesting confirmation.

  -v  Displays messages that describe which files are moved off the specified
      volume. Using this option slows the rmvol process.

OPERANDS
  special
      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.

  domain
      Specifies the name of the domain.

DESCRIPTION
  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
  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
  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
   1.  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.

   2.  The following example removes one volume from a three-volume 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
  /usr/sbin/rmvol
      Specifies the command path.

  /etc/fdmns
      Contains domain names and devices.

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

Index for Section 8

Alphabetical listing for R

Top of page