CephFS Shares

We advise against mounting shares as CephFS. If there is no pressing reason to do so, you should use a Usershare and follow the instructions on mounting via NFS+Kerberos under Linux.

To use CephFS, a current version of CentOS/RHEL is required and access may be terminated without prior notice if stability is affected or security is compromised!

To create a CephFS Share navigate to “Project -> Share -> Shares” then click on the button “Create Share”. The parameters when creating a CephFS share are as follows:

• Share Protocol: CephFS
• Type: cephfs.erasurecoding.bronze or usershare.erasurecoding.bronze depending on your use-case
• Availability Zone: AvailabilityZone1 (the only one available)

To access a CephFS share using the CephFS protocol, an access key must be generated. To do this, navigate to the “Shares” menu in the Openstack GUI. Then choose “Manage Rules” in the “Actions” drop-down menu, followed by “Add rule” in the top right drop-down menu. Select “cephx” as the access type and enter a custom username at “Access To”. The username must be written lowercase, with no special characters or spaces. An informative name should be chosen, as the username is globally unique and will be entered in the Ceph authorization list as “client.”.

You will receive an access key, which can be used to mount the filesystem in combination with the chosen username. Usage of CephFS-Kernel mounts is well explained in the Ceph Documentation. Use the path of the share, which is displayed on the detail page, instead of the “/” in the examples. It will either begin with /manila or /usershare, depending on wether you are mounting a regular share or a user share.

Direct access via CephFS is controlled via firewall. To gain access, please write a short mail at cloud@uni-muenster.de including your use-case for directly mounting the share via CephFS.