How to: Manage Mounted NFS Shares

NFS allows the ability to mount remote filesystem. This allows the user to have data stored on a remote server, and access that data, locally.

From the Mounts page in NodeWorx, server administrators can add and remove mounted NFS shares.

To Add a Mounted NFS Share

  1. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)

  2. In NodeWorx, navigate to System Services > NFS Server > Mounts

  3. Under Add Mounted Filesystem, update the relevant fields:

    • Host: The IP or hostname of the machine that contains the NFS share that will be mounted

    • Remote Directory: The full path of the remote directory to be mounted

    • Mount Point: The local mount point the remote directory will be available on. This must be an existing directory. When mounting to a directory, any subdirectories or files in that directory become hidden and inaccessible while there is something mounted on that directory. As such, it is recommended to use an empty directory for a mount point

    • Protocol: The mount protocol determines which IP data transmission protocol the NFS server and client will use to communicate. Typically, TCP is recommended because it is able to account for lost packets, as well as packets arriving out of order

    • Mount Type: The mount type determines how the client reacts in the event of a failure:

      • Hard: Forces the program to wait until the server comes back online

      • Soft: Reports an error to the program, and allows it to continue execution

    • Re-Mount Options: Determines the behavior of the system to remount the share when there is an error:

      • Halt: Indicates that the share should be dropped from the mount table

      • Continue: Indicates that the share should remain mounted, as it could just be a temporary failure

    • Interrupt Handling: How interrupts for file operations will be handled. This functions in combination with the hard mount type:

      • Interrupt: If the connection for a hard mount type drops, allowing interrupts gives the ability to interrupt the operation that is waiting on the connection to resume, and allows the program to continue

      • Do Not Interrupt: Processes that are waiting on I/O on the NFS share will be unable to execute until the NFS export comes back online, or the NFS client is restarted

    NFS mount form
  4. Click Add

To Remove a Mounted NFS Share

  1. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)

  2. In NodeWorx, navigate to System Services > NFS Server > Mounts

  3. Under Mounted NFS Shares, select the checkbox next to the mounted share(s) to be removed

    NFS mounted shares
  4. From the With Selected dropdown, select Delete. This opens the Confirm Delete form

    NFS mount delete form
  5. Click Delete