src/ceph/doc/cephfs/kernel.rst

   1 ======================================
   2  Mount Ceph FS with the Kernel Driver
   3 ======================================
   4
   5 To mount the Ceph file system you may use the ``mount`` command if you know the
   6 monitor host IP address(es), or use the ``mount.ceph`` utility to resolve the
   7 monitor host name(s) into IP address(es) for you. For example::
   8
   9         sudo mkdir /mnt/mycephfs
  10         sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs
  11
  12 To mount the Ceph file system with ``cephx`` authentication enabled, you must
  13 specify a user name and a secret. ::
  14
  15         sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs -o name=admin,secret=AQATSKdNGBnwLhAAnNDKnH65FmVKpXZJVasUeQ==
  16
  17 The foregoing usage leaves the secret in the Bash history. A more secure
  18 approach reads the secret from a file. For example::
  19
  20         sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs -o name=admin,secretfile=/etc/ceph/admin.secret
  21
  22 If you have more than one filesystem, specify which one to mount using
  23 the ``mds_namespace`` option, e.g. ``-o mds_namespace=myfs``.
  24
  25 See `User Management`_ for details on cephx.
  26
  27 To unmount the Ceph file system, you may use the ``umount`` command. For example::
  28
  29         sudo umount /mnt/mycephfs
  30
  31 .. tip:: Ensure that you are not within the file system directories before
  32    executing this command.
  33
  34 See `mount.ceph`_ for details.
  35
  36 .. _mount.ceph: ../../man/8/mount.ceph/
  37 .. _User Management: ../../rados/operations/user-management/