swift-dispersion-populate
(1)
Name
swift-dispersion-populate - late
Synopsis
swift-dispersion-populate [--insecure] [conf_file]
Description
OpenStack Swift swift-dispersion-populate(1)
NAME
swift-dispersion-populate - OpenStack Swift dispersion popu-
late
SYNOPSIS
swift-dispersion-populate [--insecure] [conf_file]
DESCRIPTION
This is one of the swift-dispersion utilities that is used
to evaluate the overall cluster health. This is accomplished
by checking if a set of deliberately distributed containers
and objects are currently in their proper places within the
cluster.
For instance, a common deployment has three replicas of each
object. The health of that object can be measured by check-
ing if each replica is in its proper place. If only 2 of the
3 is in place the object's health can be said to be at
66.66%, where 100% would be perfect.
We need to place the containers and objects throughout the
system so that they are on distinct partitions. The swift-
dispersion-populate tool does this by making up random con-
tainer and object names until they fall on distinct parti-
tions. Last, and repeatedly for the life of the cluster, we
need to run the swift-dispersion-report tool to check the
health of each of these containers and objects.
These tools need direct access to the entire cluster and to
the ring files. Installing them on a proxy server will
probably do or a box used for swift administration purposes
that also contains the common swift packages and ring. Both
swift-dispersion-populate and swift-dispersion-report use
the same configuration file, /etc/swift/dispersion.conf .
The account used by these tool should be a dedicated account
for the dispersion stats and also have admin privileges.
OPTIONS
--insecure
Allow accessing insecure keystone server. The key-
stone's certificate will not be verified.
CONFIGURATION
Example /etc/swift/dispersion.conf:
OpenStack Last change: 8/26/2011 1
OpenStack Swift swift-dispersion-populate(1)
[dispersion]
auth_url = https://127.0.0.1:443/auth/v1.0
auth_user = dpstats:dpstats
auth_key = dpstats
swift_dir = /etc/swift
# dispersion_coverage = 1.0
# retries = 5
# concurrency = 25
# endpoint_type = publicURL
EXAMPLE
$ swift-dispersion-populate
Created 2621 containers for dispersion reporting, 38s, 0
retries
Created 2621 objects for dispersion reporting, 27s, 0
retries
DOCUMENTATION
More in depth documentation about the swift-dispersion util-
ities and also OpenStack Swift as a whole can be found at
http://swift.openstack.org/admin_guide.html#cluster-health
and http://swift.openstack.org
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | cloud/openstack/swift |
+---------------+-----------------------+
|Stability | Uncommitted |
+---------------+-----------------------+
SEE ALSO
swift-dispersion-report(1), dispersion.conf(4)
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from http://launch-
pad.net/swift/havana/1.10.0/+download/swift-1.10.0.tar.gz
OpenStack Last change: 8/26/2011 2
OpenStack Swift swift-dispersion-populate(1)
Further information about this software can be found on the
open source community website at http://www.openstack.org/.
OpenStack Last change: 8/26/2011 3