summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/cephfs/fstab.rst36
1 files changed, 32 insertions, 4 deletions
diff --git a/doc/cephfs/fstab.rst b/doc/cephfs/fstab.rst
index b61cd1fcadf..b16654cfec0 100644
--- a/doc/cephfs/fstab.rst
+++ b/doc/cephfs/fstab.rst
@@ -3,7 +3,12 @@
==========================================
If you mount Ceph FS in your file systems table, the Ceph file system will mount
-automatically on startup. To mount Ceph FS in your file systems table, add the
+automatically on startup.
+
+Kernel Driver
+=============
+
+To mount Ceph FS in your file systems table as a kernel driver, add the
following to ``/etc/fstab``::
{ipaddress}:{port}:/ {mount}/{mountpoint} {filesystem-name} [name=username,secret=secretkey|secretfile=/path/to/secretfile],[{mount.options}]
@@ -13,7 +18,30 @@ For example::
10.10.10.10:6789:/ /mnt/ceph ceph name=admin,secretfile=/etc/ceph/secret.key,noatime 0 2
.. important:: The ``name`` and ``secret`` or ``secretfile`` options are
- mandatory when you have Ceph authentication running. See `Authentication`_
- for details.
+ mandatory when you have Ceph authentication running.
+
+See `Authentication`_ for details.
+
- .. _Authentication: ../../rados/operations/authentication/ \ No newline at end of file
+FUSE
+====
+
+To mount Ceph FS in your file systems table as a filesystem in user space, add the
+following to ``/etc/fstab``::
+
+ #DEVICE PATH TYPE OPTIONS
+ id={user-ID}[,conf={path/to/conf.conf}] /mount/path fuse.ceph defaults 0 0
+
+For example::
+
+ id=admin /mnt/ceph fuse.ceph defaults 0 0
+ id=myuser,conf=/etc/ceph/cluster.conf /mnt/ceph2 fuse.ceph defaults 0 0
+
+The ``DEVICE`` field is a comma-delimited list of options to pass to the command line.
+Ensure you use the ID (e.g., ``admin``, not ``client.admin``). You can pass any valid
+``ceph-fuse`` option to the command line this way.
+
+See `Authentication`_ for details.
+
+
+.. _Authentication: ../../rados/operations/authentication/