unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



rmvol(8)							     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 seg-
      ments 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	sup-
      ports 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 indicat-
  ing 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 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	command	with the -A option 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.

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), fdmns(4), mkfdmn(8),	stripe(8)