Skip to content
/ julea Public

A Flexible Storage Framework for HPC

License

LGPL-3.0, GPL-3.0 licenses found

Licenses found

LGPL-3.0
COPYING.LESSER
GPL-3.0
COPYING
Notifications You must be signed in to change notification settings

parcio/julea

Repository files navigation

JULEA

CI Dependencies Containers

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.

Quick Start

To use JULEA, first clone the Git repository and enter the directory.

$ git clone https://github.com/parcio/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-path="/tmp/julea-$(id -u)/posix" \
  --kv-backend=lmdb --kv-path="/tmp/julea-$(id -u)/lmdb" \
  --db-backend=sqlite --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.

Citing JULEA

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