| 1 | = CernVM-FS = |
| 2 | |
| 3 | [[TOC(inline)]] |
| 4 | |
| 5 | == Dependencies == |
| 6 | |
| 7 | '''fuse''': file system in user space utilities are required |
| 8 | |
| 9 | == Repositories == |
| 10 | |
| 11 | The repositories to be used can be defined with the following variable, but mind the [http://cernvm.cern.ch/portal/node/123 dependencies]: |
| 12 | {{{ |
| 13 | variable CVMFS_REPOSITORIES ?= list( |
| 14 | 'alice.cern.ch', |
| 15 | 'atlas.cern.ch', |
| 16 | 'atlas-condb.cern.ch', |
| 17 | 'cms.cern.ch', |
| 18 | 'lhcb.cern.ch', |
| 19 | 'sft.cern.ch', |
| 20 | ); |
| 21 | }}} |
| 22 | |
| 23 | == Cache Location == |
| 24 | |
| 25 | The local cache is by default at /var/cache/cvmfs2, it can be relocated, e.g.: |
| 26 | {{{ |
| 27 | variable CVMFS_CACHE_BASE ?= '/var/scratch/cvmfs'; |
| 28 | }}} |
| 29 | |
| 30 | == Cache Quota == |
| 31 | |
| 32 | The client cache is limited to less than 32768 files by default. |
| 33 | A per repository quota can added, e.g.: |
| 34 | {{{ |
| 35 | variable CVMFS_QUOTA_LIMIT ?= 10000; |
| 36 | }}} |
| 37 | |
| 38 | == Local Proxies == |
| 39 | |
| 40 | 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.: |
| 41 | {{{ |
| 42 | variable CVMFS_HTTP_PROXY ?= 'http://SQUID_FQDN_01:3128;http://SQUID_FQDN_02:3128'; |
| 43 | }}} |
| 44 | |
| 45 | == Stratum 1 Mirror Servers == |
| 46 | |
| 47 | Stratum 1 mirror servers should be sorted according to your location, this can be done by defining the variable: |
| 48 | {{{ |
| 49 | variable CVMFS_SERVER_URL_CERN ?= nlist( |
| 50 | 'URL-01-CERN', 'http://cvmfs-stratum-one.cern.ch:8000/opt/@org@', |
| 51 | 'URL-02-UK', 'http://cernvmfs.gridpp.rl.ac.uk:8000/opt/@org@', |
| 52 | 'URL-03-BNL', 'http://cvmfs.racf.bnl.gov:8000/opt/@org@', |
| 53 | ); |
| 54 | }}} |
| 55 | |
| 56 | == Configuration == |
| 57 | |
| 58 | The configuration is done by: |
| 59 | {{{ |
| 60 | include {'features/cvmfs/config'}; |
| 61 | }}} |
| 62 | |
| 63 | All the above variables can be safely configured site or cluster wide, they will only be taken into account by object profiles with: |
| 64 | {{{ |
| 65 | variable CVMFS_CLIENT_ENABLED ?= true; |
| 66 | }}} |
| 67 | |
| 68 | '''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 |
| 69 | |
| 70 | == VO specificities == |
| 71 | |
| 72 | '''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. |
| 73 | |
| 74 | * ALICE |
| 75 | |
| 76 | ... dunno ... |
| 77 | |
| 78 | * ATLAS |
| 79 | |
| 80 | Follow [https://twiki.cern.ch/twiki/bin/viewauth/Atlas/CernVMFS these instructions] |
| 81 | |
| 82 | The required ATLAS_LOCAL_AREA environment variable can defined using: |
| 83 | {{{ |
| 84 | variable VO_ATLAS_LOCAL_AREA ?= '/path/to/shared/ATLAS/area'; |
| 85 | }}} |
| 86 | |
| 87 | * CMS |
| 88 | |
| 89 | '''WARNING''', quoting CMS: |
| 90 | {{{ |
| 91 | This service is not stable enough to use in production. (2011/06/07) |
| 92 | }}} |
| 93 | |
| 94 | The CMS_LOCAL_SITE can be configured using: |
| 95 | {{{ |
| 96 | variable VO_CMS_LOCAL_SITE ?= 'T2_FR_GRIF_subsite-name'; |
| 97 | }}} |
| 98 | |
| 99 | * LHCb |
| 100 | |
| 101 | Let the VO know about the change through a GGUS ticket. |
| 102 | |
| 103 | Redirect the software area (VO_LHCB_SW_DIR) to /cvmfs/lhcb.cern.ch |
| 104 | |
| 105 | == Cleanup Script == |
| 106 | |
| 107 | An optional cleanup script can be enabled with: |
| 108 | {{{ |
| 109 | variable CVMFS_ENABLE_CLIENT_CLEANUP ?= true; |
| 110 | }}} |
| 111 | |
| 112 | == Links == |
| 113 | |
| 114 | * [http://cernvm.cern.ch/portal/startcvmfs CernVM-FS home] |
| 115 | * [http://cernvm.cern.ch/portal/techinfo CernVM-FS Technical Report] |
| 116 | * [http://cernvm.cern.ch/portal/cvmfs/release-2.0 CernVM-FS 2.0 Release Notes] |