From d32b4286de78aa22e13aa6380fc6b8dc1d856220 Mon Sep 17 00:00:00 2001
From: Stephen Jahl <stephenjahl@gmail.com>
Date: Sun, 14 Sep 2014 10:41:16 -0400
Subject: [PATCH] doc: Added bucket management commands to ops/crush-map

Describes the CLI for adding and removing buckets, in addition to the
'moving' instructions which were already present.

Signed-off-by: Stephen Jahl <stephenjahl@gmail.com>
---
 doc/rados/operations/crush-map.rst | 48 ++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/doc/rados/operations/crush-map.rst b/doc/rados/operations/crush-map.rst
index b98cedc4bc6..55658d62c59 100644
--- a/doc/rados/operations/crush-map.rst
+++ b/doc/rados/operations/crush-map.rst
@@ -878,6 +878,34 @@ Where:
 :Required: Yes
 :Example: ``osd.0``
 
+Add a Bucket
+============
+
+To add a bucket in the CRUSH map of a running cluster, execute the ``ceph osd crush add-bucket`` command::
+
+	ceph osd crush add-bucket {bucket-name} {bucket-type}
+
+Where:
+
+``bucket-name``
+
+:Description: The full name of the bucket.
+:Type: String
+:Required: Yes
+:Example: ``rack12``
+
+
+``bucket-type``
+
+:Description: The type of the bucket. The type must already exist in the hierarchy.
+:Type: String
+:Required: Yes
+:Example: ``rack``
+
+
+The following example adds the ``rack12`` bucket to the hierarchy::
+
+	ceph osd crush add-bucket rack12 rack
 
 Move a Bucket
 =============
@@ -903,7 +931,27 @@ Where:
 :Required: No
 :Example: ``datacenter=dc1 room=room1 row=foo rack=bar host=foo-bar-1``
 
+Remove a Bucket
+===============
 
+To remove a bucket from the CRUSH map hierarchy, execute the following::
+
+	ceph osd crush remove {bucket-name}
+
+.. note:: A bucket must be empty before removing it from the CRUSH hierarchy.
+
+Where:
+
+``bucket-name``
+
+:Description: The name of the bucket that you'd like to remove.
+:Type: String
+:Required: Yes
+:Example: ``rack12``
+
+The following example removes the ``rack12`` bucket from the hierarchy::
+
+	ceph osd crush remove rack12
 
 Tunables
 ========