AMCLEANUP(8)

📦
version 3.5.4 · 8 versions
, in ubuntu stonking

✨ AMCLEANUP(8) — the "oops we crashed, let's fix it" era ✨

okay bestie, so this page lives in the System Administration Commands corner of the manual-verse, and it's about amcleanup, the lil cleanup fairy that shows up after the tape server has a whole meltdown. 🧚💖

🌸 NAME 🌸

amcleanup — run the Amanda cleanup process after a failure. yes. that's the whole job. she cleans up the mess. 💅

🎀 SYNOPSIS 🎀

amcleanup [-k] [-p] [-r] [-v] [--note string] config

🦋 DESCRIPTION 🦋

so here's the vibe: amcleanup generates the Amanda Mail Report and updates the Amanda databases after a system failure on a tape server host. like, she's doing the post-crash paperwork. iconic of her honestly. ✨

normally this cleanup process just runs automatically as part of the amdump program. no thoughts, head empty, it just happens. but if amdump can't complete for some reason — usually because the tape server host crashed 😭 — then amcleanup has to be run some time later, which is usually during system boot.

also, the amcleanupdisk program is run with the same [-r] and [-v] options. they're besties, they share. 🫶

if you want the full Amanda lore, go read the amanda(8) man page. she has the details. 👑

💜 OPTIONS 💜

  • -k — kill all the processes listed in the log file, plus their children. and if there's no log file at all? then she kills all amdump, amflush and amvault processes and their children too. very "no survivors" energy, ngl. 💀
  • -p — only do the cleanup if all the processes listed in the log file are already terminated. she's patient. she's not gonna yank anything mid-run. 🎀
  • -r — remove bad files in the holding disk. this option gets passed straight on to amcleanupdisk. sharing is caring ✨
  • -v — generate verbose output, aka she tells you everything. this one also gets passed to amcleanupdisk. 📢
  • --note string — add string to the log files, and it'll show up in the NOTES section of the report. cute lil sticky note moment 🍓

🌈 EXAMPLES 🌈

this one runs the Amanda cleanup process by hand after a failure. ya know, the "i guess i'll do it myself" route:

% amcleanup daily

now, if you put this next line in a system boot script (like /etc/rc.local for example), the Amanda cleanup process just runs as part of the reboot — meaning you never have to do it by hand again. set it and forget it, queen:

/usr/local/sbin/amcleanup daily

and if there's literally nothing to do? she just exits normally with the message:

amcleanup: no unprocessed logfile to clean up.

no drama. no fuss. she said "nothing to see here" and left. 💅

⭐ SEE ALSO ⭐

The Amanda Wiki: : http://wiki.zmanda.com/

👑 AUTHORS 👑

  • James da Silva <jds@amanda.org>
  • Stefan G. Weichinger <sgw@amanda.org>

aaaand that's the page bestie, you ate that fr fr 🫶 this whole thing came to you courtesy of Amanda 3.5.4, dated 08/26/2026 — so when you're running amcleanup at 3am after a crash, just know she was written with love. mwah. 💖✨🎀

📦 where this page comes from