TWiki> WLCGDatalakes Web>FSTDeployment (revision 1)EditAttachPDF


  • Two or more filesystems with more than 2TB of disk space each (ideally on different nodes or shared volumes/pools/filesystems). They can be: xfs, ext4, cephfs, or mountable volumes/pools (e.g., ceph, dcache)
  • Ability to run xrootd/eos daemons on the nodes holding the filesystems/volumes (see installation instructions below)
  • Preferably 10GE NICs
  • A stable, DNS-registered hostname. Ideally, the DNS hostname should match the Linux hostname and resolve to the IP address set on the machine interface. Network Address Translation is supported as well
  • Open port for xrootd (TCP - 1095) for messaging and real data traffic
  • Possibility to log in to the servers remotely (tuning, debug, etc.)

Installation via Docker container

The installation via Docker container consists of a Docker image where the EOS file server daemon lives.

1. Install Docker and Docker compose

Refer to the official installation instructions for your OS: and

The deployment has been tested and proved working with Docker 17.03 and Docker Compose 1.19.

2. Prepare the filesystem

Assuming to have a block device available at /dev/md1, format it as an xfs filesystem and mount it on the host at /mnt/eosdisk.

mkfs.xfs -L "eos_fst" /dev/md1
mkdir -p /mnt/eosdisk
mount /dev/md1 /mnt/eosdisk

It is recommended to edit /etc/fstab consistently to make the mount persistent in case of host reboot.

3. Create a configuration file for the container

Copy and paste what follows in a plain-text file called eos-fst.yaml

# Docker Compose configuration file for EOS FST container
version: "2"

    container_name: eos-fst
    restart: unless-stopped
      - SYS_PTRACE
      - apparmor=unconfined
    network_mode: "host"
      - %%%storage-path-on-the-host%%%:/mnt/data01
      EOS_INSTANCE_NAME: "eoseulake"
      EOS_GEOTAG: "%%%your-site-name%%%"
      EOS_MGM_MASTER1: ""
      EOS_MGM_MASTER2: ""
      EOS_MGM_ALIAS: ""
      EOS_MQ_ALIAS: ""
      FST_MOUNTPOINT: "/mnt/data01"
      FST_FQDN: "%%%your-machine-hostname%%%"

4. Customize the configuration file eos-fst.yaml with the specificities of your site

Edit eos-fst.yaml and replace

  • %%%storage-path-on-the-host%%% with the path on the host where the filesystem for EOS is mounted (e.g., /mnt/eosdisk)
  • %%%your-site-name%%% with the name of your institution and/or a geographic location (e.g., cern-gva)
  • %%%your-machine-hostname%%% with the Fully Qualified Domain Name of the host where the xrootd/eos daemons run (e.g.,

5. Start the container

Run (with sudo privileges)

docker-compose -f eos-fst.yaml up -d

The Docker daemon will pull the image from the repository and start the container. The EOS file server daemon will automatically connect to the management node and register the file system.

Known Limitations

  • The Docker container supports a single volume where the EOS file storage daemon can read/write (/mnt/eosdisk in the example). This will be extended in future.
  • The EOS logs are not stored persistently. Restarting the container will cause to old logs to be wiped.

Installation with native eos client (rpm-based)


-- EnricoBocchi - 2018-05-23

Edit | Attach | Watch | Print version | History: r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r1 - 2018-05-23 - EnricoBocchi
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    WLCGDatalakes All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback