container-reconciler.conf(5)

NAME

container-reconciler.conf - configuration file for the OpenStack Swift container reconciler

SYNOPSIS

container-reconciler.conf

DESCRIPTION

This is the configuration file used by the container reconciler.

The configuration file follows the python-pastedeploy syntax. The file is divided into sections, which are enclosed by square brackets. Each section will contain a certain number of key/value parameters which are described later.

Any line that begins with a '#' symbol is ignored.

You can find more information about python-pastedeploy configuration format at https://docs.pylonsproject.org/projects/pastedeploy/en/latest/#config-format

GLOBAL SECTION
    This is indicated by section named [DEFAULT]. Below are the parameters that are acceptable within this section.

    log_address
        Location where syslog sends the logs to. The default is /dev/log.

    log_custom_handlers
        Comma-separated list of functions to call to setup custom log handlers.

    log_facility
        Syslog log facility. The default is LOG_LOCAL0.

    log_level
        Log level used for logging. The default is INFO.

    log_name
        Label used when logging. The default is swift.

    log_statsd_default_sample_rate
        Defines the probability of sending a sample for any given event or timing measurement. The default is 1.0.

    log_statsd_host
        If not set, the StatsD feature is disabled. The default is localhost.

    log_statsd_metric_prefix
        Value will be prepended to every metric sent to the StatsD server.

    log_statsd_port
        The port value for the StatsD server. The default is 8125.

    log_statsd_sample_rate_factor
        It is not recommended to set this to a value less than 1.0, if frequency of logging is too high, tune the log_statsd_default_sample_rate instead. The default value is 1.0.

    log_udp_host
        If not set, the UDP receiver for syslog is disabled.

    log_udp_port
        Port value for UDP receiver, if enabled. The default is 514.

    swift_dir
        Swift configuration directory. The default is /etc/swift.

    user
        User to run as. The default is swift.

CONTAINER RECONCILER SECTION

    [container-reconciler]

    interval
        Minimum time for a pass to take. The default is 30 seconds.

    reclaim_age
        Time elapsed in seconds before an object can be reclaimed. The default is 604800 seconds.

    request_tries
        Server errors from requests will be retried by default. The default is 3.

PIPELINE SECTION

    [pipeline:main]

    pipeline
        Pipeline to use for processing operations. The default is "catch_errors proxy-logging cache proxy-server".

APP SECTION
    For details of the available options see proxy-server.conf.5.

        [app:proxy-server]

        use Entry point for paste.deploy in the server. This is normally egg:swift#proxy.

FILTER SECTIONS
    Any section that has its name prefixed by "filter:" indicates a filter section. Filters are used to specify configuration parameters for specific swift middlewares. Below are the filters available and respective acceptable parameters.

    For details of the available options for each filter section see proxy-server.conf.5.

        [filter:cache]
    Caching middleware that manages caching in swift.

        use Entry point for paste.deploy in the server. This is normally egg:swift#memcache.

        [filter:catch_errors]

        use Entry point for paste.deploy in the server. This is normally egg:swift#catch_errors.

        [filter:proxy-logging]

        use Entry point for paste.deploy in the server. This is normally egg:swift#proxy_logging.

DOCUMENTATION

More in depth documentation in regards to swift-container-reconciler and also about OpenStack Swift as a whole can be found at https://docs.openstack.org/swift/latest/overview_policies.html.

SEE ALSO
swift-container-reconciler(1)