Configuring Alluxio with NFS

This guide describes the instructions to configure NFS as Alluxio’s under storage system.

Initial Setup

First, the Alluxio binaries must be on your machine. You can either compile Alluxio, or download the binaries locally.

Configuring Alluxio

You need to configure Alluxio to use under storage systems by modifying conf/alluxio-site.properties. If it does not exist, create the configuration file from the template.

$ cp conf/alluxio-site.properties.template conf/alluxio-site.properties

Assuming the NFS clients are co-located with Alluxio nodes, all the NFS shares are mounted at directory /mnt/nfs, the following environment variable assignment needs to be added to conf/alluxio-site.properties:

alluxio.underfs.address=/mnt/nfs

Running Alluxio with NFS

After everything is configured, you can start up Alluxio locally to see that everything works.

$ ./bin/alluxio format
$ ./bin/alluxio-start.sh local

This should start an Alluxio master and an Alluxio worker. You can see the master UI at http://localhost:19999.

Next, you can run a simple example program:

$ ./bin/alluxio runTests

After this succeeds, you can visit your NFS volume to verify the files and directories created by Alluxio exist. For this test, you should see files named like:

/mnt/nfs/default_tests_files/Basic_CACHE_THROUGH

To stop Alluxio, you can run:

$ ./bin/alluxio-stop.sh local
Need help? Ask a Question