From: Jason Dillaman <dillaman@redhat.com>
Date: Wed, 19 Jul 2017 16:59:51 +0000 (-0400)
Subject: doc: document pool tags in rados pool operations doc
X-Git-Tag: v12.1.2~224^2~2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=878d0b0c3fbc96893723fbaee528176814e764c6;p=ceph.git

doc: document pool tags in rados pool operations doc

Signed-off-by: Jason Dillaman <dillaman@redhat.com>
---

diff --git a/doc/rados/operations/pools.rst b/doc/rados/operations/pools.rst
index b93631d8ca8..6649ef6ba70 100644
--- a/doc/rados/operations/pools.rst
+++ b/doc/rados/operations/pools.rst
@@ -49,6 +49,10 @@ Ideally, you should override the default value for the number of placement
 groups in your Ceph configuration file, as the default is NOT ideal.
 For details on placement group numbers refer to `setting the number of placement groups`_
 
+.. note:: Starting with Luminous, all pools need to be associated to the
+   application using the pool. See `Associate Pool to Application`_ below for
+   more information.
+
 For example:: 
 
 	osd pool default pg num = 100
@@ -153,6 +157,23 @@ placement groups for your pool.
 :Required: No.
 :Default: 0, no splitting at the pool creation time. 
 
+Associate Pool to Application
+=============================
+
+Pools need to be associated with an application before use. Pools that will be
+used with CephFS or pools that are automatically created by RGW are
+automatically associated. Pools that are intended for use with RBD should be
+initialized using the ``rbd`` tool (see `Block Device Commands`_ for more
+information).
+
+For other cases, you can manually associate a free-form application name to
+a pool.::
+
+        ceph osd pool application enable {pool-name} {application-name}
+
+.. note:: CephFS uses the application name ``cephfs``, RBD uses the
+   application name ``rbd``, and RGW uses the application name ``rgw``.
+
 Set Pool Quotas
 ===============
 
@@ -742,3 +763,5 @@ a size of 3).
 .. _Bloom Filter: http://en.wikipedia.org/wiki/Bloom_filter
 .. _setting the number of placement groups: ../placement-groups#set-the-number-of-placement-groups
 .. _Erasure Coding with Overwrites: ../erasure-code#erasure-coding-with-overwrites
+.. _Block Device Commands: ../../../rbd/rados-rbd-cmds/#create-a-block-device-pool
+