= CernVM-FS =
[[TracNav]]

[[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',
    'lhcb-conddb.cern.ch',
    'sft.cern.ch',
);
}}}

== Cache Location ==

In case there is a need to relocate the local cache, e.g.:
{{{
variable CVMFS_CACHE_BASE ?= '/var/scratch/cvmfs';
}}}

== Cache Quota ==

The client cache is limited to less than 4GB by default.
This can be customized, 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@',
    'URL-04-FNAL', 'http://cvmfs.fnal.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.

== 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

  No special requirements, deployment is being tracked [https://twiki.cern.ch/twiki/bin/view/LCG/CvmfsDeploymentStatus here].

* 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

  Follow [https://twiki.cern.ch/twiki/bin/view/CMSPublic/CernVMFS4cms these instructions]

  The CMS_LOCAL_SITE can be configured using:
{{{
variable VO_CMS_LOCAL_SITE ?= '<CMS shared FS>/SITECONF/local';
}}}

* 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

== 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.1 CernVM-FS 2.1 Release Notes]
* [http://cernvm.cern.ch/portal/node/123 CernVM-FS Configuration Examples]