NAME

       dispersion.conf - configuration file for the openstack-swift dispersion tools

SYNOPSIS

       dispersion.conf

DESCRIPTION

       This is the configuration file used by the dispersion populate and report tools.  The file
       format consists of the '[dispersion]' module as the header and available parameters.   Any
       line that begins with a '#' symbol is ignored.

PARAMETERS

       auth_version
              Authentication system API version. The default is 1.0.

       auth_url
              Authentication system URL

       auth_user
              Authentication system account/user name

       auth_key
              Authentication system account/user password

       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 defaul is 5.

       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

       [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

DOCUMENTATION

       More  in depth documentation about the swift-dispersion utilities 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

SEE ALSO

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