]>
Commit | Line | Data |
---|---|---|
91327a77 AA |
1 | .. _ceph-filesystem: |
2 | ||
7c673cae FG |
3 | ================= |
4 | Ceph Filesystem | |
5 | ================= | |
6 | ||
11fdf7f2 | 7 | The Ceph Filesystem (CephFS) is a POSIX-compliant filesystem that uses |
7c673cae FG |
8 | a Ceph Storage Cluster to store its data. The Ceph filesystem uses the same Ceph |
9 | Storage Cluster system as Ceph Block Devices, Ceph Object Storage with its S3 | |
10 | and Swift APIs, or native bindings (librados). | |
11 | ||
12 | .. note:: If you are evaluating CephFS for the first time, please review | |
13 | the best practices for deployment: :doc:`/cephfs/best-practices` | |
14 | ||
15 | .. ditaa:: | |
16 | +-----------------------+ +------------------------+ | |
17 | | | | CephFS FUSE | | |
18 | | | +------------------------+ | |
19 | | | | |
20 | | | +------------------------+ | |
21 | | CephFS Kernel Object | | CephFS Library | | |
22 | | | +------------------------+ | |
23 | | | | |
24 | | | +------------------------+ | |
25 | | | | librados | | |
26 | +-----------------------+ +------------------------+ | |
27 | ||
28 | +---------------+ +---------------+ +---------------+ | |
29 | | OSDs | | MDSs | | Monitors | | |
30 | +---------------+ +---------------+ +---------------+ | |
31 | ||
32 | ||
33 | Using CephFS | |
34 | ============ | |
35 | ||
36 | Using the Ceph Filesystem requires at least one :term:`Ceph Metadata Server` in | |
37 | your Ceph Storage Cluster. | |
38 | ||
39 | ||
40 | ||
41 | .. raw:: html | |
42 | ||
43 | <style type="text/css">div.body h3{margin:5px 0px 0px 0px;}</style> | |
44 | <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> | |
45 | ||
46 | To run the Ceph Filesystem, you must have a running Ceph Storage Cluster with at | |
47 | least one :term:`Ceph Metadata Server` running. | |
48 | ||
49 | ||
50 | .. toctree:: | |
51 | :maxdepth: 1 | |
52 | ||
11fdf7f2 TL |
53 | Add/Remove MDS(s) <add-remove-mds> |
54 | MDS states <mds-states> | |
7c673cae FG |
55 | MDS failover and standby configuration <standby> |
56 | MDS Configuration Settings <mds-config-ref> | |
57 | Client Configuration Settings <client-config-ref> | |
58 | Journaler Configuration <journaler> | |
59 | Manpage ceph-mds <../../man/8/ceph-mds> | |
60 | ||
61 | .. raw:: html | |
62 | ||
63 | </td><td><h3>Step 2: Mount CephFS</h3> | |
64 | ||
65 | Once you have a healthy Ceph Storage Cluster with at least | |
66 | one Ceph Metadata Server, you may create and mount your Ceph Filesystem. | |
b32b8144 | 67 | Ensure that your client has network connectivity and the proper |
7c673cae FG |
68 | authentication keyring. |
69 | ||
70 | .. toctree:: | |
71 | :maxdepth: 1 | |
72 | ||
73 | Create CephFS <createfs> | |
74 | Mount CephFS <kernel> | |
75 | Mount CephFS as FUSE <fuse> | |
76 | Mount CephFS in fstab <fstab> | |
11fdf7f2 TL |
77 | Use the CephFS Shell <cephfs-shell> |
78 | Supported Features of Kernel Driver <kernel-features> | |
7c673cae FG |
79 | Manpage ceph-fuse <../../man/8/ceph-fuse> |
80 | Manpage mount.ceph <../../man/8/mount.ceph> | |
b32b8144 | 81 | Manpage mount.fuse.ceph <../../man/8/mount.fuse.ceph> |
7c673cae FG |
82 | |
83 | ||
84 | .. raw:: html | |
85 | ||
86 | </td><td><h3>Additional Details</h3> | |
87 | ||
88 | .. toctree:: | |
89 | :maxdepth: 1 | |
90 | ||
91 | Deployment best practices <best-practices> | |
11fdf7f2 | 92 | MDS States <mds-states> |
7c673cae | 93 | Administrative commands <administration> |
11fdf7f2 | 94 | Understanding MDS Cache Size Limits <cache-size-limits> |
7c673cae FG |
95 | POSIX compatibility <posix> |
96 | Experimental Features <experimental-features> | |
97 | CephFS Quotas <quota> | |
98 | Using Ceph with Hadoop <hadoop> | |
99 | cephfs-journal-tool <cephfs-journal-tool> | |
100 | File layouts <file-layouts> | |
101 | Client eviction <eviction> | |
102 | Handling full filesystems <full> | |
103 | Health messages <health-messages> | |
104 | Troubleshooting <troubleshooting> | |
105 | Disaster recovery <disaster-recovery> | |
106 | Client authentication <client-auth> | |
107 | Upgrading old filesystems <upgrading> | |
108 | Configuring directory fragmentation <dirfrags> | |
109 | Configuring multiple active MDS daemons <multimds> | |
11fdf7f2 TL |
110 | Export over NFS <nfs> |
111 | Application best practices <app-best-practices> | |
112 | Scrub <scrub> | |
81eedcae | 113 | LazyIO <lazyio> |
11fdf7f2 TL |
114 | |
115 | .. toctree:: | |
116 | :hidden: | |
117 | ||
118 | Advanced: Metadata repair <disaster-recovery-experts> | |
7c673cae FG |
119 | |
120 | .. raw:: html | |
121 | ||
122 | </td></tr></tbody></table> | |
123 | ||
124 | For developers | |
125 | ============== | |
126 | ||
127 | .. toctree:: | |
128 | :maxdepth: 1 | |
129 | ||
130 | Client's Capabilities <capabilities> | |
131 | libcephfs <../../api/libcephfs-java/> | |
132 | Mantle <mantle> | |
133 |