====== Installation of CVMFS ======

  * The official ATLAS documentation for installation of CVMFS client can be found at [[https://twiki.cern.ch/twiki/bin/view/Atlas/Tier3CVMFS2SLC5 | this reference]].
  * The official CVMFS documentation can be found at [[http://cernvm.cern.ch/portal/techinfo | this reference]].


 
Read: https://twiki.cern.ch/twiki/bin/view/Atlas/Tier3CVMFS2SLC5 


===== ANL-specific details =====

  * The cache area is located in /home/cache/cvmfs2.  The **path** variable in the ATLAS documentation is **home**
    * /home/cache/cvmfs2 should be owned by the cvmfs account
  * Only 25 GB of space is needed 
  * The cvmfs account will be created in the /etc/passwd file.<code>cvmfs:x:383:384:CernVM-FS service account:/var/cache/cvmfs2:/sbin/nologin</code>

===== Local Configuration details =====

In this section the specific configuration details for ANL will be listed.

  - Edit (create if it does not exist) the file /etc/cvmfs/default.local, in particular, change <code>CVMFS_REPOSITORIES=atlas.cern.ch,atlas-condb.cern.ch,atlas-nightlies.cern.ch
CVMFS_CACHE_BASE=/home/cache/cvmfs2
CVMFS_QUOTA_LIMIT=13000
CVMFS_HTTP_PROXY="http://squid.hep.anl.gov:3128;DIRECT"</code>
  - Create a file /etc/cvmfs/domain.d/cern.ch.local and add the following entry: <code>#  Change the order so that the nearest server is the first in the list ...
#  Note that port 8000 is preferred for the servers below but,  if it does not work, use port 80 instead.
# if you are in North America (uncomment)
CVMFS_SERVER_URL="http://cvmfs.racf.bnl.gov:8000/opt/@org@;http://cvmfs-stratum-one.cern.ch:8000/opt/@org@;http://cernvmfs.gridpp.rl.ac.uk:8000/opt/@org@"</code>
  - Add cvmfs to chkconfig<code>/sbin/chkconfig --levels 345 cvmfs on</code>
  - Restart cvmfs<code>/sbin/service cvmfs restart</code>
  - Check if cvmfs works, by inspecting the contents of the following directories:<code>
> ls /cvmfs/atlas.cern.ch/
repo
> ls /cvmfs/atlas.cern.ch/repo
ATLASLocalRootBase  conditions  sw
> ls /cvmfs/atlas-condb.cern.ch/repo
conditions  tag</code>
 
===== Start and stop cvmfs =====

  * Start <code>/sbin/service cvmfs start</code>
  * Stop  <code>/sbin/service cvmfs stop</code>


===== How to install on SL6.4 =====


For SL6, do this:



 <code>
 yum install compat-expat1 openssl098e libuuid-devel
 rpm -Uvh http://cvmrepo.web.cern.ch/cvmrepo/yum/cvmfs/EL/6/x86_64/cvmfs-release-2-4.el6.noarch.rpm
 yum install cvmfs cvmfs-init-scripts cvmfs-auto-setup  cvmfs-keys.noarch cvmfs.x86_64 
</code>

Doug suggestions (no need!):

<code>
yum install libuuid-devel
ln -s  /lib64/libuuid.so.1 /lib64/libuuid.so
wget http://linuxsoft.cern.ch/cern/slc6X/extras/x86_64/RPMS/HEP_OSlibs_SL6-1.0.7-0.el6.x86_64.rpm
yum install HEP_OSlibs_SL6-1.0.7-0.el6.x86_64.rpm 
</code>


Bob suggested:
<code>
cat - >/etc/cvmfs/default.local <<EOF
CVMFS_QUOTA_LIMIT=100000
CVMFS_HTTP_PROXY="http://squid.hep.anl.gov:3128;http://cvmfs02.racf.bnl.gov:8000|http://cvmfs03.racf.bnl.gov:8000;DIRECT"
CVMFS_SERVER_URL=http://cvmfs.racf.bnl.gov:8000/opt/atlas-newns,http://cvmfs-stratum-one.cern.ch/opt/atlas-newns
CVMFS_REPOSITORIES=atlas.cern.ch,atlas-condb.cern.ch,atlas-nightlies.cern.ch,geant4.cern.ch,grid.cern.ch,sft.cern.ch
#CVMFS_DEBUGLOG=/var/log/cvmfs.log
EOF
</code>

Then put ANL specific files (take from atlas17)

<code>
scp chakanau@atlas1.hep.anl.gov:/etc/cvmfs/domain.d/cern.ch.local /etc/cvmfs/domain.d/
scp chakanau@atlas1.hep.anl.gov:/etc/cvmfs/default.local /etc/cvmfs/
</code>


How to test

Run:

<code>
/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase/utilities/installCheck.sh
</code>

and install the needed packages.

<code>
export ATLAS_LOCAL_ROOT_BASE=/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase
source ${ATLAS_LOCAL_ROOT_BASE}/user/atlasLocalSetup.sh
</code>