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.