VOS_REMADDRS(1)

✨ VOS_REMADDRS ✨

okay bestie, so this one is vos_remaddrs from the AFS command reference, and it's giving "spring cleaning for your VLDB" energy πŸ’…


🌸 NAME 🌸

vos_remaddrs β€” removes a file server machine's entry from the VLDB 🧹


πŸ¦‹ SYNOPSIS πŸ¦‹

vos remaddrs -uuid <UUID of server>
    [-cell <cell name>] [-noauth] [-localauth]
    [-verbose] [-encrypt] [-noresolve]
    [-config <config directory>]
    [-help]

vos rema -u <UUID of server>
    [-c <cell name>]
    [-noa] [-l] [-v] [-e] [-nor]
    [-co <config directory>]
    [-h]

like, yes, there are two whole spellings because we love a short king abbreviation era πŸ‘‘


πŸ’– DESCRIPTION πŸ’–

So. The vos remaddrs command removes a server entry from the Volume Location Database (aka the VLDB), and honestly? It's iconic but it's picky πŸ’€

Here's the vibe check: there must be no VLDB entries that list the machine as a site for any version of a volume. None. Zero. Nada. If there are still some hanging around, bestie you gotta deal with them first β€” use the vos move or vos remove command to move or remove those volumes before you come back here. 🫢

When is it the right time to do this? When you're taking the corresponding file server machine out of service. That's literally the moment. Removing a VLDB server entry is appropriate exactly then, no cap. ✨

And if you just wanna look at all your VLDB server entries β€” like window shopping, no commitment β€” use the vos listaddrs command instead, okay? πŸ‘€


πŸŽ€ OPTIONS πŸŽ€

  • -uuid <UUID of server> β€” the unique ID, and pls note this is the very same one you get from the "vos listaddrs -printuuid" command. copy-paste it, don't freestyle it πŸ’…
it's giving "short list of options" and honestly, we respect the minimalism. periodt.

🌈 EXAMPLES 🌈

okay so here's a whole command that removes the VLDB server entry for the file server with the addresses 192.12.107.214 and 10.47.11.17. watch and learn:

$ vos remaddrs -uuid 008f157e-bad0-157c-0ffee-357c4d1faa77 -verbose
vos: Removing UUID with addresses:
UUID: 008f157e-bad0-157c-0ffee-357c4d1faa77
192.12.107.214
10.47.11.17

the -verbose flag is out here doing the most and we're obsessed with it β€” it literally shows you the UUID and both addresses as they get removed. main character output energy, fr fr πŸ”₯


πŸ‘‘ PRIVILEGE REQUIRED πŸ‘‘

the issuer must be listed in the /etc/openafs/server/UserList file on each database server machine. so like, not just one of them. each one. every single one. don't be cute about it πŸ₯²


🧚 SEE ALSO 🧚

CellServDB(5), UserList(5), fileserver(8), vos(1), vos_listaddrs(1), vos_setaddrs(1)


Copyright 2014 Sine Nomine Associates. All Rights Reserved.

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Michael Meffie for OpenAFS.


okay that's the whole page πŸ’– thank you for coming to my ted talk, this was OpenAFS, dated 2026-07-27, and you ate that. bye bestie, slay responsibly πŸŽ€βœ¨

πŸ“¦ where this page comes from