2013-05-31 03:28:22 +00:00
|
|
|
=================
|
|
|
|
|
Ceph Filesystem
|
|
|
|
|
=================
|
2012-06-06 17:45:26 +00:00
|
|
|
|
2013-05-31 03:28:22 +00:00
|
|
|
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).
|
2013-05-17 22:56:59 +00:00
|
|
|
|
2015-02-02 11:34:46 +00:00
|
|
|
.. important:: CephFS currently lacks a robust 'fsck' check and
|
|
|
|
|
repair function. Please use caution when storing
|
|
|
|
|
important data as the disaster recovery tools are
|
2015-02-11 12:11:03 +00:00
|
|
|
still under development. For more information about
|
|
|
|
|
using CephFS today, see :doc:`/cephfs/early-adopters`
|
2013-05-17 22:56:59 +00:00
|
|
|
|
|
|
|
|
.. ditaa::
|
|
|
|
|
+-----------------------+ +------------------------+
|
2015-06-18 14:44:58 +00:00
|
|
|
| | | CephFS FUSE |
|
|
|
|
|
| | +------------------------+
|
|
|
|
|
| |
|
|
|
|
|
| | +------------------------+
|
|
|
|
|
| CephFS Kernel Object | | CephFS Library |
|
|
|
|
|
| | +------------------------+
|
|
|
|
|
| |
|
|
|
|
|
| | +------------------------+
|
|
|
|
|
| | | librados |
|
|
|
|
|
+-----------------------+ +------------------------+
|
2013-05-17 22:56:59 +00:00
|
|
|
|
|
|
|
|
+---------------+ +---------------+ +---------------+
|
|
|
|
|
| OSDs | | MDSs | | Monitors |
|
|
|
|
|
+---------------+ +---------------+ +---------------+
|
|
|
|
|
|
|
|
|
|
|
2013-05-31 03:28:22 +00:00
|
|
|
Using the Ceph Filesystem requires at least one :term:`Ceph Metadata Server` in
|
|
|
|
|
your Ceph Storage Cluster.
|
2013-05-17 22:56:59 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. 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>
|
|
|
|
|
|
2013-05-31 03:28:22 +00:00
|
|
|
To run the Ceph Filesystem, you must have a running Ceph Storage Cluster with at
|
|
|
|
|
least one :term:`Ceph Metadata Server` running.
|
2013-05-17 22:56:59 +00:00
|
|
|
|
2012-06-06 17:45:26 +00:00
|
|
|
|
|
|
|
|
.. toctree::
|
2012-11-14 22:57:51 +00:00
|
|
|
:maxdepth: 1
|
2012-06-06 17:45:26 +00:00
|
|
|
|
2013-05-17 22:56:59 +00:00
|
|
|
Add/Remove MDS <../../rados/deployment/ceph-deploy-mds>
|
2012-11-14 22:57:51 +00:00
|
|
|
MDS Configuration <mds-config-ref>
|
2012-12-22 00:14:23 +00:00
|
|
|
Journaler Configuration <journaler>
|
2013-05-17 22:56:59 +00:00
|
|
|
Manpage ceph-mds <../../man/8/ceph-mds>
|
|
|
|
|
|
|
|
|
|
.. raw:: html
|
|
|
|
|
|
2015-02-02 11:36:43 +00:00
|
|
|
</td><td><h3>Step 2: Mount CephFS</h3>
|
2013-05-17 22:56:59 +00:00
|
|
|
|
|
|
|
|
Once you have a healthy Ceph Storage Cluster with at least
|
2014-08-18 15:57:25 +00:00
|
|
|
one Ceph Metadata Server, you may create and mount your Ceph Filesystem.
|
2013-05-17 22:56:59 +00:00
|
|
|
Ensure that you client has network connectivity and the proper
|
|
|
|
|
authentication keyring.
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
2015-02-02 11:36:43 +00:00
|
|
|
Create CephFS <createfs>
|
|
|
|
|
Mount CephFS <kernel>
|
|
|
|
|
Mount CephFS as FUSE <fuse>
|
|
|
|
|
Mount CephFS in fstab <fstab>
|
2012-11-14 22:57:51 +00:00
|
|
|
Manpage cephfs <../../man/8/cephfs>
|
|
|
|
|
Manpage ceph-fuse <../../man/8/ceph-fuse>
|
|
|
|
|
Manpage mount.ceph <../../man/8/mount.ceph>
|
2013-05-17 22:56:59 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
.. raw:: html
|
|
|
|
|
|
|
|
|
|
</td><td><h3>Additional Details</h3>
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
2015-12-14 15:45:30 +00:00
|
|
|
POSIX compatibility <posix>
|
2015-07-23 12:35:35 +00:00
|
|
|
CephFS Quotas <quota>
|
2013-05-17 22:56:59 +00:00
|
|
|
Using Ceph with Hadoop <hadoop>
|
2012-11-16 22:56:46 +00:00
|
|
|
libcephfs <../../api/libcephfs-java/>
|
2014-04-29 08:57:24 +00:00
|
|
|
cephfs-journal-tool <cephfs-journal-tool>
|
2014-07-15 13:28:32 +00:00
|
|
|
File layouts <file-layouts>
|
2014-12-09 13:21:44 +00:00
|
|
|
Client eviction <eviction>
|
|
|
|
|
Handling full filesystems <full>
|
2013-05-24 00:01:51 +00:00
|
|
|
Troubleshooting <troubleshooting>
|
2015-01-05 15:46:38 +00:00
|
|
|
Disaster recovery <disaster-recovery>
|
2015-11-13 14:12:28 +00:00
|
|
|
Client authentication <client-auth>
|
2013-05-17 22:56:59 +00:00
|
|
|
|
|
|
|
|
.. raw:: html
|
|
|
|
|
|
|
|
|
|
</td></tr></tbody></table>
|
