CernVM-FS installation

CernVM-FS was successfully installed on your Mac.cvmfs-config.cern.ch There are only two steps necessary to access any repository:

  1. Mount the CernVM-FS config repository: • sudo mkdir -p /cvmfs/cvmfs-config.cern.ch • sudo mount -t cvmfs /cvmfs/cvmfs-config.cern.ch

  2. Mount a CernVM-FS repository using the following steps: • sudo mkdir /cvmfs/sft.cern.ch • sudo mount -t cvmfs sft.cern.ch /cvmfs/sft.cern.ch Please note that from MacOS 10.15 Catalina is necessary to reboot your system after the installation in order to create the /cvmfs directory. Enjoy!

Client configuration

client:

  • Install cvmfs using your distribution’s package manager.

  • Copy the master public key to /etc/cvmfs/keys/masterkey.gsi.de.pub.

  • Place the repository-specific config file to /etc/cvmfs/config.d/. For GSI-internal repositories, use Stratum 0 (an HTTP proxy is usually used automatically on centrally managed GSI machines). For publicly reachable repositories, use Stratum 1.

Example for public repositories: fairsoft.gsi.de.conf:

CVMFS_SERVER_URL="http://cvmfs-s1.gsi.de/cvmfs/fairsoft.gsi.de"
CVMFS_HTTP_PROXY="DIRECT"
CVMFS_PUBLIC_KEY="/etc/cvmfs/keys/masterkey.gsi.de.pub"

Example for GSI-internal repositories: fairsoft.gsi.de.conf:

CVMFS_SERVER_URL="http://cvmfs-s0.gsi.de/cvmfs/fairsoft.gsi.de"
CVMFS_HTTP_PROXY="DIRECT"
CVMFS_PUBLIC_KEY="/etc/cvmfs/keys/masterkey.gsi.de.pub"

Instead of duplicating the repo name in the CVMFS_SERVER_URL, you can also use @fqrn@ there like this: CVMFS_SERVER_URL="http://cvmfs-s0.gsi.de/cvmfs/@fqrn@".

  • Mount the desired repository through any of the available mechanisms. Example for a systemd unit file cvmfs-cvmfstest.gsi.de.mount:

[Unit]
Description=Mount /cvmfs/fairsoft.gsi.de
After=network.target

[Mount]
What=fairsoft.gsi.de
Where=/cvmfs/fairsoft.gsi.de
Type=cvmfs

[Install]
WantedBy=multi-user.target

On OSX

On Mac OS X, CernVM-FS is based on macFUSE. Note that as of macOS 11 Big Sur, kernel extensions need to be enabled to install macFUSE. Verify that fuse is available with

kextstat | grep -i fuse
Download the CernVM-FS client package in the terminal in order to avoid signature warnings

curl -o ~/Downloads/cvmfs-2.8.0.pkg https://ecsft.cern.ch/dist/cvmfs/cvmfs-2.8.0/cvmfs-2.8.0.pkg
Install the CernVM-FS package by opening the .pkg file and reboot. Future releases will provide a signed and notarized package.

Mount each time with

sudo mount -t cvmfs fairsoft.gsi.de /cvmfs/fairsoft.gsi.de/

Mount via Docker Container

The steps explained in the [previous section](#client-configuration) have been packaged into a docker image rklasen/cvmfs. Running a container from this image provides FairSoft/FairRoot via CVMFS on the host at /cvmfs:

docker run -d --name cvmfs --privileged --cap-add SYS_ADMIN --device /dev/fuse --volume /cvmfs:/cvmfs:shared rklasen/cvmfs

The container continues to run in background. Check after about a minute whether it works

ls /cvmfs/fairsoft.gsi.de
centos7  centos8  debian10  debian8  macos-10.15  ubuntu1804