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 <https://git.gsi.de/dc/cvmfs-server/-/blob/16e98ee7bc5a7f70d395d8c8d4e3cdf1f83ef930/near-production/shared/masterkey.gsi.de.pub>`_ 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``:

.. code-block:: bash
  
  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``:

.. code-block:: bash
  
  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``:

.. code-block::
  
  [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 <http://osxfuse.github.io/>`_. Note that as of macOS 11 Big Sur, kernel extensions need to be `enabled <https://support.apple.com/guide/mac-help/change-startup-disk-security-settings-a-mac-mchl768f7291/mac>`_ to install macFUSE. Verify that fuse is available with

.. code-block:: bash
  
  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

.. code-block:: bash
  
  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``:

.. code-block:: bash
  
  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

.. code-block:: bash
  
  ls /cvmfs/fairsoft.gsi.de
  centos7  centos8  debian10  debian8  macos-10.15  ubuntu1804