This guide describes how to configure Ozone as Alluxio’s under storage system. Ozone is a scalable, redundant, and distributed object store for Hadoop. Apart from scaling to billions of objects of varying sizes, Ozone can function effectively in containerized environments such as Kubernetes and YARN.
To run an Alluxio cluster on a set of machines, you must deploy Alluxio binaries to each of these machines. You can either download the precompiled binaries directly with the correct Hadoop version (recommended), or compile the binaries from Alluxio source code (for advanced users).
To configure Alluxio to use Ozone as under storage, you will need to modify the configuration file
conf/alluxio-site.properties. If the file does not exist, create the configuration file from the template.
$ cp conf/alluxio-site.properties.template conf/alluxio-site.properties
conf/alluxio-site.properties file to set the under storage address to the Ozone bucket and
the Ozone directory you want to mount to Alluxio. For example, the under storage address can be
you want to mount the whole bucket to Alluxio, or
o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/alluxio/data if only the directory
inside the ozone bucket
<OZONE_VOLUME> is mapped to Alluxio.
Example: Running Alluxio Locally with Ozone
Start the Alluxio servers:
$ ./bin/alluxio format $ ./bin/alluxio-start.sh local
This will start an Alluxio master and an Alluxio worker. You can see the master UI at http://localhost:19999.
Run a simple example program:
$ ./bin/alluxio runTests
Use the HDFS shell or Ozone shell to Visit your Ozone directory
to verify the files and directories created by Alluxio exist. For this test, you should see files named like
Stop Alluxio by running:
$ ./bin/alluxio-stop.sh local
An Ozone location can be mounted at a nested directory in the Alluxio namespace to have unified
access to multiple under storage systems. Alluxio’s
Mount Command can be used for this purpose.
For example, the following command mounts a directory inside an Ozone bucket into Alluxio directory
$ ./bin/alluxio fs mount \ --option alluxio.underfs.hdfs.configuration=<DIR>/ozone-site.xml \ /ozone o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/
<configuration> <property> <name>ozone.om.address</name> <value>localhost</value> </property> </configuration>
Make sure the related config file is on all servers nodes running Alluxio.
Supported Ozone Versions
Currently, the only tested Ozone version with Alluxio is
Contributed by the Alluxio Community
Ozone UFS integration is contributed and maintained by the Alluxio community. The source code is located here. Feel free submit pull requests to improve the integration and update the documentation here if any information is missing or out of date.