Deploy Alluxio Locally

    This guide goes over how to run and test Alluxio on your local machine.

    The prerequisite for this part is that you have a version of Java 8 installed.

    the binary distribution of Alluxio.

    To run in standalone mode, do the following:

    • Create conf/alluxio-site.properties by copying conf/alluxio-site.properties.template
    • Set alluxio.master.hostname in conf/alluxio-site.properties to localhost (i.e., alluxio.master.hostname=localhost).
    • Set alluxio.master.mount.table.root.ufs in conf/alluxio-site.properties to a tmp directory in the local filesystem (e.g., alluxio.master.mount.table.root.ufs=/tmp).
    • Turn on remote login service so that ssh localhost can succeed. To avoid the need to repeatedly input the password, you can add the public SSH key for the host into ~/.ssh/authorized_keys. See this tutorial for more details.

    Mount RAMFS file system

    Start Alluxio Filesystem Locally

    Simply run the following command to start Alluxio filesystem.

    1. # If you have not mounted the ramdisk or want to remount it (ie. to change the size)
    2. $ ./bin/alluxio-start.sh local SudoMount
    3. # OR if you have already mounted the ramdisk

    To verify that Alluxio is running, visit , or see the log in the logs folder.

    To run a more comprehensive sanity check:

    You can stop Alluxio any time by running:

    1. $ ./bin/alluxio-stop.sh local

    FAQ

    If you have no sudo privileges on Linux, for Alluxio Filesystem to work, it requires a RAMFS (e.g., /path/to/ramdisk) already mounted by the system admin and accessible for read/write-operations by the user. In this case you have can specify the path in :

    1. alluxio.worker.tieredstore.level0.alias=MEM
    2. alluxio.worker.tieredstore.level0.dirs.path=/path/to/ramdisk

    and then start Alluxio with NoMount option to use the above directory as its data storage:

    Alternatively, you can also specify Linux as the data storage. Tmpfs is a temporary file storage backed by memory (e.g., typically /dev/shm on Linux), but may use SWAP space and therefore provides less performance guarantees compared to ramfs. Similar to using a pre-mounted RAMFS, you can specify the tempfs path in conf/alluxio-site.properties:

    1. alluxio.worker.tieredstore.level0.alias=MEM
    2. alluxio.worker.tieredstore.level0.dirs.path=/dev/shm

    followed by:

    1. $ ./bin/alluxio-start.sh local NoMount

    Options:

    • Start Alluxio as a super user.
    • Add the user who starts Alluxio to the sudoers file.