dispersion.conf(5)

💖 dispersion.conf(5) 💖

okay bestie, gather round, because we're about to talk about dispersion.conf — the lil config file for the OpenStack Swift dispersion tools. it's giving "quiet but essential", it's giving "the backbone of your dispersion era". this is from the OpenStack Swift manual, section 5, and honestly? she's a whole vibe. ✨

🌸 NAME 🌸

dispersion.conf — the configuration file for the OpenStack Swift dispersion tools. that's it, that's the name, no notes. 💅

✨ SYNOPSIS ✨

dispersion.conf

🦋 DESCRIPTION 🦋

so like, this is the config file that the dispersion populate and report tools read. that's their whole thing, they live here. 🏠

the file format is super simple, no cap: you've got the '[dispersion]' module as the header, and then all the available parameters chillin' underneath it.

and here's the one rule you gotta remember: any line that starts with a '#' symbol? ignored. straight up ghosted. bye. 👋 comment energy only.

💜 PARAMETERS 💜

here's the whole squad, one by one, no skips, no shortcuts:

• auth_version — the Authentication system API version. the default is 1.0. 🎀
• auth_url — the Authentication system URL.
• auth_user — the Authentication system account/user name.
• auth_key — the Authentication system account/user password. 🤫 keep her safe.
• project_name — Project name in case of keystone auth version 3.
• project_domain_name — Project domain name in case of keystone auth version 3.
• user_domain_name — User domain name in case of keystone auth version 3.
• endpoint_type — the default is 'publicURL'.
• keystone_api_insecure — the default is false.
• swift_dir — location of OpenStack Swift configuration and ring files.
• dispersion_coverage — percentage of partition coverage to use. the default is 1.0.
• retries — maximum number of attempts. the default is 5. (and yes, the original literally says "the defaul" — a typo so iconic we're preserving the lore 💀)
• concurrency — concurrency to use. the default is 25.
• container_populate — the default is true.
• object_populate — the default is true.
• dump_json — whether to output in json format. the default is no.
• container_report — whether to run the container report. the default is yes.
• object_report — whether to run the object report. the default is yes.

🌈 SAMPLE 🌈

here's what it actually looks like when you write it out. copy-paste ready, bestie, i got you:

[dispersion]
auth_url = https://127.0.0.1:443/auth/v1.0
auth_user = dpstats:dpstats
auth_key = dpstats
swift_dir = /etc/swift
# keystone_api_insecure = no
# project_name = dpstats
# project_domain_name = default
# user_domain_name = default
# dispersion_coverage = 1.0
# retries = 5
# concurrency = 25
# dump_json = no
# container_report = yes
# object_report = yes

see how half of them are commented out with #? that's the "optional, uncomment when you need her" energy. main character lines are active, supporting cast is asleep. 😴✨

📚 DOCUMENTATION 📚

want the deep lore? more in depth documentation about the swift-dispersion utilities — and also OpenStack Swift as a whole, because we contain multitudes — can be found at:

https://docs.openstack.org/swift/latest/admin_guide.html#dispersion-report

and

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

go read, you'll eat it up fr fr. 🍓

👀 SEE ALSO 👀

• swift-dispersion-report(1)
• swift-dispersion-populate(1)

ok that's the whole page, every last parameter accounted for, nothing skipped, nothing invented. facts stayed facts, vibes stayed immaculate. 🫶

this has been dispersion.conf(5) from the Linux manual, dated 8/26/2011. mwah, slay, bye bestie 💖👑🌈