ceph/doc/rados/configuration/index.rst
Kefu Chai 74a84e9be3 doc: indent :maxdepth: using spaces in toc
* indent :maxdepth: directive properly, otherwise sphinx complains
   index.rst:45: WARNING: toctree contains reference to nonexisting
   document u'rados/configuration/    :maxdepth: 1'
* also reindent the entries in toc, so we can add paths without
  documenting their titles. because otherwise the paths inclues an extra
  space, without the proper indent.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2017-03-16 16:39:40 +08:00

64 lines
1.8 KiB
ReStructuredText

===============
Configuration
===============
Ceph can run with a cluster containing thousands of Object Storage Devices
(OSDs). A minimal system will have at least two OSDs for data replication. To
configure OSD clusters, you must provide settings in the configuration file.
Ceph provides default values for many settings, which you can override in the
configuration file. Additionally, you can make runtime modification to the
configuration using command-line utilities.
When Ceph starts, it activates three daemons:
- ``ceph-mon`` (mandatory)
- ``ceph-osd`` (mandatory)
- ``ceph-mds`` (mandatory for cephfs only)
Each process, daemon or utility loads the host's configuration file. A process
may have information about more than one daemon instance (*i.e.,* multiple
contexts). A daemon or utility only has information about a single daemon
instance (a single context).
.. note:: Ceph can run on a single host for evaluation purposes.
.. raw:: html
<table cellpadding="10"><colgroup><col width="50%"><col width="50%"></colgroup><tbody valign="top"><tr><td><h3>Configuring the Object Store</h3>
For general object store configuration, refer to the following:
.. toctree::
:maxdepth: 1
Disks and Filesystems <filesystem-recommendations>
ceph-conf
.. raw:: html
</td><td><h3>Reference</h3>
To optimize the performance of your cluster, refer to the following:
.. toctree::
:maxdepth: 1
Network Settings <network-config-ref>
Auth Settings <auth-config-ref>
Monitor Settings <mon-config-ref>
mon-lookup-dns
Heartbeat Settings <mon-osd-interaction>
OSD Settings <osd-config-ref>
Filestore Settings <filestore-config-ref>
Journal Settings <journal-ref>
Pool, PG & CRUSH Settings <pool-pg-config-ref.rst>
Messaging Settings <ms-ref>
General Settings <general-config-ref>
.. raw:: html
</td></tr></tbody></table>