= CernVM-FS =

[[TOC(inline)]]

== Dependencies ==

'''fuse''': file system in user space utilities are required

== Repositories ==

The repositories to be used can be defined with the following variable, but mind the [http://cernvm.cern.ch/portal/node/123 dependencies]:
{{{
variable CVMFS_REPOSITORIES ?= list(
    'alice.cern.ch',
    'atlas.cern.ch',
    'atlas-condb.cern.ch',
    'cms.cern.ch',
    'lhcb.cern.ch',
    'sft.cern.ch',
);
}}}

== Cache Location ==

The local cache is by default at /var/cache/cvmfs2, it can be relocated, e.g.:
{{{
variable CVMFS_CACHE_BASE ?= '/var/scratch/cvmfs';
}}}

== Cache Quota ==

The client cache is limited to less than 32768 files by default.
A per repository quota can added, e.g.:
{{{
variable CVMFS_QUOTA_LIMIT ?= 10000;
}}}

== Local Proxies ==

The use of a local proxy is highly recommended. This variable is undefined by default and must be configured according to your location, e.g.:
{{{
variable CVMFS_HTTP_PROXY ?= 'http://SQUID_FQDN_01:3128;http://SQUID_FQDN_02:3128';
}}}

== Stratum 1 Mirror Servers ==

Stratum 1 mirror servers should be sorted according to your location, this can be done by defining the variable:
{{{
variable CVMFS_SERVER_URL_CERN ?= nlist(
    'URL-01-CERN', 'http://cvmfs-stratum-one.cern.ch:8000/opt/@org@',
    'URL-02-UK', 'http://cernvmfs.gridpp.rl.ac.uk:8000/opt/@org@',
    'URL-03-BNL', 'http://cvmfs.racf.bnl.gov:8000/opt/@org@',
);
}}}

== Configuration ==

The configuration is done by:
{{{
include {'features/cvmfs/config'};
}}}

All the above variables can be safely configured site or cluster wide, they will only be taken into account by object profiles with:
{{{
variable CVMFS_CLIENT_ENABLED ?= true;
}}}

'''WARNING''', if not using the standard Quattor NFS configuration, the CernVM-FS automount map (/etc/auto.cvmfs) must be added to /etc/auto.master by other means, e.g.: cvmfs-auto-setup

== VO specificities ==

'''WARNING''', carelessly redirecting a VO's software area towards CernVM-FS will cause all software installation jobs to fail, therefore the VO should be aware of the change.

* ALICE

  ... dunno ...

* ATLAS

  Follow [https://twiki.cern.ch/twiki/bin/viewauth/Atlas/CernVMFS these instructions]

  The required ATLAS_LOCAL_AREA environment variable can defined using:
{{{
variable VO_ATLAS_LOCAL_AREA ?= '/path/to/shared/ATLAS/area';
}}}

* CMS

  '''WARNING''', quoting CMS:
{{{
This service is not stable enough to use in production. (2011/06/07)
}}}

  The CMS_LOCAL_SITE can be configured using:
{{{
variable VO_CMS_LOCAL_SITE ?= 'T2_FR_GRIF_subsite-name';
}}}

* LHCb

  Let the VO know about the change through a GGUS ticket.

  Redirect the software area (VO_LHCB_SW_DIR) to /cvmfs/lhcb.cern.ch

== Cleanup Script ==

An optional cleanup script can be enabled with:
{{{
variable CVMFS_ENABLE_CLIENT_CLEANUP ?= true;
}}}

== Links ==

* [http://cernvm.cern.ch/portal/startcvmfs CernVM-FS home]
* [http://cernvm.cern.ch/portal/techinfo CernVM-FS Technical Report]
* [http://cernvm.cern.ch/portal/cvmfs/release-2.0 CernVM-FS 2.0 Release Notes]