volnuke

(Delete a volume, tracking down what servers it's on)

SYNOPSIS

volnuke [-dFhvn] [-f list-file] volume

volnuke [-Fn] [-f list-file] -m mountpoint

DESCRIPTION

volnuke is a smart vos remove that figures out what servers the volume is on to delete it, including replication sites for replicated volumes. As a safety measure, it prompts the user whether they're sure they want to delete the volume, and for replicated volumes it also checks if any of the replicas have had accesses and prompts the user again to be sure if they do.

Normally, volnuke takes a volume as an argument, but with the -m option it takes a mount point instead and gets the volume name with fs lsmount, and then removes that mount point when it finishes.

OPTIONS

-d, --date

When writing the name of the deleted volume to a file (see the -f option), prepend the current date as YYYY-MM-DD and then a space to each line.

-F, --force

Don't prompt before deleting the volume. This option is NOT RECOMMENDED and is here solely for sysctl/remctl backend scripts.

-f list-file, --file=list-file

Append the name of the deleted volume to the given file. This is used to accumulate a list of volumes to purge from backups. If no file is given, it defaults to /afs/ir/service/afs/data/adsm-delete.

-h, --help

Print out this documentation (which is done simply by feeding the script to perldoc -t).

-m, --mountpoint

Rather than a volume name, take the argument to volnuke as a mount point and get the volume name from fs lsmount. Also removes the mount point after volnuke finishes.

-n, --dry-run, --just-print

Print out volume status information and the commands that mvto would run, but don't execute any of them.

-v, --version

Print out the version of mvto and exit.

EXAMPLES

Delete the volume ls.trip.windlord:

    volnuke ls.trip.windlord

The user will be prompted to confirm the action, and possibly prompted again if the volume is replicated and the read-only replicas have accesses.

FILES

/afs/ir/service/afs/data/adsm-delete

Where the names of deleted volumes are saved so that they can also be purged from ADSM. This path can be overridden with the -f option and changed at the top of this script.

SEE ALSO

fs_lsmount(1), vos(1), vos_examine(1), vos_remove(1)

The current version of this program is available from its web page at <http://www.eyrie.org/~eagle/software/volnuke/>.

AUTHOR

Russ Allbery <rra@stanford.edu>

COPYRIGHT AND LICENSE

Copyright 2002, 2003, 2004 Board of Trustees, Leland Stanford Jr. University.

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

Last spun 2008-01-28 from POD modified 2008-01-23