From 6e3a070d45b9e4d7dd802311a4e7d9f376cf72a4 Mon Sep 17 00:00:00 2001 From: Rishabh Dave Date: Mon, 4 Nov 2019 19:35:29 +0530 Subject: [PATCH] doc: add systemd unit part for FUSE mounts in fstab doc To make FUSE-mounted CephFS persist across reboots, user also needs to start and enable the systemd units. Add that part to the document for fstab, instead of mentioning it in "Mount CephFS using FUSE" doc. Also, wrap few lines and rename mountpoint to /mnt/mycephfs in examples to keep them same across docs. Fixes: https://tracker.ceph.com/issues/42298 Signed-off-by: Rishabh Dave --- doc/cephfs/fstab.rst | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/doc/cephfs/fstab.rst b/doc/cephfs/fstab.rst index 7e1a7674fce..e6be4a20659 100644 --- a/doc/cephfs/fstab.rst +++ b/doc/cephfs/fstab.rst @@ -27,19 +27,27 @@ See `User Management`_ for details. FUSE ==== -To mount CephFS in your file systems table as a file system in user space, add the -following to ``/etc/fstab``:: +To mount CephFS in your file systems table as a file system in user space, add +the following to ``/etc/fstab``:: #DEVICE PATH TYPE OPTIONS - none /mnt/ceph fuse.ceph ceph.id={user-ID}[,ceph.conf={path/to/conf.conf}],_netdev,defaults 0 0 + none /mnt/mycephfs fuse.ceph ceph.id={user-ID}[,ceph.conf={path/to/conf.conf}],_netdev,defaults 0 0 For example:: - none /mnt/ceph fuse.ceph ceph.id=myuser,_netdev,defaults 0 0 - none /mnt/ceph fuse.ceph ceph.id=myuser,ceph.conf=/etc/ceph/foo.conf,_netdev,defaults 0 0 + none /mnt/mycephfs fuse.ceph ceph.id=myuser,_netdev,defaults 0 0 + none /mnt/mycephfs fuse.ceph ceph.id=myuser,ceph.conf=/etc/ceph/foo.conf,_netdev,defaults 0 0 + +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. + +``ceph-fuse@.service`` and ``ceph-fuse.target`` systemd units are available. +As usual, these unit files declare the default dependencies and recommended +execution context for ``ceph-fuse``. For example, after making the fstab entry +shown above, ``ceph-fuse`` run following commands:: -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. + systemctl start ceph-fuse@-mnt-mycephfs.service + systemctl enable ceph-fuse@-mnt-mycephfs.service See `User Management`_ for details. -- 2.39.5