Adding an NFS file system

Before mounting NFS clients to the exports exposed by NAS Bridge, you must add one or more NFS file systems.

Before you begin

You should be familiar with the prerequisites and limitations when adding file systems.

In addition, the following administrative entities must be defined to the NAS Bridge:

About this task

When adding an NFS file system, you must type or select all of the parameter values displayed on the page. You can also include a permission for the file system. Regarding permissions, you should be aware of the following:

Steps

  1. Click Configuration at the top of the web page.
  2. Click NFS Filesystems.
  3. Click Add.
  4. Type or select all of the configuration values as appropriate for your deployment plan and storage environment:
    • Storage Grid – Select the IP address of the StorageGRID API Gateway Node.
    • Bucket – If the named bucket does not exist in your StorageGRID system, NAS Bridge creates it.
    • Cache device – Select the cache device you want to use for this file system.
    • Export – The export name must begin with a slash. The export is exposed under the /mnt directory.
    • Click Add Permission.
  5. Type or select the permission values to allow write access to the NFS export:
    1. Type the IP address or domain name of the clients.
      A wild card name is supported.
    2. Click Readwrite.
    3. Select the Squash value and anonymous IDs as needed.
  6. Click Save to create the file system.
    When the operation completes, the new file system is displayed with a unique ID and a status of READY.

    The Role of "Primary" indicates that this is the first file system to which the bucket has been assigned. Later, if the same bucket is assigned to any other file system on another NAS Bridge virtual machine, the Role of "Secondary" is assigned to the file system. The NAS Bridge automatically assigns file system roles, and they cannot be changed manually. A file system with a Role of "Secondary" cannot be mounted by a client.


    This image is described by the surrounding text.

  7. When you are finished, download a NAS Bridge recovery package.
    Attention: You should download a NAS Bridge recovery package whenever you make configuration changes or upgrade to a new version of NAS Bridge. Recovery packages from previous versions will not be valid.
    1. Go to Maintenance > Recovery Package .
    2. Click Generate Package.
    3. Select the package from the table, and click Download to download the package to your local workstation.
    4. Save the package to a safe location.
  8. After adding an NFS file system in NAS Bridge, you can use a client computer to mount that file system to the export exposed by the NAS Bridge.
    When mounting an NFS client, NetApp recommends that you use the rsize and wsize parameters to specify the block sizes for read and write operations. Otherwise, these operations might be slow. You should also specify the version. For example:
    sudo mount {IP or Hostname}:/mnt/{export} {local folder} -o rsize=1048576,wsize=1048576,vers=3

    Enter the mount command from a client computer.