doc: Added radosgw temp remove.

fixes: ceph#3278 Signed-off-by: John Wilkins <[email protected]>
dano · Oct 10, 2012 · 7477a08 · 7477a08
1 parent 041081c
commit 7477a08
Show file tree

Hide file tree

Showing 2 changed files with 19 additions and 0 deletions.
diff --git a/doc/radosgw/index.rst b/doc/radosgw/index.rst
@@ -38,6 +38,7 @@ one API and retrieve it with the other.
 	Manual Install <manual-install>
 	Configuration <config>
 	Config Reference <config-ref>
+	Purging Temp Data <purge-temp>
 	S3 API <s3>
 	Swift API <swift/index>
 	Admin API <admin/index>

diff --git a/doc/radosgw/purge-temp.rst b/doc/radosgw/purge-temp.rst
@@ -0,0 +1,18 @@
+========================
+ Purging Temporary Data
+========================
+
+.. deprecated:: 0.52
+
+When you delete objects (and buckets/containers), the Gateway marks the  data
+for removal, but it is still available to users until it is purged. Since data
+still resides in storage until it is purged, it may take up available storage
+space. To ensure that data marked for deletion isn't taking up a significant
+amount of storage space, you should run the following command periodically:: 
+
+	radosgw-admin temp remove
+
+.. important:: Data marked for deletion may still be read. So consider
+   executing the foregoing command a reasonable interval after data
+   was marked for deletion.
+.. tip:: Consider setting up a ``cron`` job to purge data.