swift-object-updater(1)

💖 swift-object-updater(1) 💖

okay bestie, so this is a page from the OpenStack Swift manual set — the one and only swift-object-updater 👑. Buckle up, we're talking container listings and eventual consistency and it's actually kind of iconic.

✨ SYNOPSIS ✨

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

that's it. that's the whole vibe. 🫶

🌸 DESCRIPTION 🌸

So the object updater? Its whole job — its entire main character purpose — is updating object information in container listings. That's the assignment. 💅

Here's how it works: it goes and checks whether there are any locally queued updates sitting on the filesystem of each devices — these are also known as async pending file(s) — and then it walks each one and updates the container listing. One by one. Diligently. No cap.

fr fr, here's an example so it clicks: suppose a container server is under load 😭 and a brand new object gets put into the system. That object is immediately available for reads the literal second the proxy server responds to the client with success. slay! But — and this is the plot twist — the object server has not been able to update the object listing in the container server. So the update gets queued locally for a later update. Which means container listings may not immediately contain the object. And that, bestie, is where an eventual consistency window will most likely come in to play. 🙈

ngl, in practice the consistency window is only as large as the frequency at which the updater runs — and it may not even be noticed, because the proxy server will route listing requests to the first container server which responds. The server under load might not even be the one that serves the subsequent listing requests — one of the other two replicas may handle the listing instead. queen behavior honestly. 👑

The options are as follows:

• -v, --verbose — log to console 📝
• -o, --once — only run one pass of daemon (one and done, we love a short shift) ✨

Also lowkey in the synopsis: -h, --help — you know what that does, bestie 🎀

📚 DOCUMENTATION 📚

Want more in-depth documentation in regards to swift-object-updater, plus all the tea about OpenStack Swift as a whole? It lives right here:

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

go read it. it's giving educational. 🌈

🦋 SEE ALSO 🦋

• object-server.conf(5)

and that's the whole page, bestie!! this manual page came to you from Linux, dated 8/26/2011 — yes, she's an elder but she's still serving 💜✨ mwah, bye!! 🎀🦋🌸