]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: add systemd unit part for FUSE mounts in fstab doc
authorRishabh Dave <ridave@redhat.com>
Mon, 4 Nov 2019 14:05:29 +0000 (19:35 +0530)
committerRishabh Dave <ridave@redhat.com>
Wed, 13 Nov 2019 05:40:47 +0000 (11:10 +0530)
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 <ridave@redhat.com>
doc/cephfs/fstab.rst

index 7e1a7674fce6e24164a06447530b262e7d42dea5..e6be4a20659d71194180a5d0b0d97e17e7800f65 100644 (file)
@@ -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.