From: John Wilkins <john.wilkins@inktank.com>
Date: Fri, 22 Nov 2013 23:14:46 +0000 (-0800)
Subject: doc: PG splitting added to docs.
X-Git-Tag: v0.74~77
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=dceaef439debe7a405966bc20d62ca72ab4e310c;p=ceph.git

doc: PG splitting added to docs.

fixes: #6727

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
---

diff --git a/doc/rados/operations/placement-groups.rst b/doc/rados/operations/placement-groups.rst
index bcdd97f0e9de..fe23a51de4d0 100644
--- a/doc/rados/operations/placement-groups.rst
+++ b/doc/rados/operations/placement-groups.rst
@@ -60,10 +60,21 @@ Set the Number of Placement Groups
 
 To set the number of placement groups in a pool, you must specify the 
 number of placement groups at the time you create the pool.
+See `Create a Pool`_ for details. Once you've set placement groups for a
+pool, you may increase the number of placement groups (but you cannot
+decrease the number of placement groups). To increase the number of 
+placement groups, execute the following::
 
-See `Create a Pool`_ for details.
+	ceph osd pool set {pool-name} pg_num {pg_num}
+	
+Once you increase the number of placement groups, you must also 
+increase the number of placement groups for placement (``pgp_num``) before your
+cluster will rebalance. The ``pgp_num`` should be equal to the ``pg_num``.
+To increase the number of placement groups for placement, execute the 
+following::
+
+	ceph osd pool set {pool-name} pgp_num {pgp_num}
 
-.. _Create a Pool: ../pools#createpool
 
 Get the Number of Placement Groups
 ==================================   
@@ -171,3 +182,6 @@ entirely. To mark the "unfound" objects as "lost", execute the following::
 	
 	pg-states
 	pg-concepts
+
+
+.. _Create a Pool: ../pools#createpool
\ No newline at end of file