mirror of
https://github.com/ceph/ceph
synced 2024-12-21 02:42:48 +00:00
9f1ad4db54
- Add note to docs indicating that CephFS is not recommended for production datasets. - Add note to docs indicating that running CephFS with multiple MDS servers is not currently recommended. This fixes issue #5797 http://tracker.ceph.com/issues/5797 Signed-off-by: Scott Devoid <devoid@anl.gov>
86 lines
2.6 KiB
ReStructuredText
86 lines
2.6 KiB
ReStructuredText
=================
|
|
Ceph Filesystem
|
|
=================
|
|
|
|
The :term:`Ceph Filesystem` (Ceph FS) is a POSIX-compliant filesystem that uses
|
|
a Ceph Storage Cluster to store its data. The Ceph filesystem uses the same Ceph
|
|
Storage Cluster system as Ceph Block Devices, Ceph Object Storage with its S3
|
|
and Swift APIs, or native bindings (librados).
|
|
|
|
.. important:: Ceph FS is currently not recommended for production data.
|
|
|
|
.. ditaa::
|
|
+-----------------------+ +------------------------+
|
|
| CephFS Kernel Object | | CephFS FUSE |
|
|
+-----------------------+ +------------------------+
|
|
|
|
+---------------------------------------------------+
|
|
| Ceph FS Library (libcephfs) |
|
|
+---------------------------------------------------+
|
|
|
|
+---------------------------------------------------+
|
|
| Ceph Storage Cluster Protocol (librados) |
|
|
+---------------------------------------------------+
|
|
|
|
+---------------+ +---------------+ +---------------+
|
|
| OSDs | | MDSs | | Monitors |
|
|
+---------------+ +---------------+ +---------------+
|
|
|
|
|
|
Using the Ceph Filesystem requires at least one :term:`Ceph Metadata Server` in
|
|
your Ceph Storage Cluster.
|
|
|
|
|
|
|
|
.. raw:: html
|
|
|
|
<style type="text/css">div.body h3{margin:5px 0px 0px 0px;}</style>
|
|
<table cellpadding="10"><colgroup><col width="33%"><col width="33%"><col width="33%"></colgroup><tbody valign="top"><tr><td><h3>Step 1: Metadata Server</h3>
|
|
|
|
To run the Ceph Filesystem, you must have a running Ceph Storage Cluster with at
|
|
least one :term:`Ceph Metadata Server` running.
|
|
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
Add/Remove MDS <../../rados/deployment/ceph-deploy-mds>
|
|
MDS Configuration <mds-config-ref>
|
|
Journaler Configuration <journaler>
|
|
Manpage ceph-mds <../../man/8/ceph-mds>
|
|
|
|
.. raw:: html
|
|
|
|
</td><td><h3>Step 2: Mount Ceph FS</h3>
|
|
|
|
Once you have a healthy Ceph Storage Cluster with at least
|
|
one Ceph Metadata Server, you may mount your Ceph Filesystem.
|
|
Ensure that you client has network connectivity and the proper
|
|
authentication keyring.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
Mount Ceph FS <kernel>
|
|
Mount Ceph FS as FUSE <fuse>
|
|
Mount Ceph FS in fstab <fstab>
|
|
Manpage cephfs <../../man/8/cephfs>
|
|
Manpage ceph-fuse <../../man/8/ceph-fuse>
|
|
Manpage mount.ceph <../../man/8/mount.ceph>
|
|
|
|
|
|
.. raw:: html
|
|
|
|
</td><td><h3>Additional Details</h3>
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
Using Ceph with Hadoop <hadoop>
|
|
libcephfs <../../api/libcephfs-java/>
|
|
Troubleshooting <troubleshooting>
|
|
|
|
.. raw:: html
|
|
|
|
</td></tr></tbody></table>
|