ceph/doc/rados/configuration/index.rst

   1 ===============
   2  Configuration
   3 ===============
   4
   5 Ceph can run with a cluster containing thousands of Object Storage Devices
   6 (OSDs). A minimal system will have at least two OSDs for data replication. To
   7 configure OSD clusters, you must provide settings in the configuration file.
   8 Ceph provides default values for many settings, which you can override in the
   9 configuration file. Additionally, you can make runtime modification to the
  10 configuration using command-line utilities.
  11
  12 When Ceph starts, it activates three daemons:
  13
  14 - ``ceph-mon`` (mandatory)
  15 - ``ceph-osd`` (mandatory)
  16 - ``ceph-mds`` (mandatory for cephfs only)
  17
  18 Each process, daemon or utility loads the host's configuration file. A process
  19 may have information about more than one daemon instance (*i.e.,* multiple
  20 contexts). A daemon or utility only has information about a single daemon
  21 instance (a single context).
  22
  23 .. note:: Ceph can run on a single host for evaluation purposes.
  24
  25
  26 .. raw:: html
  27
  28         <table cellpadding="10"><colgroup><col width="50%"><col width="50%"></colgroup><tbody valign="top"><tr><td><h3>Configuring the Object Store</h3>
  29
  30 For general object store configuration, refer to the following:
  31
  32 .. toctree::
  33    :maxdepth: 1
  34
  35    Storage devices <storage-devices>
  36    ceph-conf
  37
  38
  39 .. raw:: html
  40
  41         </td><td><h3>Reference</h3>
  42
  43 To optimize the performance of your cluster, refer to the following:
  44
  45 .. toctree::
  46    :maxdepth: 1
  47
  48    Network Settings <network-config-ref>
  49    Auth Settings <auth-config-ref>
  50    Monitor Settings <mon-config-ref>
  51    mon-lookup-dns
  52    Heartbeat Settings <mon-osd-interaction>
  53    OSD Settings <osd-config-ref>
  54    BlueStore Settings <bluestore-config-ref>
  55    FileStore Settings <filestore-config-ref>
  56    Journal Settings <journal-ref>
  57    Pool, PG & CRUSH Settings <pool-pg-config-ref.rst>
  58    Messaging Settings <ms-ref>
  59    General Settings <general-config-ref>
  60
  61
  62 .. raw:: html
  63
  64         </td></tr></tbody></table>