Configuring a VM to use Manila Shares

Please note that any items with ${something} are placeholders for your names that you used when you created the manila shares in Horizon or via the CLI.


All JS2 featured images will have the necessary Ceph repository and packages installed. You will need to make sure you have ceph-common from the Ceph repository. Instructions may be found here:

If you aren’t comfortable with adding repositories and installing packages, we highly recommend that you use a featured image.

1. Create a mount point on your instance

mkdir /mnt/ceph

2.Configuring your instance

i. Create the file /etc/ceph.${accessTo}.secret and add the accessKey


vi /etc/ceph.manilashare.secret

and add


Substitute the key value from the share creation above.

Also, make sure the permissions on the file are rw to the owner only. You can do that with

sudo chmod 600 /etc/ceph.manilashare.secret

ii. Edit /etc/fstab to include the following line:

$path /mnt/ceph ceph name=${accessTo},secretfile=/etc/ceph.${accessTo}.secret,x-systemd.device-timeout=30,x-systemd.mount-timeout=30,noatime,_netdev,rw 0   2

$path = IP#:ports followed by volume path (/volume/_no-group/uuid/uuid)

Please make sure to change the $variables to whatever you set these values to in Manila or the CLI when you created the share

Example:,,,, /mnt/ceph ceph name=manilashare,secretfile=/etc/ceph/ceph.manilashare.secret,x-systemd.device-timeout=30,x-systemd.mount-timeout=30,noatime,_netdev,rw 0   2

3. Mount the share

Mount the manila share created with the following command mount -a

If you then run a df -h|grep vol you should see something like this:,,,, 1.8T 134G 1.7T 2% /mnt/ceph