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 bcdd97f0e9de937d3773d9d3063da84933ca3866..fe23a51de4d05d1c7a8d4a6289af628271ba4b5f 100644 (file)
--- 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