summaryrefslogtreecommitdiffstats
path: root/doc/cephfs/kernel.rst
blob: 89f481f9f644f8c7c08b07895a0a94e747009947 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
====================================
 Mount CephFS with the Kernel Driver
====================================

To mount the Ceph file system you may use the ``mount`` command if you know the
monitor host IP address(es), or use the ``mount.ceph`` utility to resolve the 
monitor host name(s) into IP address(es) for you. For example:: 

	sudo mkdir /mnt/mycephfs
	sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs

To mount the Ceph file system with ``cephx`` authentication enabled, the kernel
must authenticate with the cluster. The default ``name=`` option is ``guest``.
The mount.ceph helper will automatically attempt to find a secret key in the
keyring.

The secret can also be specified manually with the ``secret=`` option. ::

	sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs -o name=admin,secret=AQATSKdNGBnwLhAAnNDKnH65FmVKpXZJVasUeQ==

The foregoing usage leaves the secret in the Bash history. A more secure
approach reads the secret from a file. For example::

	sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs -o name=admin,secretfile=/etc/ceph/admin.secret

See `User Management`_ for details on cephx.
	
If you have more than one file system, specify which one to mount using
the ``mds_namespace`` option, e.g. ``-o mds_namespace=myfs``.

To unmount the Ceph file system, you may use the ``umount`` command. For example:: 

	sudo umount /mnt/mycephfs

.. tip:: Ensure that you are not within the file system directories before
   executing this command.

See `mount.ceph`_ for details.

.. _mount.ceph: ../../man/8/mount.ceph/
.. _User Management: ../../rados/operations/user-management/