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 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.
      Attention: The Export field does not accept UTF-8 characters.
    • 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. If you assign the same bucket to file systems from multiple NAS Bridge virtual machines, each subsequent file system is assigned the role of Secondary and becomes read-only. The NAS Bridge assigns these roles to prevent data corruption or loss.

    Typically, the Secondary file system takes time to synchronize with the Primary file system. The amount of time it takes for objects to be persisted to the Secondary file system depends on the intent log size; the larger the size, the more time needed for synchronization.


    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 Procedure .
    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.