gfal client

This page includes the basic commands to use gfal. For an overview of storage clients, see Storage clients.

gFAL

Note

To run the examples below you need to have a valid proxy, see StartGridSession.

Mandatory environment settings:

$export LCG_GFAL_INFOSYS=bdii.grid.sara.nl:2170

Note

The examples below will work both with TURLs and SURLs.

Creating/listing

  • Listing directories on dCache:

    $gfal-ls -l gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/

  • Listing directories on DPM:

    $gfal-ls -l gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid

  • Create a new directory on dCache:

    $gfal-mkdir gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/newdir/

  • Create a new directory on DPM:

    $gfal-mkdir gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/newdir/

Transferring data

  • Copy file from dCache to local machine:

    $gfal-copy gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/zap.tar file:///`pwd`/zap.tar

  • Copy file from DPM to local machine:

    $gfal-copy gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/zap.tar file:///`pwd`/zap.tar

  • Copy file from local machine to dCache:

    $gfal-copy file:///`pwd`/zap.tar gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/zap.tar

  • Copy file from local machine to DPM:

    $gfal-copy file:///`pwd`/zap.tar gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/zap.tar

Recursive transfer

Recursive transfer of files is not supported with the gfal-copy command.

Parallel streams

Information not available yet.

Removing data

  • Remove a file from dCache:

    $gfal-rm gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/zap.tar

  • Remove a file from DPM:

    $gfal-rm gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/zap.tar

  • Remove whole (non-empty) directory with all content from dCache:

    $gfal-rm -r gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/testdir/

  • Remove whole (non-empty) directory with all content from DPM:

    $gfal-rm -r gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/testdir/