CernVM-FS Client Quick Start

This section describes how to install the CernVM-FS client. The CernVM-FS client is supported on x86, x86_64, and ARMv7 architectures running Scientific Linux 4-7, Ubuntu >= 12.04, SLES 11 and openSuSE 13.1, Fedora 21-23, and Mac OS X >= 10.10. There is experimental support for AArch64 and Power 8 little-endian.

Getting the Software

The CernVM-FS source code and binary packages are available from the downloads page. Binary packages are produced for rpm, dpkg, and Mac OS X (.pkg). Yum repositories for 64bit and 32bit Scientific Linux 5 and 6 and 64bit Scientific Linux 7 are available under http://cvmrepo.web.cern.ch/cvmrepo/yum. An apt repository for Ubuntu packages is available under http://cvmrepo.web.cern.ch/cvmrepo/apt. The cvmfs-release package can be used to add a these repositories to the local installation as described on the downloads page.

Installation

Linux

To install, proceed according to the following steps:

  1. Install the CernVM-FS packages. With yum, run
    sudo yum install cvmfs cvmfs-config-default

    If yum does not show the latest packages, clean the yum cache by yum clean all. On Ubuntu, use

    sudo apt-get install cvmfs cvmfs-config-default

    If apt does not show the latest packages, run sudo apt-get update before.

  2. For the base setup, run cvmfs_config setup. If you migrate from a previous version of CernVM-FS, check the release notes if there is anything special to do for migration.
  3. Create /etc/cvmfs/default.local and open the file for editing.
  4. Select the desired repositories by setting CVMFS_REPOSITORIES=repo1,repo2,.... For ATLAS, for instance, set
    CVMFS_REPOSITORIES=atlas.cern.ch,atlas-condb.cern.ch,grid.cern.ch

    Specify the HTTP proxy servers on your site with

    CVMFS_HTTP_PROXY="http://myproxy1:port|http://myproxy2:port"
    

    Inside CERN, it is "http://ca-proxy.cern.ch:3128".

  5. Check if CernVM-FS mounts the specified repositories by cvmfs_config probe. If the probe fails, try to restart autofs with sudo service autofs restart.

Mac OS X

On Mac OS X, CernVM-FS uses Fuse for OSX. It is not integrated with autofs, i.e. repositories need to be manually mounted. In order to install, proceed according to the following steps:

  1. Install the CernVM-FS package by opening the .pkg file.
  2. Create /etc/cvmfs/default.local and open the file for editing.
  3. Select the desired repositories by setting CVMFS_REPOSITORIES=repo1,repo2,.... For ATLAS, for instance, set
    CVMFS_REPOSITORIES=atlas.cern.ch,atlas-condb.cern.ch,grid.cern.ch

    Specify the HTTP proxy servers on your site with

    CVMFS_HTTP_PROXY="http://myproxy1:port|http://myproxy2:port"

    Inside CERN, it is "http://ca-proxy.cern.ch:3128". If you're unsure about the proxy names, set CVMFS_HTTP_PROXY=DIRECT.

  4. Mount your repositories like
    sudo mkdir -p /cvmfs/cms.cern.ch
    sudo mount -t cvmfs cms.cern.ch /cvmfs/cms.cern.ch

Usage

The CernVM-FS repositories are located under /cvmfs. Each repository is identified by a fully qualified repository name, like "atlas.cern.ch". The fully qualified repository name consists of a repository identifier and a domain name. The domain part of the fully qualified repository name indicates the location of repository creation and maintenance.

Mounting and un-mounting of the CernVM-FS is controlled by autofs. That is, starting from the base directory /cvmfs different repositories are mounted automatically just by accessing them. For instance, running the command <code>ls /cvmfs/atlas.cern.ch</code> will mount the ATLAS software repository on the fly. This directory gets automatically unmounted after some system-defined idle time.

Debugging Hints

In order to check for common misconfigurations in the base setup, run

cvmfs_config chksetup

 

CernVM-FS gathers its configuration parameter from various configuration files that can overwrite each others settings (default configuration, domain specific configuration, local setup, ...). To show the effective configuration for repository.cern.ch, run

cvmfs_config showconfig repository.cern.ch

 

In order to exclude autofs as a source of problems, you can try to mount repository.cern.ch manually by

mkdir -p /mnt/cvmfs
mount -t cvmfs repository.cern.ch /mnt/cvmfs

 

In order to exclude SELinux as a source of problems, you can try mounting after SELinux has been disabled by

/usr/sbin/setenforce 0

 

Once you sorted out a problem, make sure that you do not get the original error served from the file system buffers by

service autofs restart

For further information, please see our debugging hints and the support links.

You are here