summaryrefslogtreecommitdiffstats
path: root/doc/cephfs/kernel.rst
diff options
context:
space:
mode:
authorRishabh Dave <ridave@redhat.com>2019-11-04 14:44:07 +0100
committerRishabh Dave <ridave@redhat.com>2019-11-14 05:32:01 +0100
commitab9185187dfabe676ce6f2e27559962fd5677405 (patch)
treea082f19829ad98b364994dc57566c39a4507914f /doc/cephfs/kernel.rst
parentdoc: add systemd unit part for FUSE mounts in fstab doc (diff)
downloadceph-ab9185187dfabe676ce6f2e27559962fd5677405.tar.xz
ceph-ab9185187dfabe676ce6f2e27559962fd5677405.zip
doc/cephfs: merge fstab doc with respective mount docs
Fixes: https://tracker.ceph.com/issues/42601 Signed-off-by: Rishabh Dave <ridave@redhat.com>
Diffstat (limited to 'doc/cephfs/kernel.rst')
-rw-r--r--doc/cephfs/kernel.rst21
1 files changed, 18 insertions, 3 deletions
diff --git a/doc/cephfs/kernel.rst b/doc/cephfs/kernel.rst
index c496415ca4c..5a3caa10c97 100644
--- a/doc/cephfs/kernel.rst
+++ b/doc/cephfs/kernel.rst
@@ -111,9 +111,24 @@ To unmount the Ceph file system, use the ``umount`` command as usual::
.. tip:: Ensure that you are not within the file system directories before
executing this command.
-See fstab_ to find out how to make kernel mounted CephFS persist across
-reboots, `User Management`_ for details on CephX user management and
-mount.ceph_ manual for more options it can take. For troubleshooting, see
+Persistent Mounts
+------------------
+
+To mount CephFS in your file systems table as a kernel driver, add the
+following to ``/etc/fstab``::
+
+ [{ipaddress}:{port}]:/ {mount}/{mountpoint} ceph [name=username,secret=secretkey|secretfile=/path/to/secretfile],[{mount.options}]
+
+For example::
+
+ :/ /mnt/ceph ceph name=admin,noatime,_netdev 0 2
+
+The default for the ``name=`` parameter is ``guest``. If the ``secret`` or
+``secretfile`` options are not specified then the mount helper will attempt to
+find a secret for the given ``name`` in one of the configured keyrings.
+
+See `User Management`_ for details on CephX user management and mount.ceph_
+manual for more options it can take. For troubleshooting, see
:ref:`kernel_mount_debugging`.
.. _fstab: ../fstab/#kernel-driver