src/ceph/doc/radosgw/pools.rst

   1 =====
   2 Pools
   3 =====
   4
   5 The Ceph Object Gateway uses several pools for its various storage needs,
   6 which are listed in the Zone object (see ``radosgw-admin zone get``). A
   7 single zone named ``default`` is created automatically with pool names
   8 starting with ``default.rgw.``, but a `Multisite Configuration`_ will have
   9 multiple zones.
  10
  11 Tuning
  12 ======
  13
  14 When ``radosgw`` first tries to operate on a zone pool that does not
  15 exist, it will create that pool with the default values from
  16 ``osd pool default pg num`` and ``osd pool default pgp num``. These defaults
  17 are sufficient for some pools, but others (especially those listed in
  18 ``placement_pools`` for the bucket index and data) will require additional
  19 tuning. We recommend using the `Ceph Placement Group’s per Pool
  20 Calculator <http://ceph.com/pgcalc/>`__ to calculate a suitable number of
  21 placement groups for these pools. See
  22 `Pools <http://docs.ceph.com/docs/master/rados/operations/pools/#pools>`__
  23 for details on pool creation.
  24
  25 Pool Namespaces
  26 ===============
  27
  28 .. versionadded:: Luminous
  29
  30 Pool names particular to a zone follow the naming convention
  31 ``{zone-name}.pool-name``. For example, a zone named ``us-east`` will
  32 have the following pools:
  33
  34 -  ``.rgw.root``
  35
  36 -  ``us-east.rgw.control``
  37
  38 -  ``us-east.rgw.meta``
  39
  40 -  ``us-east.rgw.log``
  41
  42 -  ``us-east.rgw.buckets.index``
  43
  44 -  ``us-east.rgw.buckets.data``
  45
  46 The zone definitions list several more pools than that, but many of those
  47 are consolidated through the use of rados namespaces. For example, all of
  48 the following pool entries use namespaces of the ``us-east.rgw.meta`` pool::
  49
  50     "user_keys_pool": "us-east.rgw.meta:users.keys",
  51     "user_email_pool": "us-east.rgw.meta:users.email",
  52     "user_swift_pool": "us-east.rgw.meta:users.swift",
  53     "user_uid_pool": "us-east.rgw.meta:users.uid",
  54
  55 .. _`Multisite Configuration`: ../multisite