The creation of Shared File Systems (SFS) can be done directly using the OpenStack Horizon User Interface (UI). Instructions of how to access the UI can be found in EWC Cloud Management UI - Accessing the Horizon portal. In order to manage SFSs via the CLI follow the instructions in EWC OpenStack API access - EUMETSAT - How to manage Shared File Systems (SFS) with the OpenStack CLI.
| This is only available on EUMETSAT side of the EWC |
| Pre-requisite: setting up SFS in a tenancy can be done only by users with ewc-app-admin. Check EUMETSAT - Shared File Systems (SFS) - User Roles and Permissions for for info on roles for SFS. |
SFS are shared among different users and machines by using a share network. EUMETSAT clouds should already contain a pre-configured share network to use for your file shares. Verify the existence of this share network by selecting the Share option on the left-hand side menu and click on the Share Networks option from the drop-down menu. You should see an entry like this
If no share network is available in your cloud, please open a ticket with the support team to resolve the issue.
File shares can also be created in the OS Horizon UI by following these steps:
1. Select Share from the left-hand side menu, and from the drop-down menu, click on Shares.
2. Click on Create Share on the right-hand side.
3. In the prompt window fill the following fields:
general_performance or high_performance key=value .
In order for a VM to have access to a SFS it needs to be in the same network. When provisioning an instance, add the shared network, as displayed above, to the list of networks for the VM (usually in addition to private)
If the instance has already provisioned, one can add an interface to the share network by selecting the Attach Interface option in the drop-down menu from the right-hand side options for the selected VM.
and then in the prompt window, select the shared network.
You can select a fixed IP address for the VM in the private network, or if not, you will get one automatically assigned. Make note of that IP as it will be needed later.
TODO: SECURITY GROUPS
TODO: ROUTING
Now that the file share is created, we need grant access to it to any VM we want. In order to do this, grab the IP of the VM to which you wish to give access, e.g 10.0.0.116. Then follow these steps
1. In the list of file shares, select Manage Rules from the dropdown menu on the right-hand side of the selected file share.
2. Click on the button Add Rule
3. Fill the fields for the access rule, specifically the Access Type, which for VMs will be ip, the Access Level, which could be read-write or read-only, and the Access To, which for VMs is the IP in the shared netword you grabbed earlier from the instance.
Even if the file share is accessible to the VM, one cannot read or write on it until it is mounted onto a directory in the VM. In order to do so, log in to your VM as usual and create an appropriate directory in the VM
mkdir <path>/<to>/<local>/<share> |
then grab the export path for the file share. This can be found in the UI by clicking on the file share name to see its details. It is recommended to use the path with the Preferred: True keyword.
Then mount the selected export path into the created directory
sudo mount <share_export_path> <path>/<to>/<local>/<share> |