From b400dfcb90f9b0989452d9db94f03cac32b99ccf Mon Sep 17 00:00:00 2001 From: Clark Boylan Date: Thu, 17 Jun 2021 09:53:08 -0700 Subject: [PATCH] Add note about afs01's mirror-update vos releases to docs I tripped over this during recent afs fileserver reboots. Note it in the docs so that we are aware of this in the future when doing maintenance. Change-Id: Iac20fa6b9ec17f1eb69c50bc8f5736b34967fd83 --- doc/source/afs.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/doc/source/afs.rst b/doc/source/afs.rst index 3e0c69fba9..2c97bd7399 100644 --- a/doc/source/afs.rst +++ b/doc/source/afs.rst @@ -644,7 +644,9 @@ afs0X.openstack.org Taking down the actual fileservers is slightly more complicated but works similarly. Basically what we need to do is make sure that either no one needs the RW volumes hosted by a fileserver before -taking it down or move the RW volume to another fileserver. +taking it down or move the RW volume to another fileserver. When +taking down afs01.dfw.openstack.org we must also ensure that the +vos releases that are performed on it by mirror-update are stopped. To ensure nothing needs the RW volumes you can hold the various file locks on hosts that publish to AFS and/or remove cron entries @@ -671,8 +673,11 @@ of the other servers:: root@afsdb01:~# vos move -id mirror -toserver afs01.ord.openstack.org -topartition vicepa -fromserver afs01.dfw.openstack.org -frompartition vicepa -localauth When that is done (use listvldb command above to check) it is now safe -to take down afs01.dfw.openstack.org while having writers to the mirror -volume. We use the same process as for the db server:: +to take down afs0X.dfw.openstack.org while having writers to the mirror +volume. If operating on afs01.dfw.openstack.org you should also hold +all mirror update locks and the release-volumes lock. This ensures +we do not interrupt any vos releases on afs01.dfw.openstack.org that are +run by mirror-update remotely. We use the same process as for the db server:: root@afsdb01:~# bos shutdown afs01.dfw.openstack.org -localauth root@afsdb01:~# bos status afs01.dfw.openstack.org -localauth