From: Loic Dachary Date: Sun, 31 Aug 2014 22:33:20 +0000 (+0200) Subject: documentation: add the mark_unfound_lost delete option X-Git-Tag: v0.86~158^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F2369%2Fhead;p=ceph.git documentation: add the mark_unfound_lost delete option Signed-off-by: Loic Dachary --- diff --git a/doc/rados/operations/control.rst b/doc/rados/operations/control.rst index 7f651aff740f..f3d7b7c886c8 100644 --- a/doc/rados/operations/control.rst +++ b/doc/rados/operations/control.rst @@ -82,10 +82,10 @@ of times. They should be recovering. reported to the monitor cluster in a while (configured by ``mon_osd_report_timeout``). -Revert "lost" objects to their prior state, either a previous version +Delete "lost" objects or revert them to their prior state, either a previous version or delete them if they were just created. :: - ceph pg {pgid} mark_unfound_lost revert + ceph pg {pgid} mark_unfound_lost revert|delete OSD Subsystem diff --git a/doc/rados/operations/placement-groups.rst b/doc/rados/operations/placement-groups.rst index 0fa0f1212cc6..64e1548dbba7 100644 --- a/doc/rados/operations/placement-groups.rst +++ b/doc/rados/operations/placement-groups.rst @@ -186,7 +186,7 @@ Currently the only supported option is "revert", which will either roll back to a previous version of the object or (if it was a new object) forget about it entirely. To mark the "unfound" objects as "lost", execute the following:: - ceph pg {pg-id} mark_unfound_lost revert + ceph pg {pg-id} mark_unfound_lost revert|delete .. important:: Use this feature with caution, because it may confuse applications that expect the object(s) to exist. diff --git a/doc/rados/troubleshooting/troubleshooting-pg.rst b/doc/rados/troubleshooting/troubleshooting-pg.rst index 10f2d2d99203..3c4b4224061f 100644 --- a/doc/rados/troubleshooting/troubleshooting-pg.rst +++ b/doc/rados/troubleshooting/troubleshooting-pg.rst @@ -277,13 +277,17 @@ possible given unusual combinations of failures that allow the cluster to learn about writes that were performed before the writes themselves are recovered. To mark the "unfound" objects as "lost":: - ceph pg 2.5 mark_unfound_lost revert + ceph pg 2.5 mark_unfound_lost revert|delete This the final argument specifies how the cluster should deal with -lost objects. Currently the only supported option is "revert", which -will either roll back to a previous version of the object or (if it -was a new object) forget about it entirely. Use this with caution, as -it may confuse applications that expected the object to exist. +lost objects. + +The "delete" option will forget about them entirely. + +The "revert" option (not available for erasure coded pools) will +either roll back to a previous version of the object or (if it was a +new object) forget about it entirely. Use this with caution, as it +may confuse applications that expected the object to exist. Homeless Placement Groups