|
2 | 2 | Mount CephFS using FUSE |
3 | 3 | ======================== |
4 | 4 |
|
5 | | -`ceph-fuse`_ is an alternate way of mounting CephFS, although it mounts it |
6 | | -in userspace. Therefore, performance of FUSE can be relatively lower but FUSE |
7 | | -clients can be more manageable, especially while upgrading CephFS. |
| 5 | +`ceph-fuse`_ can be used as an alternative to the :ref:`CephFS kernel |
| 6 | +driver<cephfs-mount-using-kernel-driver>` to mount CephFS file systems. |
| 7 | +`ceph-fuse`_ mounts are made in userspace. This means that `ceph-fuse`_ mounts |
| 8 | +are less performant than kernel driver mounts, but they are easier to manage |
| 9 | +and easier to upgrade. |
8 | 10 |
|
9 | 11 | Prerequisites |
10 | 12 | ============= |
11 | 13 |
|
12 | | -Go through the prerequisites required by both, kernel as well as FUSE mounts, |
13 | | -in `Mount CephFS: Prerequisites`_ page. |
| 14 | +Ensure that you have all the prerequisites required by both kernel and FUSE |
| 15 | +mounts, as listed on the `Mount CephFS: Prerequisites`_ page. |
14 | 16 |
|
15 | 17 | .. note:: Mounting CephFS using FUSE requires superuser privileges (sudo/root). |
16 | | - The libfuse interface does not provide a mechanism to trim cache entries in the |
17 | | - kernel so a remount (``mount(2)``) system call is required to force the kernel |
18 | | - to drop the cached metadata. ``ceph-fuse`` issues these remount system calls |
19 | | - periodically in response to cache pressure in the MDS or due to metadata cache revocations. |
| 18 | + The libfuse interface does not provide a mechanism to trim cache entries in |
| 19 | + the kernel so a remount (``mount(2)``) system call is required to force the |
| 20 | + kernel to drop the cached metadata. ``ceph-fuse`` issues these remount |
| 21 | + system calls periodically in response to cache pressure in the MDS or due to |
| 22 | + metadata cache revocations. |
20 | 23 |
|
21 | 24 | Synopsis |
22 | 25 | ======== |
23 | | -In general, the command to mount CephFS via FUSE looks like this:: |
| 26 | +This is the general form of the command for mounting CephFS via FUSE: |
24 | 27 |
|
25 | | - ceph-fuse {mountpoint} {options} |
| 28 | +.. prompt:: bash # |
| 29 | + |
| 30 | + ceph-fuse {mountpoint} {options} |
26 | 31 |
|
27 | 32 | Mounting CephFS |
28 | 33 | =============== |
|
0 commit comments