diff options
| author | John Wilkins <john.wilkins@inktank.com> | 2013-03-04 10:59:18 -0800 |
|---|---|---|
| committer | John Wilkins <john.wilkins@inktank.com> | 2013-03-04 10:59:18 -0800 |
| commit | 1d33436043d8595b171bdd14643701823f7b102a (patch) | |
| tree | 1def6054e902e04cdec3f7a54a108cdf49cb7726 | |
| parent | a3f50267aea09109c4a7a8b48a3884fd569a033a (diff) | |
| download | ceph-1d33436043d8595b171bdd14643701823f7b102a.tar.gz | |
doc: Added instructions for ensuring ceph config file and keyring prior to mounting ceph fuse.
fixes: #3796
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
| -rw-r--r-- | doc/cephfs/fuse.rst | 35 |
1 files changed, 28 insertions, 7 deletions
diff --git a/doc/cephfs/fuse.rst b/doc/cephfs/fuse.rst index d1b0fa2ffa4..cd6d74edf65 100644 --- a/doc/cephfs/fuse.rst +++ b/doc/cephfs/fuse.rst @@ -1,15 +1,36 @@ ========================= Mount Ceph FS as a FUSE ========================= -To mount the Ceph file system as a File System in User Space (FUSE), you may -use the ``ceph-fuse`` command. For example:: + +For Ceph version 0.55 and later, ``cephx`` authentication is on by default. +Before mounting a Ceph File System in User Space (FUSE), ensure that the client +host has a copy of the Ceph configuration file and a keyring with CAPS for the +Ceph metadata server. + +#. From your client host, copy the Ceph configuration file from the monitor host + to the ``/etc/ceph`` directory. :: + + sudo mkdir -p /etc/ceph + sudo scp {user}@{server-machine}:/etc/ceph/ceph.conf /etc/ceph/ceph.conf + +#. From your client host, copy the Ceph keyring from the monitor host to + to the ``/etc/ceph`` directory. :: + + sudo scp {user}@{server-machine}:/etc/ceph/ceph.keyring /etc/ceph/ceph.keyring + +#. Ensure that the Ceph configuration file and the keyring have appropriate + permissions set on your client machine (e.g., ``chmod 644``). + +For additional details on ``cephx`` configuration, see +`CEPHX Config Reference`_. + +To mount the Ceph file system as a FUSE, you may use the ``ceph-fuse`` command. +For example:: sudo mkdir /home/usernname/cephfs sudo ceph-fuse -m 192.168.0.1:6789 /home/username/cephfs -If ``cephx`` authentication is on, ``ceph-fuse`` will retrieve the name and -secret from the key ring automatically. - -See `ceph-fuse`_ for details. +See `ceph-fuse`_ for additional details. -.. _ceph-fuse: ../../man/8/ceph-fuse/
\ No newline at end of file +.. _ceph-fuse: ../../man/8/ceph-fuse/ +.. _CEPHX Config Reference: ../../rados/configuration/auth-config-ref
\ No newline at end of file |