rmvol - Removes a volume from an existing domain
/usr/sbin/rmvol [-f] [-v] special domain
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
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.
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
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
You cannot run the rmvol utility while the defragment,
balance, rmfset, or rmvol utility is running on the same
You must be the root user to use this utility.
This command supports shorthand names for LSM volume
names. For example, if you enter the following: # rmvol
the volume name will be translated to: # rmvol
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
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
rmvol: Removing volume '/dev/disk/dsk3c' from
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
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.
Specifies the command path. Contains domain names and
addvol(8), advfs(4), advscan(8), chvol(8), fdmns(4),
[ Back ]