diff options
| author | Rishabh Dave <ridave@redhat.com> | 2019-11-04 15:05:29 +0100 |
|---|---|---|
| committer | Rishabh Dave <ridave@redhat.com> | 2019-11-13 06:40:47 +0100 |
| commit | 6e3a070d45b9e4d7dd802311a4e7d9f376cf72a4 (patch) | |
| tree | e162a9d07ca453978dd9ef37d7b0fb7625e4492b /doc/cephfs | |
| parent | doc: update and improve "mount using kernel driver" doc (diff) | |
| download | ceph-6e3a070d45b9e4d7dd802311a4e7d9f376cf72a4.tar.xz ceph-6e3a070d45b9e4d7dd802311a4e7d9f376cf72a4.zip | |
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 <ridave@redhat.com>
Diffstat (limited to 'doc/cephfs')
| -rw-r--r-- | doc/cephfs/fstab.rst | 22 |
1 files 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. |