NAME

       swift-get-nodes - OpenStack Swift get-nodes tool

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

       The  swift-get-nodes  tool  can be used to find out the location where a particular account, container or
       object item is located within the swift cluster nodes. For example, if you have the account  hash  and  a
       container  name  that  belongs to that account, you can use swift-get-nodes to lookup where the container
       resides by using the container ring.

OPTIONS

       -h --help
              Shows the help message and exit

       -a, --all
              Show all handoff nodes

       -p PARTITION, --partition=PARTITION
              Show nodes for a given partition

       -P POLICY_NAME, --policy-name=POLICY_NAME
              Specify storage policy name

       -d SWIFT_DIR, --swift-dir=SWIFT_DIR
              Pass location of swift configuration file if 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]

DOCUMENTATION

       More documentation about OpenStack Swift can be found at https://docs.openstack.org/swift/latest/

SEE ALSO

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