dispersion.conf(5)

dispersion.conf5

Configuration file for the openstack swift dispersion tools

Usage

dispersion.conf

Overview

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 https://docs.openstack.org/swift/latest/admin_guide.html#dispersion-report and https://docs.openstack.org/swift/latest/

Releases

6 releases since Debian 8 (Jessie); the text changed 2 times.

  1. 8
  2. 9
  3. 10–13

From swift 2.35.1-0+deb13u3 in Debian 13 (Trixie). Parsed by carta from the page's man source.