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.