Mounting File Storage for Classic on Ubuntu

Use these instructions to connect an Ubuntu Linux®-based IBM Cloud® Compute instance to a Network File System (NFS) share. For more information about how to order IBM Cloud® File Storage for Classic, see the Getting started tutorial.

Before you begin, make sure that the host that is to access the File Storage for Classic volume is authorized. For more information, see Authorizing the host in the console Authorizing the host from the CLI Authorizing the host with Terraform.

Mounting the File Storage for Classic share

Update and upgrade the distribution:
```
apt update && apt upgrade
```
Install the required tools.
```
apt-get install nfs-common
```
Create a /mnt/nfs directory.
```
mkdir -p /mnt/nfs
```
Restart your instance:
```
reboot
```
Mount the remote share.
```
mount -t nfs -o <options> <host:/mount_point> /mnt
```
Example for storage_as_a_service volumes.
```
#mount -t nfs -o nfsvers=3 fsf-wdc0403a-fz.service.softlayer.com:/IBM02SEV1414935_66/data01 /mnt
```
Example for enterprise volumes.
```
# mount -t nfs -o nfsvers=3 nfshou0201d-fz.service.softlayer.com:/IBM01SEV1414935_2 /mnt
```
The mount point information can be obtained from the File Storage for Classic Details page in the console, with an API call - SoftLayer_Network_Storage::getNetworkMountAddress(), or by looking at the ibm_storage_file resource in Terraform.

Verify that the mount was successful by using the disk file system command.

# df -h
Filesystem Size Used Avail Use% Mounted on
/dev/xvda2  25G  1.4G  22G    6%   /
/tmpfs     1.9G     0 1.9G    0%   /dev/shm
/dev/xvda1 97M    51M  42M   55%

Go to the mount point, and read/write files.

# touch /mnt/test
# ls -la /mnt
total 12
drwxr-xr-x   2 nobody nobody 4096 Sep 8 15:52 .
dr-xr-xr-x. 22 root   root   4096 Sep 8 14:30 ..
-rw-r--r--   1 nobody nobody    0 Sep 8 15:52 test

Make the configuration persistent by editing the file systems table (/etc/fstab). Add the remote share to the list of entries that are automatically mounted on startup:
```
sudo nano /etc/fstab
```
Add a line with the following syntax to the end of the file.
```
(hostname):/(mount_point) /mnt nfs_version defaults 0 0
```
Example
```
nfsdal1301a.service.softlayer.com:/IBM01SV278685_7 /mnt nfsvers=3 defaults 0 0
```
Verify that the configuration file has no errors.
```
# mount -fav
```
If the command completes with no errors, your setup is complete.

If you're using NFS 4.1, add sec=sys to the mount command to prevent file ownership issues.

Unmounting the file system

To unmount any currently mounted file system on your host, run the umount command with disk name or mount point name.

umount /dev/sdb

umount /mnt