Create and use a Generic Type share

Warning

Generic type shares are available only on the ADA cloud.

Note

To create shares, the project must be allowed to use Manila Service. If you don’t have access yet, please request it following instructions at this page.

Create share network

As a first step you need to create the share network. Using the Horizon Dashboard, click Create Share Network in Share → Share Networks tab and set the value for the following attributes:

  • name: your share network name.

  • network: choose the desired network that will be linked to the share network, in our example example_share_guide_net.

  • subnet: choose the desired subnet, in our example example_share_guide_subnet.

  • Click on the “save” button.

../../../_images/op_share_generic_img1.png

Create the share

On the Share > Shares tab, create the share clicking on the button Create share. In the popup menu set:

  • share name: the name you want to give to the share

  • share protocol: select “NFS”

  • size: the size of your shared filesystem

  • type: select “generic_type”

  • Availability Zone, Share Group and Make visible for all projects: leave blank

../../../_images/op_share_generic_img2.png

Set access rule

On the tab Share > Shares select the share just created and in the dropdown menu select Manage Rules.

../../../_images/op_share_generic_img3.png

Click on Add rule and set:

  • access type: ip

  • access level: read-write or read-only (depending on your needs)

  • access to: set to the fixed IP of the VM (one rule per VM)

../../../_images/op_share_generic_img4.png

After clicking on the “add” button, go back to the Share > Shares. Click on the brand new share to display the Share Overview. The “Export locations: Path” and “access key” and “access to” keys are displayed. This information will be used to mount the share on the virtual machines.

Mount the share on the VMs

Warning

In the following example, we will consider VMs using Ubuntu 22.04 LTS. Please refer to the network guide of the operating system of your VM to be sure about the operations to be done.

  • Login into the first VM.

  • Upgrade the packages installed in the VM

sudo apt update
sudo apt upgrade

  • Install the nfs client. On ubuntu repositories, the package name is “nfs-common”.

sudo apt install nfs-common

  • Identify or create the directory in which the share will be mounted (e.g., “/mnt/share_manila”)

sudo mkdir <MOUNT_PATH>

  • To mount the share you will need the share <ACCESS_PATH> displayed on the “Share Overview” page on OpenStack dashboard under the keyword “Export Location/Path”. Gather this information and proceed.

../../../_images/op_share_generic_img5.png

  • Mount the share with the following command. Beware that different versions of nfs-common are available for different versions of Ubuntu and the syntax of the mount command could change.

sudo mount -t nfs -v <ACCESS_PATH> <MOUNT_PATH>

  • Then, repeat the same steps for the second VM.