CephFS cheatsheet

This page assumes you have a Ceph cluster running, and have created a CephFS there. Now, you want to actually use the CephFS. All of the actions described below take place on the client - i.e., computer where you want to use CephFS.

Mount CephFS using the kernel client

First, install ceph-common (any version) to get the mount.ceph helper binary.

Second, copy over /etc/ceph/ceph.conf and /etc/ceph/ceph.client.admin.keyring from one of the Ceph cluster nodes.

Third, make a mountpoint - for example:

# mkdir -p /mnt/cephfs

Fourth, find out the hostname or IP address of one of the MON nodes of your Ceph cluster.

You can now mount CephFS by doing (replace MON_NODE with the hostname or IP address of the MON node):

# mount -t ceph MON_NODE:/ /mnt/cephfs -o name=admin