Cloud Storage Gateway:Access an NFS share

Install an NFS client

Before you mount an NFS share, you must install an NFS client on the machine.

1. Log on to the machine.

2. Run the following command to install the NFS client:

   The following commands install an NFS client on Ubuntu and CentOS. For more information about how to install an NFS client on other distributions, see the official NFS documentation.

   • If you use Ubuntu operating system, run the following command.

     apt-get install nfs-common

   • On the CentOS operating system, execute the following command.

     yum install -y nfs-utils

Manually mount an NFS share

1. Connect to an ECS instance.

2. On the ECS instance, run the following command to mount an NFS share to a local directory of the client:

   IPv4

   NFSv4 protocol mount

   To mount a share using an IPv4 address and the NFS v4 protocol, run the following command:

   sudo mount -t nfs -o nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport <ipv4_address:/share_name> <local-directory>

   Mounting with the NFSv3 protocol

   To mount a share using an IPv4 address and the NFS v3 protocol, run the following command:

   sudo mount -t nfs -o vers=3,nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport <ipv4_address:/share_name> <local-directory>

   The parameters are described as follows:

   • ipv4_address:/share_name: The mount target of the gateway, which consists of the gateway's IPv4 address and the share name. Replace these placeholders with their actual values. You can find the mount target on the Shares page for your gateway in the Cloud Storage Gateway console.

   • local-directory: The local directory on the client. This can be any existing directory to which you have read and write permissions.

   • noac: Add this parameter to the mount command if you enable the express synchronization feature and the share is part of an express synchronization group. This parameter allows the client to obtain file system metadata from the gateway in real time. You can view synchronization results on the client faster. However, this parameter affects the read and write performance of the client. Add this parameter if the client is sensitive to file changes. Do not add this parameter if the client is sensitive to read and write performance. The following is an example command:

     sudo mount -t nfs -o noac,lookupcache=none,nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport <ipv4_address:/share_name> <local-directory>

   IPv6 method

   Note

   • Only the China (Hohhot) region supports mounting using an IPv6 address. Make sure that the VPC and vSwitch used by the gateway support IPv6.

   • Before you mount a share using an IPv6 address, make sure that an IPv6 address is configured for the ECS client.

   • If the VPC and vSwitch of an existing gateway support IPv6, enable IPv6 in the gateway operations list to obtain the IPv6 mount target. New gateways that are created in this VPC support IPv6 by default and do not require you to explicitly enable IPv6.

   NFS v4 Protocol Mounting

   To mount a share using an IPv6 address and the NFS v4 protocol, run the following command:

   sudo mount -t nfs -o nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport <ipv6_address:/share_name> <local-directory>

   Mounting with the NFS v3 Protocol

   To mount a share using an IPv6 address and the NFS v3 protocol, run the following command:

   sudo mount -t nfs -o vers=3,nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport <ipv6_address:/share_name> <local-directory>

   The parameters are described as follows:

   • ipv6_address:/share_name: The mount target of the gateway, which consists of the gateway's IPv6 address and the share name. Replace these placeholders with their actual values. You can find the mount target on the Shares page for your gateway in the Cloud Storage Gateway console.

     For example, 2408:4004:ffff:ffff:ffff:ffff:ffff:ffff:/myshare.

   • local-directory: The local directory on the client. This can be any existing directory to which you have read and write permissions.

   • noac: Add this parameter to the mount command if you enable the express synchronization feature and the share is part of an express synchronization group. This parameter allows the client to obtain file system metadata from the gateway in real time. You can view synchronization results on the client faster. However, this parameter affects the read and write performance of the client. Add this parameter if the client is sensitive to file changes. Do not add this parameter if the client is sensitive to read and write performance. The following is an example command:

     sudo mount -t nfs -o noac,lookupcache=none,nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport <ipv6_address:/share_name> <local-directory>

3. Run the df -h command to view the mount result.

   If the output is similar to the following information, the NFS share is mounted.

   [root@centos7cb ~]# df -h
   Filesystem      Size  Used Avail Use% Mounted on
   /dev/vda1        99G  1.6G   92G   2% /
   devtmpfs         24G     0   24G   0% /dev
   tmpfs            24G     0   24G   0% /dev/shm
   tmpfs            24G  424K   24G   1% /run
   tmpfs            24G     0   24G   0% /sys/fs/cgroup
   tmpfs           4.8G     0  4.8G   0% /run/user/0
   xxx:/nfs2  256T     0  256T   0% /mnt/nfs172cent7.4
   [root@centos7cb ~]#

   Note

   After the share is successfully mounted, the terminal displays the capacity of each file system that is managed by the share. OSS buckets provide unlimited storage capacity. For information about the file system capacity supported by different gateway specifications, see Specifications.

Access an NFS share

After an NFS share is mounted, access the NFS share in the same way that you access a local directory. If you have write permissions on the share, you can write data to the share. If you have read-only permissions on the share, you can only read data from the share.

Unmount a share

Run the umount <local-directory> command to unmount the share. <local-directory> specifies the local directory on the client where the share is mounted.

Automatically mount an NFS share (optional)

If you manually mount an NFS share to a Linux client, the NFS share mount does not persist after a client restart. Configure the Linux client to automatically mount an NFS share after an ECS instance restart by using the /etc/fstab (recommended) or /etc/rc.local file.