From 255f996916d9c7a90311809b9a01d7aa9cd6030d Mon Sep 17 00:00:00 2001
From: "James E. Blair" <jeblair@redhat.com>
Date: Mon, 20 Jan 2020 09:43:07 -0800
Subject: [PATCH] Add docs for deleting an AFS volume

Change-Id: I1763eb2bf580591b68bf4e2853378331b8261293
---
 doc/source/afs.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/doc/source/afs.rst b/doc/source/afs.rst
index 63bfcf24e7..b2381da179 100644
--- a/doc/source/afs.rst
+++ b/doc/source/afs.rst
@@ -246,6 +246,27 @@ the read-only path.
 
 You should set the volume quota with ``fs setquota``.
 
+Deleting a Volume
+~~~~~~~~~~~~~~~~~
+
+Remove the mountpoint(s) of the volume::
+
+  fs rmmount /afs/.openstack.org/path/to/mountpoint
+
+Be sure to release the parent volume (with ``vos release``) if
+necessary after removing the mountpoint.
+
+Run ``vos examine`` to see a list of volume sites.  Identify the
+read-write and read-only sites.
+
+Remove the read-only sites first; repeat this command for each one::
+
+  vos remove -server $FILESERVER -partition $PARTITION -id $VOLUME.readonly
+
+Remove the read-write volume::
+
+  vos remove -id $VOLUME
+
 Adding a Fileserver
 ~~~~~~~~~~~~~~~~~~~
 Put the machine's public IP on a single line in