From 4e2e12e1d00e111d0cf212b8fd5c0c5a533253e8 Mon Sep 17 00:00:00 2001 From: Ian Wienand Date: Fri, 12 Aug 2016 06:28:09 +1000 Subject: [PATCH] Add a short note on removing mirror from AFS A short note on getting rid of a old or incorrect volume. Change-Id: If8aa00773c71eacc58255bfb8a44661728e3084e --- doc/source/afs.rst | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/doc/source/afs.rst b/doc/source/afs.rst index 8599d555d5..9b143a0e4c 100644 --- a/doc/source/afs.rst +++ b/doc/source/afs.rst @@ -333,3 +333,40 @@ our mirror update cron jobs, manually perform the first mirror update: * Once the initial sync and and ``vos release`` are complete, release the lock file on mirror-update. + +Removing a mirror +~~~~~~~~~~~~~~~~~ + +If you need to remove a mirror, you can do the following: + +* Unmount the volume from the R/W location:: + + fs rmmount /afs/.openstack.org/mirror/foo + +* Release the R/O mirror volume to reflect the changes:: + + vos release mirror + +* Check what servers the volumes are on with ``vos listvldb``:: + + VLDB entries for all servers + ... + + mirror.foo + RWrite: 536870934 ROnly: 536870935 + number of sites -> 3 + server afs01.dfw.openstack.org partition /vicepa RW Site + server afs01.dfw.openstack.org partition /vicepa RO Site + server afs01.ord.openstack.org partition /vicepa RO Site + ... + +* Remove the R/O replicas (you can also see these with ``vos + listvol -server afs0[1|2].dfw.openstack.org``):: + + vos remove -server afs01.dfw.openstack.org -partition a -id mirror.foo.readonly + vos remove -server afs02.dfw.openstack.org -partition a -id mirror.foo.readonly + +* Remove the R/W volume:: + + vos remove -server afs02.dfw.openstack.org -partition a -id mirror.foo +