INFLUXD-BACKUP(1)

📦 version 1.11.6, in opensuse-leap 16.0

✨ INFLUXD-BACKUP(1) ✨ — the backup glow-up, bestie 💅

okay so this is the manual page for influxd-backup (like, the actual Unix manual name INFLUXD-BACKUP(1), yes we're being fancy today 👑) and it's genuinely iconic — it's the whole "save a copy of my database before I do something chaotic" tool. let's get into it 🎀

🌸 NAME 🌸

influxd-backup — creates a backup copy of specified InfluxDB OSS database(s) and saves it to disk. 💖 Use this newer -portable option unless legacy support is required, no cap.

Complete documentation on backing up and restoring, including the deprecated legacy format, lives here (copy it exactly, bestie):

https://docs.influxdata.com/influxdb/latest/administration/backup_and_restore/

🦋 SYNOPSIS 🦋

influxd backup [options] PATH

🌈 DESCRIPTION 🌈

Creates a backup copy of specified InfluxDB OSS database(s) and saves the files in an Enterprise-compatible format to PATH — and yes PATH is literally the directory where backups are saved. main character energy for that directory, honestly. ✨

💅 OPTIONS 💅

ngl bestie, the option lists are the whole vibe. read every single one, don't skip, that's the rule 🫶
  • -portable — required to generate backup files in a portable format that can be restored to InfluxDB OSS or InfluxDB Enterprise. Use this unless the legacy backup is required. it's giving "the good one" 💖
  • -host <host:port> — the InfluxDB OSS host to back up from. optional ✨ defaults to 127.0.0.1:8088, which is the "yeah it's on my machine" default.
  • -db <db_name> — the InfluxDB OSS database name to back up. optional 🎀 if you don't specify it, all databases get backed up when using -portable. generous queen behavior.
  • -rp <rp_name> — retention policy to use for the backup. optional 🦋 if not specified, all retention policies are used by default.
  • -shard <shard_id> — the identifier of the shard to back up. optional 🔥 but heads up: if you specify it, -rp <rp_name> is required. like, they're a package deal, iykyk.
  • -start <timestamp> — include all points starting with the specified timestamp (RFC3339 format). ⚠️ not compatible with -since <timestamp> — pick one, bestie, don't be messy.
  • -end <timestamp> — exclude all points after the timestamp (RFC3339 format). ⚠️ also not compatible with -since <timestamp>.
  • -since <timestamp> — create an incremental backup of all points after the timestamp (RFC3339 format). optional 🫶 tbh the recommendation is to use -start <timestamp> instead. periodt.
  • -skip-errors — optional flag to continue backing up the remaining shards when the current shard fails to backup. it's giving resilience, it's giving "we move" 🧚

🍓 SEE ALSO 🍓

💀 BUGS 💀

Report bugs to the GitHub issue tracker (yes, exactly this, don't @ me otherwise):

https://github.com/influxdata/influxdb

💖 AUTHORS 💖

InfluxDB is written and maintained by InfluxData — https://influxdata.com. literal icons 👑

InfluxDB is released under the MIT license. ✨

This man page is released under Creative Commons Attribution 4.0 International License. 🎀

okay that's the whole page, bestie — go forth and back up responsibly 🦋💅✨

08/09/2024 — shoutout to the source/version and date, the little footer that keeps it all official 💜🫶

📦 where this page comes from