You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

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.


Verify Share Network

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.

Create a File Share

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:

  • Share Name: select a name for the file share, the recommendation is to use <tenancy_name>-sfs.
  • (Optional) Description: add a description of the file share.
  • Share Protocol: select NFS.
  • Size: select the required size for the SFS, e.g. 1 GB.
  • Share Type:  choose a type from those available in the drop-down menu, either general_performance or high_performance 
  • Share Network: select the share network that you verfied in the previous step.
  • (Optional) Metadata: Add any metadata that the file share needs in the format key=value .

Add the VM to the Share Network

In order for a VM to have access to a SFS it needs to be able to trace a route to the SFS via a share network. At EWC this is achieved via a specific private network, typically aclled sfs_network_<project_id>, and a router that provides a static route to the share network. When provisioning an instance, add the sfs network 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 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 network, or if not, you will get one automatically assigned. Make note of that IP as it will be needed later.

In order to ensure that the VM has access to the share network through the router, the security groups for the VM's port in the SFS network must allow egress to the required IPs. The pre-configured security groups default, ssh and ssh-http-https, among others, have the right permissions to access the SFS, so make sure that these are added to the VM when provisioning it or at any time afterwards.

Grant access to the SFS to a VM

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 VM's IP in the sfs network. 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.

Mount file share to a VM

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>


  • No labels