JULEA is a flexible storage framework that allows offering arbitrary I/O interfaces to applications. To be able to rapidly prototype new approaches, it offers object, key-value and database backends. Support for popular storage technologies such as POSIX, LevelDB and MongoDB is already included.
Additionally, JULEA allows dynamically adapting the I/O operations' semantics and can thus be adjusted to different use-cases. It runs completely in user space, which eases development and debugging. Its goal is to provide a solid foundation for storage research and teaching.
For more information, please refer to the documentation. There is also a separate API documentation available.
To use JULEA, first clone the Git repository and enter the directory.
$ git clone https://github.com/julea-io/julea.git
$ cd julea
JULEA has three mandatory dependencies (GLib, libbson and libfabric) and several optional ones that enable additional functionality.
The dependencies can either be installed using your operating system's package manager or with JULEA's install-dependencies
script that installs them into the dependencies
subdirectory using Spack.
$ ./scripts/install-dependencies.sh
To allow the dependencies to be found, the JULEA environment has to be loaded.
This also ensures that JULEA's binaries and libraries are found later.
Make sure to load the script using .
instead of executing it with ./
because the environment changes will not persist otherwise.
$ . scripts/environment.sh
JULEA now has to be configured using Meson and compiled using Ninja;
the different configuration and build options can be shown with meson setup --help
.
$ meson setup --prefix="${HOME}/julea-install" -Db_sanitize=address,undefined bld
$ ninja -C bld
Finally, a JULEA configuration has to be created.
$ julea-config --user \
--object-servers="$(hostname)" --kv-servers="$(hostname)" --db-servers="$(hostname)" \
--object-backend=posix --object-component=server --object-path="/tmp/julea-$(id -u)/posix" \
--kv-backend=lmdb --kv-component=server --kv-path="/tmp/julea-$(id -u)/lmdb" \
--db-backend=sqlite --db-component=server --db-path="/tmp/julea-$(id -u)/sqlite"
You can check whether JULEA works by executing the integrated test suite.
$ ./scripts/setup.sh start
$ ./scripts/test.sh
$ ./scripts/setup.sh stop
To get an idea about how to use JULEA from your own application, check out the example
directory.
$ cd example
$ make run
The version is JULEA built using this guide is mainly meant for development and debugging. If you want to deploy a release version of JULEA, please refer to the documentation about installation and usage.
If you want to cite JULEA, please use the following paper:
- JULEA: A Flexible Storage Framework for HPC (Michael Kuhn), In High Performance Computing, Lecture Notes in Computer Science (10524), (Editors: Julian Kunkel, Rio Yokota, Michela Taufer, John Shalf), Springer International Publishing, ISC High Performance 2017, Frankfurt, Germany, ISBN: 978-3-319-67629-6, 2017-11