X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;ds=sidebyside;f=src%2Fceph%2Fdoc%2Fcephfs%2Ffstab.rst;fp=src%2Fceph%2Fdoc%2Fcephfs%2Ffstab.rst;h=dc3871549aabfbcc801d45de0ccc646214c3ef1e;hb=812ff6ca9fcd3e629e49d4328905f33eee8ca3f5;hp=0000000000000000000000000000000000000000;hpb=15280273faafb77777eab341909a3f495cf248d9;p=stor4nfv.git diff --git a/src/ceph/doc/cephfs/fstab.rst b/src/ceph/doc/cephfs/fstab.rst new file mode 100644 index 0000000..dc38715 --- /dev/null +++ b/src/ceph/doc/cephfs/fstab.rst @@ -0,0 +1,46 @@ +========================================== + Mount Ceph FS in your File Systems Table +========================================== + +If you mount Ceph FS in your file systems table, the Ceph file system will mount +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}] + +For example:: + + 10.10.10.10:6789:/ /mnt/ceph ceph name=admin,secretfile=/etc/ceph/secret.key,noatime,_netdev 0 2 + +.. important:: The ``name`` and ``secret`` or ``secretfile`` options are + mandatory when you have Ceph authentication running. + +See `User Management`_ for details. + + +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 + none /mnt/ceph 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 + +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 `User Management`_ for details. + + +.. _User Management: ../../rados/operations/user-management/