Allow specification of object devices for audit

[OpenStack Infra]

https://review.openstack.org/75881
commit 793489b80d212ef53748c8dc1ac0acb8bdfd628e
Author: Eamonn O'Toole <email address hidden>
Date: Mon Feb 24 11:24:56 2014 +0000

    Allow specification of object devices for audit

    In object audit "once" mode we are allowing the user to specify
    a sub-set of devices to audit using the "--devices" command-line
    option. The sub-set is specified as a comma-separated list. This
    patch is taken from a larger patch to enable parallel processing
    in the object auditor.

    We've had to modify recon so that it will work properly with this
    change to "once" mode. We've modified dump_recon_cache()
    so that it will store nested dictionaries, in other words it will
    store a recon cache entry such as {'key1': {'key2': {...}}}. When
    the object auditor is run in "once" mode with "--devices" set the
    object_auditor_stats_ALL and ZBF entries look like:
    {'object_auditor_stats_ALL': {'disk1disk2..diskn': {...}}}. When
    swift-recon is run, it hunts through the nested dicts to find the
    appropriate entries. The object auditor recon cache entries are set
    to {} at the beginning of each audit cycle, and individual disk
    entries are cleared from cache at the end of each disk's audit cycle.

    DocImpact

    Change-Id: Icc53dac0a8136f1b2f61d5e08baf7b4fd87c8123

[Tom Fifield (fifieldt)]

To fix this bug

1) add a new section (or find existing section) on object-auditor to the admin-guide-cloud
2) Ensure it's noted that you can run the object-auditor 'once' in the configuration described in this bug report.

3) Consider adding a mention to the ops-guide

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/219961

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/219961
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=88cc776a5c89097f6e9d4fb0c70bad7ccd9f1b25
Submitter: Jenkins
Branch: master

commit 88cc776a5c89097f6e9d4fb0c70bad7ccd9f1b25
Author: asettle <email address hidden>
Date: Thu Sep 3 12:28:00 2015 +1000

    Documenting specification of object devices for audit

    Adding a new section (from an existing section) on
    object-auditor to the admin-guide-cloud

    Change-Id: I5966f91367b940e506c242307cbdf123892e7d82
    Closes-bug: 1295527

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.