swift-get-nodes(1)

✨ swift-get-nodes(1) ✨

okay bestie, welcome to swift-get-nodes — it's the OpenStack Swift get-nodes tool, and it's literally about to tell you where your stuff actually lives. 💅

🌸 NAME 🌸

swift-get-nodes — the OpenStack Swift get-nodes tool. yes that's the whole vibe. she does one thing and she does it iconically.

🦋 SYNOPSIS 🦋

swift-get-nodes  [options] <ring.gz> <account> [<container> [<object>]]

Or

swift-get-nodes [options] <ring.gz> -p <partition>

Or

swift-get-nodes  [options] -P policy_name <account> <container> <object>

💖 DESCRIPTION 💖

so like, swift-get-nodes is the tool you use to find out where a particular account, container, or object item is actually located inside your swift cluster nodes. it's giving "where does this thing live" energy. 🔍

for example — and I'm obsessed with this — if you have the account hash and a container name that belongs to that account, you can use swift-get-nodes to look up where the container resides, by using the container ring. slay. ✨

🎀 OPTIONS 🎀

• -h, --help — shows the help message and dips. exit. bye. 👋
• -a, --all — show all the handoff nodes. all of them. the whole crew. 🫶
• -p PARTITION, --partition=PARTITION — show nodes for a given partition. you give her a partition, she gives you nodes. simple as that. 🗂️
• -P POLICY_NAME, --policy-name=POLICY_NAME — specify storage policy name. yes capital P, don't mix her up with lowercase -p, they are NOT the same girl. 💀
• -d SWIFT_DIR, --swift-dir=SWIFT_DIR — pass the location of the swift configuration file if it's different from the default location /etc/swift. 🏠

Example:

$ swift-get-nodes /etc/swift/account.ring.gz MyAccount-12ac01446be2

Account     MyAccount-12ac01446be2
Container   None
Object      None

Partition 221082
Hash d7e6ba68cfdce0f0e4ca7890e46cacce

Server:Port Device      172.24.24.29:6202 sdd
Server:Port Device      172.24.24.27:6202 sdr
Server:Port Device      172.24.24.32:6202 sde
Server:Port Device      172.24.24.26:6202 sdv    [Handoff]

curl -I -XHEAD
http://172.24.24.29:6202/sdd/221082/MyAccount-12ac01446be2
curl -I -XHEAD
http://172.24.24.27:6202/sdr/221082/MyAccount-12ac01446be2
curl -I -XHEAD
http://172.24.24.32:6202/sde/221082/MyAccount-12ac01446be2
curl -I -XHEAD
http://172.24.24.26:6202/sdv/221082/MyAccount-12ac01446be2 #
[Handoff]

ssh 172.24.24.29 ls -lah
/srv/node/sdd/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/
ssh 172.24.24.27 ls -lah
/srv/node/sdr/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/
ssh 172.24.24.32 ls -lah
/srv/node/sde/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/
ssh 172.24.24.26 ls -lah
/srv/node/sdv/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/
# [Handoff]

look at her go. [Handoff] nodes and everything. ate. 💅

📚 DOCUMENTATION 📚

more documentation about OpenStack Swift can be found at https://docs.openstack.org/swift/latest/ — go read it, it's giving study session energy. 🧚

👀 SEE ALSO 👀

• swift-account-info(1)
• swift-container-info(1)
• swift-object-info(1)
• swift-ring-builder(1)

the whole friend group fr fr. 🫶

okay that's the page, bestie. this was the Linux manual page for swift-get-nodes(1), dated 10/25/2016, from the OpenStack Swift source. stay slaying, and remember: the ring knows where everything is, and now so do you. ✨💖🌈👑