BACKUP_DELHOST(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 BACKUP_DELHOST(8) 💖

okay bestie, welcome to the AFS Command Reference bestie ✨ this one's called backup_delhost, and it's the girl whose entire job is deleting a Tape Coordinator entry from the Backup Database. she's a little chaotic (she deletes things!!) but she is SO good at it. let's get into it 🎀

✨ NAME ✨

backup_delhost — deletes a Tape Coordinator entry from the Backup Database 🗑️💅

🦋 SYNOPSIS 🦋

backup delhost -tapehost <tape machine name>
    [-portoffset <TC port offset>] [-localauth]
    [-cell <cell name>] [-help]

backup delh -t <tape machine name>
    [-p <TC port offset>]
    [-l] [-c <cell name>] [-h]

two forms, same energy, pick whichever one your fingers vibe with 💖

🌸 DESCRIPTION 🌸

so backup delhost deletes the Tape Coordinator entry you point at from the Backup Database. and the way that it's literally then impossible to submit backup operations to that Tape Coordinator, even if it's still running?? yeah. that's the whole point. no cap. 🙈

but listen — to keep the config info consistent, you should also remove the corresponding entry from the /var/lib/openafs/backup/tapeconfig file on the Tape Coordinator machine. don't leave it hanging, that's so not slay of you. 💀

oh and if you wanna see the Tape Coordinator machines and port offsets that are already defined in the Backup Database? just run the backup listhosts command, she'll show you everything 👑

💅 OPTIONS 💅

  • -tapehost <tape machine name> — tells her the hostname of the machine housing the Tape Coordinator you wanna delete. that's the one getting yeeted. 🫶
  • -portoffset <TC port offset> — the port offset number of the Tape Coordinator to delete. if you skip it, it defaults to 0, no biggie. if you do give it, it's an integer between 0 (zero) and 58510, and it must match the port offset number assigned to the same combination of Tape Coordinator and tape device or file in the /var/lib/openafs/backup/tapeconfig file on the Tape Coordinator machine indicated by the -tapehost argument. 👑 like it has to match-match, iykyk.
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. the backup command interpreter presents it to the Backup Server, Volume Server and VL Server during mutual authentication. 🎀 do NOT combine this flag with the -cell argument tho, that's a vibe check fail. for more details, see backup(8).
  • -cell <cell name> — names the cell in which to run the command. do NOT combine this argument with the -localauth flag. again — for more details, see backup(8). 🦋
  • -help — prints the online help for this command. and bestie, all other valid options are ignored when you do this. she said focus on ME. 💅

🌈 EXAMPLES 🌈

okay so imagine you want to delete the Backup Database entry for the Tape Coordinator with port offset 2 on the Tape Coordinator machine "backup3.example.com". you'd do this and it works, fr fr:

% backup delhost -tapehost backup3.example.com -portoffset 2

ate. no crumbs. ✨

🔥 PRIVILEGE REQUIRED 🔥

whoever's issuing this must be listed in the /etc/openafs/server/UserList file on every machine where the Backup Server is running. OR — plot twist — they must be logged onto a server machine as the local superuser "root" if the -localauth flag is included. main character energy only, sorry bestie 👑

🎀 SEE ALSO 🎀

go read those too, they're all iconic in their own way 💜

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

and that's the whole page, bestie 🫶 this was OpenAFS, dated 2026-07-27, from the BACKUP_DELHOST(8) era of the manual — slay, periodt, go delete that host responsibly 💖✨

📦 where this page comes from