Configuring Alluxio with Azure Blob Store
This guide describes how to configure Alluxio with Azure Blob Store as the under storage system.
To run an Alluxio cluster on a set of machines, you must deploy Alluxio binaries to each of these machines. You can either compile the binaries from Alluxio source code, or download the precompiled binaries directly.
Also, in preparation for using Azure Blob Store with Alluxio, create a new container in your Azure
storage account or use an existing container. You should also note that the directory you want to
use in that container, either by creating a new directory in the container, or using an existing
one. For the purposes of this guide, the Azure storage account name is called
container in that storage account is called
AZURE_CONTAINER and the directory in that bucket is
AZURE_DIRECTORY. For more information about Azure storage account, Please see
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
$ cp conf/alluxio-site.properties.template conf/alluxio-site.properties
Alluxio can support the Azure Blob Store via the HDFS interface. You can find more about running Hadoop on Azure Blob Store here.
Download azure storage java library(version 2.2.0) from here and hadoop azure libraries corresponding to your Hadoop version from here. Please make sure to use
azure-storage-2.2.0.jar and not any other higher version due to version conflicts with hadoop-azure libraries.
You need to add the above mentioned libraries in the
ALLUXIO_CLASSPATH. You can do this by adding following line in the
You need to configure Alluxio to use Azure Blob Store as its under storage system. The first modification is to specify the underfs address and setting hdfs prefixes so that Alluxio can recognize
wasb:// scheme by modifying
conf/alluxio-site.properties to include:
Next you need to specify credentials and the implementation class for the
wasb:// scheme by adding the following properties in
<configuration> <property> <name>fs.AbstractFileSystem.wasb.impl</name> <value>org.apache.hadoop.fs.azure.Wasb</value> </property> <property> <name>fs.azure.account.key.AZURE_ACCOUNT.blob.core.windows.net</name> <value>YOUR ACCESS KEY</value> </property> </configuration>
After these changes, Alluxio should be configured to work with Azure Blob Store as its under storage system, and you can try to run Alluxio locally with it.
Running Alluxio Locally with Azure Blob Store
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 container
AZURE_CONTAINER to verify the files and directories created by Alluxio exist. For this test, you should see files named like:
To stop Alluxio, you can run:
$ ./bin/alluxio-stop.sh local