Configuring a Ceph FUSE client

While most clients will use the native kernel ceph client, there may be times where you want to use the FUSE client for rate limiting or if requested by the Jetstream2 team.

You will need the ceph-fuse rpm if not already installed. You can install it with:

dnf install ceph-fuse

for Redhat-Based OSes like Rocky and Alma. For Ubuntu, you can install it with:

apt-get install ceph-fuse

To mount the manila share created previously you need to edit the three files listed below :

i. /etc/ceph/ceph.conf

admin socket = /var/run/ceph/$cluster-$name-$pid.asok
client reconnect stale = true
debug client = 0/2
fuse big writes = true
mon host =,,,,149    .165.158.86:6789

where the mon host information is provided to you as part of the manila share.

ii. /etc/fstab

Add the following:

none    /mnt/ceph fuse.ceph$accessTo,ceph.conf=/etc/ceph/ceph.conf,ceph.client_mountpoint=$volumePath,x-systemd.device-timeout=30,x-systemd.mount-timeout=30,noatime,_netdev,rw 0       2

Replace $accessTo with the arbitrary name you chose in step 3 above and $volumePath with ( /volume/_no-group/…) that is also in the share information that you created.

It should look something like this:

none    /mnt/ceph fuse.ceph,ceph.conf=/etc/ceph/ceph.conf,ceph.client_mountpoint=/volumes/_nogroup/fe4f8ad4-2877-4e23-b5d3-46eb8476750b/ab404bac-9584-45f4-8a34-92dfc6    1fbb98,x-systemd.device-timeout=30,x-systemd.mount-timeout=30,noatime,_netdev,rw 0   2

iii. /etc/ceph/ceph.client.$accessTo.keyring

Add the following:

    key = $accessKey

Replace $accessTo with the arbitrary name you chose in step 3 and $accessKey with the Acce ss Key generated in step 4

Your file should look something like this :

    key = AQAHfhZiwTf/NhAAT5ChE4tDXt3Nq1NyiURbMQ==