rt-shredder(8)

💖 rt-shredder — the RT reference page, but make it cute 💖

okay bestie, so this is the manual for rt-shredder, part of the Request Tracker reference set (that's the rt-shredder(8) situation, section 8, we're in the system admin zone 💅).

---

✨ NAME ✨

rt-shredder — the script that wipes out tickets from the RT DB. it's giving cleanup era, no cap. 🧹💀

---

✨ SYNOPSIS ✨

rt-shredder --plugin list
rt-shredder --plugin help-Tickets
rt-shredder --plugin 'Tickets=query,Queue="general" and Status="deleted"'

rt-shredder --sqldump unshred.sql --plugin ...
rt-shredder --force --plugin ...

---

✨ DESCRIPTION ✨

so like, rt-shredder wipes out objects from your RT database. it does this using an API that the RT::Shredder module adds to RT. 🦋

and honestly? this script can also just be your example of how to use the shredder API. study material fr fr. 📚✨

---

✨ USAGE ✨

you've got several options that control which objects rt-shredder should wipe out. main character energy: you're the one choosing. 👑

⚠️ okay important: when you're using other options, the --plugin option must be provided last. like, it goes at the end. periodt.

---

✨ OPTIONS ✨

💾 --sqldump <filename>

outputs INSERT queries into a file for all shredded records. this dump can be used to restore data after wiping out. it's the lil save file bestie. 🫶

by default rt-shredder creates files named <ISO_date>-XXXX.sql in the current directory.

🚫💾 --no-sqldump

don't generate the SQL dump file. nope, not doing it. 🙈

the SQL dump file provides you with a way to "undo" the removal of records from your RT database, if needed. so like, only use this option if you are sure you have a recent, valid database backup in case you need to recover data that may have been shredded in error. do not skip the backup bestie, i'm begging 😭

🫥 --object (DEPRECATED)

this option has been deprecated, use plugin "Objects" instead. it's giving retired. ✨

🔌 --plugin '<plugin name>[=<arg>,<val>[;<arg>,<val>]...]'

you can use plugins to select RT objects with various conditions. see also --plugin list and --plugin help options. plug in, glow up, select your objects 💅

📋 --plugin list

outputs list of the available plugins. window shopping. 🛍️

❓ --plugin help-<plugin name>

outputs help for the specified plugin. ask and you shall receive, bestie. 🌸

💥 --force

don't prompt with questions before shredding objects. no take-backs, no lil "are you sure?" moment. it just goes. ⚡

---

👀 SEE ALSO 👀

• RT::Shredder — go read it, iykyk 💜

---

that's the whole page bestie, you ate it up 🎀 this was perl v5.38.2, dated 2023-10-29, filed under rt-shredder(8). slay, go shred responsibly 🦋✨💖