openstack/openstack-manuals
Code Issues Proposed changes

Documenting specification of object devices for audit

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

Change-Id: I5966f91367b940e506c242307cbdf123892e7d82
Closes-bug: 1295527
This commit is contained in:
asettle 2015-09-03 12:28:00 +10:00
parent d6d10a5fb7
commit 88cc776a5c
2 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/admin-guide-cloud/source/objectstorage.rst
View File

@ -12,6 +12,7 @@ Object Storage
objectstorage_ringbuilder.rst
objectstorage_arch.rst
objectstorage_replication.rst
objectstorage_auditors.rst
objectstorage_account_reaper.rst
objectstorage_tenant_specific_image_storage.rst
objectstorage-monitoring.rst

25
doc/admin-guide-cloud/source/objectstorage_auditors.rst Normal file
View File

@ -0,0 +1,25 @@
==============
Object Auditor
==============
On system failures, the XFS file system can sometimes truncate files it is
trying to write and produce zero-byte files. The object-auditor will catch
these problems but in the case of a system crash it is advisable to run
an extra, less rate limited sweep, to check for these specific files.
You can run this command as follows::
swift-object-auditor /path/to/object-server/config/file.conf once -z 1000
.. note::
"-z" means to only check for zero-byte files at 1000 files per second.
It is useful to run the object auditor on a specific device or set of devices.
You can run the object-auditor once as follows::
swift-object-auditor /path/to/object-server/config/file.conf once /
--devices=sda,sdb
.. note::
This will run the object auditor on only the sda and sdb devices.
This parameter accepts a comma separated list of values.