uberftp client¶
This page includes the basic commands to use uberftp
. For an overview of storage clients, see Storage clients.
Uberftp¶
Creating/listing¶
Note
To run the examples below you need to have a valid proxy, see StartGridSession.
Listing directories on dCache:
$uberftp -ls gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/
Listing directories on DPM:
$uberftp -ls gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid
Create a new directory on dCache:
$uberftp -mkdir gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/newdir
Create a new directory on DPM:
$uberftp -mkdir gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/newdir
Transferring data¶
Copy file from dCache to local machine:
$uberftp gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/zap.tar file:///home/homer/zap.tar
Copy file from DPM to local machine:
$uberftp gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/zap.tar file:///home/homer/zap.tar
Copy file from local machine to dCache:
$uberftp file:///home/homer/zap.tar gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/zap.tar
Copy file from local machine to DPM:
$uberftp file:///home/homer/zap.tar gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/zap.tar
Note
The asterisk “*” wildcard (match all characters) works with uberftp. Please use this option with caution, especially when deleting files.
Parallel streams¶
The GridFTP protocol allows for parallel streaming of data transfers. This makes a transfer more efficient and less susceptible to network errors, especially over long distances. If you have a lot of simultaneous transfers running anyway, increasing the number of streams per transfer will not make a big difference, because the network bandwidth may limit the results.
$uberftp -parallel 4 \
$ gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/zap.tar \
$ file:zap.tar
Results may vary based on circumstances. We suggest a number of 4 streams as a start.
Removing data¶
Remove a file from dCache:
$uberftp -rm gsiftp://gridftp.grid.sara.nl:2811/pnfs/grid.sara.nl/data/lsgrid/homer/zap.tar
Remove a file from DPM:
$uberftp -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:
$uberftp -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:
$uberftp -rm -r gsiftp://gb-se-lumc.lumc.nl:2811/dpm/lumc.nl/home/lsgrid/homer/testdir/