swift-object-replicator(1)

✨ swift-object-replicator — the manual, but make it make sense ✨

okay bestie, so this is swift-object-replicator(1) from OpenStack Swift — it's a section 1 command page, and it's literally the object replicator. she keeps your cluster from being a mess. let's get into it 💅

🌸 NAME 🌸

swift-object-replicator — OpenStack Swift object replicator. that's the whole vibe. she replicates objects. 🦋

🌈 SYNOPSIS 🌈

swift-object-replicator [CONFIG] [-h|--help] [-v|--verbose] [-o|--once]

that's it, that's the whole invocation. [CONFIG] goes first, then your flags, and she's off. ✨

💖 DESCRIPTION 💖

okay so the whole point of replication is to keep the system in a consistent state when stuff goes temporarily wrong — think network outages, think drive failures, think the universe being rude. 😭

The replication processes compare local data with each remote copy to make sure they all have the latest version. no stragglers, no dusty old copies, we don't do that here. 🫶

And how does object replication compare them so fast? a hash list — she uses it to quickly compare subsections of each partition. lowkey genius, highkey iconic. 👑

Replication updates are push based. for object replication, updating is literally just a matter of rsyncing files to the peer. that's it. that's the update. ✨

But wait — the replicator also makes sure data gets removed from the system. because deletion matters too, bestie. when an object item is deleted, a tombstone is set as the latest version of that item. the replicator sees the tombstone and makes sure that item gets removed from the entire system. she's thorough. she's committed. she ate. 💅

🎀 OPTIONS 🎀

• -h, --help — shows this help message and exits. classic. polite. we love a flag that just tells you the tea. 🍓
• -d DEVICES, --devices=DEVICES — replicate only the given devices. it's a comma-separated list. heads up though: this only has an effect if --once is used. 👀
• -p PARTITIONS, --partitions=PARTITIONS — replicate only the given partitions. also a comma-separated list. and also — yep — only has an effect if --once is used.
• -i POLICIES, --policies=POLICIES — replicate only the given policy indices. comma-separated list again. and yes, same rule: only has an effect if --once is used. ✨
• -v, --verbose — log to console. she gets chatty. we love that for her. 🗣️
• -o, --once — only run one pass of the daemon. one and done. no looping. main character doing a single lap and leaving. 🏃♀️

ngl bestie, notice how -d, -p and -i are all only effective with --once? yeah. don't forget that part or you'll be confused and we can't have that. 💀

📚 DOCUMENTATION 📚

want more in-depth documentation about swift-object-replicator, or about OpenStack Swift as a whole? it lives right here, no gatekeeping:

https://docs.openstack.org/swift/latest/

go read it. it's giving educational. 🧚

👀 SEE ALSO 👀

• object-server.conf(5) — the config page, go say hi 💜

cute little sign-off: this page came from the Linux manual, dated 8/26/2011, and it belongs to swift-object-replicator(1) in the OpenStack Swift world. periodt. 💖✨🎀