EOS Storage
Switch branches/tags
Clone or download
Latest commit 1da6d7b Oct 18, 2018
Failed to load latest commit information.
ApMon SPEC: bump versiont to 1.1.8 Jul 4, 2018
archive ARCHIVE: Add systemd configuration files for eosarchived daemon. Fixe… Oct 2, 2018
auth_plugin HTTP,AUTH: Correct HmacSha1 size passed to encoding May 23, 2018
authz CONSOLE: Remove dependency on XrdOucEnv to parse the server response … Jan 28, 2018
cmake CMAKE: Generate man pages at build time Aug 27, 2018
common COMMON: Use correct logging function in PluginManager Oct 12, 2018
console MGM/CONSOLE: add 'fs mv --force' to disable empty, node and group mod… Oct 16, 2018
debian DEB: Remove eosdropboxd also for the debian builds Sep 28, 2018
doc DOC: update for 4.4.8 Oct 18, 2018
etc/logrotate.d Merge remote-tracking branch 'origin/beryl_aquamarine' Sep 29, 2017
fst Update FmdDbMap.cc: log fid= for frequent errors Oct 16, 2018
fuse FUSE: Add proper locking to avoid race condition when underlying file… Oct 1, 2018
fusex FUSEX: remove forget_all functionality screwing CWDs. We don't forget… Oct 18, 2018
git UTILS: Disable any astylerc file that might exist on the host machine Aug 18, 2016
gitlab-ci CI: Make script executable Sep 5, 2018
httpd-mini BUILD: clean-up cmake structure and improve (-DPREFIX+... support for… Jan 18, 2013
icons OSX: new icon for dmg package Sep 22, 2017
man MAN: Workaround for missing man pages on SLC6 Oct 16, 2018
mgm Added an in-memory (no persistency) tape aware LRU-based garabge coll… Oct 18, 2018
microhttpd MICROHTTPD: Do not return wrong socket when DUPFD fails Sep 28, 2017
misc Added an in-memory (no persistency) tape aware LRU-based garabge coll… Oct 18, 2018
mq MQ: Fix log message and possible improvement Oct 12, 2018
namespace NS: Add defensive checks to prevent addContainer overwriting conflict… Oct 12, 2018
nginx NGINX: releasing newest version for testing Dec 12, 2017
proto MGM/CONSOLE: add 'fs mv --force' to disable empty, node and group mod… Oct 16, 2018
srm CMAKE: Add a bit of consistency to the CMake files and make them more… Dec 10, 2014
sync ALL: removing old 'eosha' daemon May 7, 2018
test TEST: clean-up commands for eos copy tests Oct 15, 2018
unit_tests Added an in-memory (no persistency) tape aware LRU-based garabge coll… Oct 18, 2018
utils ALL: Follow latest Fedora conventions regarding shebang notations Sep 24, 2018
.clang-format MISC: Add .clang-format and .clang-tidy configuration files that can … Jun 9, 2016
.clang-tidy MISC: Add .clang-format and .clang-tidy configuration files that can … Jun 9, 2016
.gitignore MGM: Make "move directory into subdirectory of itself" protection robust Sep 10, 2018
.gitlab-ci.yml TEST: Fix permissions on the directory used for fusex-benchmark tests Sep 28, 2018
.gitmodules TEST: Include gtest as submodule, make available from top-level CMake… Jul 26, 2018
.ignore MGM: Make "move directory into subdirectory of itself" protection robust Sep 10, 2018
CMakeLists.txt CMAKE: Fix build error seen on my F28 dev instance Oct 8, 2018
License Truncating part of the license explaining how to apply a GPL license. Dec 6, 2011
README.md CMAKE,README: Update build dependencies Aug 8, 2018
elrepopackage.spec SPEC/CI: new el repo meta package Dec 7, 2017
eos.spec.in SPEC: Add eos-fusex-core zeromq package dependency Oct 9, 2018
genversion.sh BUILD: replacing release with loginfo for commits. Fixes EOS-2205 Jan 6, 2018


build status



EOS is a software solution that aims to provide fast and reliable multi-PB disk-only storage technology for both LHC and non-LHC use-cases at CERN. The core of the implementation is the XRootD framework which provides feature-rich remote access protocol. The storage system is running on commodity hardware with disks in JBOD configuration. It is written mostly in C/C++, with some of the extra modules in Python. Files can be accessed via native XRootD protocol, a POSIX-like FUSE client or HTTP(S) & WebDav protocol.


The most up to date documentation can be found at: http://eos-docs.web.cern.ch/eos-docs/

Doxygent documentation of the API is available in the ./doc directory and can be generated using the following command:

# Inside the EOS git clone directory
cd doc
# Documentation generated in the ./html directory which can be accessed using any browser
# file:///eos_git_clone_dir/doc/html/index.html

Project Directory Structure

  • archive - Archive tool implementation in Python
  • auth_plugin - Authorization delegation plugin
  • authz - Authorization capability functionality
  • cmake - CMake related scripts and functions
  • common - Common helper files and classes
  • console - Command line client implementation
  • doc - Doxygen documentation
  • etc - Service scripts, log rotation and sysconfig Files
  • fst - The Storage Server Plugin (FST)
  • fuse - The FUSE mount Client (eosd low level API)
  • man - Manual pages
  • mgm - Meta Data Namespace and Scheduling Redirector Plugin (MGM)
  • mq - Message Queue Server Plugin
  • namespace - Namespace Implementation
  • nginx - Nginx related patches for EOS integration
  • srm - SRM BestMan utility scripts
  • sync - file/directory synchronization programs
  • test - Instance test script with some dedicated test executables
  • utils - Useful utilities and the uninstall scripts
  • var - Placeholder directory to create log, http and namespace directories


It is recommended to set up xrootd and eos-citrine-dependency repositories, as seen in the documentation.

yum install -y git gcc cmake cmake3 readline readline-devel fuse fuse-devel \
leveldb leveldb-devel binutils-devel zlib zlib-devel zlib-static \
bzip2 bzip2-devel libattr libattr-devel libuuid libuuid-devel \
xfsprogs xfsprogs-devel sparsehash sparsehash-devel e2fsprogs e2fsprogs-devel \
libmicrohttpd libmicrohttpd-devel openssl openssl-devel openssl-static \
eos-folly eos-rocksdb ncurses ncurses-devel ncurses-static protobuf3-devel \
cppunit-devel openldap-devel hiredis-devel zeromq-devel jsoncpp-devel \
xrootd xrootd-server-devel xrootd-client-devel xrootd-private-devel \
cppzmq-devel libcurl-devel libevent-devel jemalloc jemalloc-devel


To build EOS, you need gcc (>=4.9) with C++14 features and CMake installed on your system:

# Note that you will also need to check out the fmd and qclient git submodules
git submodule update --init --recursive
# Create build workdir
mkdir build
cd build
# Run CMake
cmake3 ..
# Build
make -j 4


The default behaviour is to install EOS at system level using CMAKE_INSTALL_PREFIX=/usr. To change the default install prefix path, do the following:

# Modify the default install path
cmake ../ -DCMAKE_INSTALL_PREFIX=/other_path
# Install - might require sudo privileges
make install
# Uninstall
make uninstall

Source/Binary RPM Generation

To build the source/binary RPMs run:

# Create source tarball
make dist
# Create Source RPM
make srpm
# Create RPM
make rpm

System specific notes

  • The current production version of EOS in the beryl_aquamarine branch which has a hard requirement on XRootD 3.3.6.
  • The the future production version of EOS is the citrine branch and requires XRootD >= 4.2.0.

Bug Reporting

You can send EOS bug reports to project-eos@cern.ch. The preferable way, if you have access, is use the online bug tracking system Jira to submit new problem reports or search for existing ones: https://its.cern.ch/jira/browse/EOS


EOS - The CERN Disk Storage System
Copyright (C) 2015 CERN/Switzerland
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY, without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.