GridStorageAccess: Difference between revisions
No edit summary |
|||
Line 1: | Line 1: | ||
This page describes how to handle data stored on grid storage. | This page describes how to handle data stored on grid storage. | ||
=== | == Before starting == | ||
[[File:Exclamation-mark.jpg|left|40x30px|line=1|]] Before being able to run these commands you first need to make a valid proxy [[File:Exclamation-mark.jpg|40x30px|line=1|]] <br> | |||
=== | ::: <pre>voms-proxy-init --voms cms</pre> | ||
*'' | == GFAL == | ||
*'' | GFAL is a wrapper around the latest grid commands. Learning to use it means that whatever middleware requires to be used in the future, you don't need to learn new commands (like srm, lcg, etc) | ||
*'' | |||
*'' | |||
<br><br> | |||
=== | === gfal-commands === | ||
If you want more information on the options that can be used, please use '''man gfal-command''' ! | |||
* | |||
Here are all the commands that can be used: | |||
*''gfal-ls'': get information on a file | |||
*''gfal-mkdir'': remove a directory | |||
*''gfal-rm'': removes a file. To remove an entire directory, use -r | |||
* | *''gfal-copy'': copy files. | ||
<br><br> | |||
=== Usage === | |||
There are 2 types of file url: | |||
==== | * '''Distant files''': their url is of the type srm://<name_of_server>:<port>/some/path, eg for IIHE: | ||
*list contents of a directory ''/pnfs/iihe/cms'' | srm://maite.iihe.ac.be:8443/pnfs/iihe/ | ||
<pre> | * '''Local files''': their url is of the type file://path_of_the_file, eg for IIHE: | ||
file:///user/$USER/MyFile.root | |||
</pre> | |||
*create a directory | [[File:Exclamation-mark.jpg|left|40x30px|line=1|]] Be careful, the number of '''/''' is very -very- important [[File:Exclamation-mark.jpg|40x30px|line=1|]] | ||
<pre> | |||
</pre> | *To get a list of all distant urls for all the Storage Elements, one can do: | ||
::<pre> lcg-infosites --vo cms se </pre> | |||
=== Examples === | |||
*To list the contents of a directory ''/pnfs/iihe/cms'' : | |||
::<pre> gfal-ls srm://maite.iihe.ac.be:8443/pnfs/iihe/cms </pre> | |||
* To create a directory: | |||
::<pre> gfal-mkdir srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/NewDir </pre> | |||
*copy file from local disk to remote server | *copy file from local disk to remote server | ||
::<pre> gfal-copy file:///user/$USER/MyFile.root srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/ </pre> | |||
< | |||
</pre> | |||
* To copy a file from remote server to our Storage Element: | |||
::<pre> gfal-copy srm://srm-eoscms.cern.ch:8443/srm/v2/server?SFN=/eos/cms/store/group/comm_trigger/L1TrackTrigger/BE5D_620_SLHC6/singleMu/NoPU/reDIGI_SLHC6-TrackTrigger_muon_pgun-0499.root srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/odevroed/eosTransfer.root </pre> | |||
* To delete a file on remote server | |||
::<pre> gfal-rm srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/MyFile.root </pre> | |||
* To remove a directory and its entire content on remote server ?!? not working for now ?): | |||
::<pre> gfal-rm -r srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/NewDir </pre> | |||
=== Bulk file transfers === | |||
There is an elegant way to run gfal-copy through several files. This is done using the '''--from-file''' option. | |||
<pre> | Syntax: | ||
<pre> gfal-copy -f --from-file files.txt file://$PWD </pre> | |||
</pre> | where files.txt is a file where every line is a source in srm url syntax. | ||
Make some tests with one line in datafile and make sure the srm url is OK for both source and destination before running over several files. | Make some tests with one line in datafile and make sure the srm url is OK for both source and destination before running over several files. | ||
=== | === Copy directories from and to pnfs within the IIHE === | ||
A script to copy full directories to and from pnfs exists on the slc6 UI's: | A script to copy full directories to and from pnfs exists on the slc6 UI's: | ||
Line 108: | Line 93: | ||
== dCache == | |||
Direct dcache access to files is only possible if the software supports it. | Direct dcache access to files is only possible if the software supports it. | ||
PNFS (the directory structure seen under /pnfs/) is NOT a real filesystem, | PNFS (the directory structure seen under /pnfs/) is NOT a real filesystem: it is an '''immutable''' filesystem, and is mounted read-only. | ||
* | |||
*Therefore, here is a list of the commands that work: | |||
* | '''ls''' | ||
**dccp | * And replacement commands: | ||
** '''dccp''': to copy files from /pnfs to local disk. Example: | |||
* | dccp dcap://maite.iihe.ac.be/pnfs/iihe | ||
<pre> | |||
* To open files using root, use eg | |||
</pre> | <pre> root dcap://maite.iihe.ac.be/pnfs/iihe/some/file.root </pre> | ||
When reading out the rootfiles is rather slow or it doesn't work at all and nothing is wrong with the root file (e.g. in an interactive analysis on beo or msa) you can increase your dCache readahead buffer. Don't make the buffer larger than 50MB! To enlarge the buffer set this in you environment for csh: | When reading out the rootfiles is rather slow or it doesn't work at all and nothing is wrong with the root file (e.g. in an interactive analysis on beo or msa) you can increase your dCache readahead buffer. Don't make the buffer larger than 50MB! To enlarge the buffer set this in you environment for csh: | ||
Line 132: | Line 117: | ||
</pre> | </pre> | ||
See the dChache [http://www.dcache.org/ fanpage] for further reading. | See the dChache [http://www.dcache.org/ fanpage] for further reading. | ||
Revision as of 15:22, 13 July 2016
This page describes how to handle data stored on grid storage.
Before starting
Before being able to run these commands you first need to make a valid proxy
voms-proxy-init --voms cms
GFAL
GFAL is a wrapper around the latest grid commands. Learning to use it means that whatever middleware requires to be used in the future, you don't need to learn new commands (like srm, lcg, etc)
gfal-commands
If you want more information on the options that can be used, please use man gfal-command !
Here are all the commands that can be used:
- gfal-ls: get information on a file
- gfal-mkdir: remove a directory
- gfal-rm: removes a file. To remove an entire directory, use -r
- gfal-copy: copy files.
Usage
There are 2 types of file url:
- Distant files: their url is of the type srm://<name_of_server>:<port>/some/path, eg for IIHE:
srm://maite.iihe.ac.be:8443/pnfs/iihe/
- Local files: their url is of the type file://path_of_the_file, eg for IIHE:
file:///user/$USER/MyFile.root
Be careful, the number of / is very -very- important
- To get a list of all distant urls for all the Storage Elements, one can do:
lcg-infosites --vo cms se
Examples
- To list the contents of a directory /pnfs/iihe/cms :
gfal-ls srm://maite.iihe.ac.be:8443/pnfs/iihe/cms
- To create a directory:
gfal-mkdir srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/NewDir
- copy file from local disk to remote server
gfal-copy file:///user/$USER/MyFile.root srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/
- To copy a file from remote server to our Storage Element:
gfal-copy srm://srm-eoscms.cern.ch:8443/srm/v2/server?SFN=/eos/cms/store/group/comm_trigger/L1TrackTrigger/BE5D_620_SLHC6/singleMu/NoPU/reDIGI_SLHC6-TrackTrigger_muon_pgun-0499.root srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/odevroed/eosTransfer.root
- To delete a file on remote server
gfal-rm srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/MyFile.root
- To remove a directory and its entire content on remote server ?!? not working for now ?):
gfal-rm -r srm://maite.iihe.ac.be:8443/pnfs/iihe/cms/store/user/$USER/NewDir
Bulk file transfers
There is an elegant way to run gfal-copy through several files. This is done using the --from-file option.
Syntax:
gfal-copy -f --from-file files.txt file://$PWD
where files.txt is a file where every line is a source in srm url syntax.
Make some tests with one line in datafile and make sure the srm url is OK for both source and destination before running over several files.
Copy directories from and to pnfs within the IIHE
A script to copy full directories to and from pnfs exists on the slc6 UI's:
copyDirectoryPnfs.py Move all files in a directory to or from pnfs This script assumes that you copy within the IIHE The script does not do recursive copying Make sure you have a valid proxy, made with voms-proxy-init --voms cms:/cms/becms Mandatory options: --in= : directory to copy from --out= : directory to copy to Both directories need to be complete (i.e. including the /pnfs or /user part example: copyDirectoryPnfs.py --out=/user/odevroed/newfile --in=/pnfs/iihe/cms/store/user/odevroed/newdir Optional: -h, --help : print this help message
dCache
Direct dcache access to files is only possible if the software supports it. PNFS (the directory structure seen under /pnfs/) is NOT a real filesystem: it is an immutable filesystem, and is mounted read-only.
- Therefore, here is a list of the commands that work:
ls
- And replacement commands:
- dccp: to copy files from /pnfs to local disk. Example:
dccp dcap://maite.iihe.ac.be/pnfs/iihe
- To open files using root, use eg
root dcap://maite.iihe.ac.be/pnfs/iihe/some/file.root
When reading out the rootfiles is rather slow or it doesn't work at all and nothing is wrong with the root file (e.g. in an interactive analysis on beo or msa) you can increase your dCache readahead buffer. Don't make the buffer larger than 50MB! To enlarge the buffer set this in you environment for csh:
setenv DCACHE_RAHEAD 1 setenv DCACHE_RA_BUFFER 50000000
For bash:
export DCACHE_RAHEAD=true export DCACHE_RA_BUFFER=50000000
See the dChache fanpage for further reading.