From 381ad24d090f2643846502eea4b516f9d4282109 Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Thu, 16 May 2013 23:10:32 -0700 Subject: doc: Added fuse syntax to the fstab doc. fixes: #3672 Signed-off-by: John Wilkins --- doc/cephfs/fstab.rst | 36 ++++++++++++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/cephfs/fstab.rst b/doc/cephfs/fstab.rst index b61cd1fcadf..b16654cfec0 100644 --- a/doc/cephfs/fstab.rst +++ b/doc/cephfs/fstab.rst @@ -3,7 +3,12 @@ ========================================== If you mount Ceph FS in your file systems table, the Ceph file system will mount -automatically on startup. To mount Ceph FS in your file systems table, add the +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}] @@ -13,7 +18,30 @@ For example:: 10.10.10.10:6789:/ /mnt/ceph ceph name=admin,secretfile=/etc/ceph/secret.key,noatime 0 2 .. important:: The ``name`` and ``secret`` or ``secretfile`` options are - mandatory when you have Ceph authentication running. See `Authentication`_ - for details. + mandatory when you have Ceph authentication running. + +See `Authentication`_ for details. + - .. _Authentication: ../../rados/operations/authentication/ \ No newline at end of file +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 + id={user-ID}[,conf={path/to/conf.conf}] /mount/path fuse.ceph defaults 0 0 + +For example:: + + id=admin /mnt/ceph fuse.ceph defaults 0 0 + id=myuser,conf=/etc/ceph/cluster.conf /mnt/ceph2 fuse.ceph defaults 0 0 + +The ``DEVICE`` field is a comma-delimited list of options to pass to the command line. +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 `Authentication`_ for details. + + +.. _Authentication: ../../rados/operations/authentication/ -- cgit v1.2.1