====== LFCBrowseSE ======

LFCBrowseSE can list the files and the amount of storage used by users on a particular SE (useful for data migration in case of full SE). It also supports the replication of the files that are stored on the affected SE.

====  Install & configuration  ====

Download the tool: [[https://github.com/frmichel/vo-support-tools/blob/master/SE/lfc-browse-se/LFCBrowseSE.tgz|Source code and binary (x86-64)]].

The tool requires the presence of liblcgdm.so.1 and liblfc.so.1. If those do not exist on your system, you may have to create symbolic links like shown below:
<code>
# cd /opt/lcg/lib64
# ln -s liblcgdm.so liblcgdm.so.1
# ln -s liblfc.so liblfc.so.1
</code>
or, if you are not root user, copy those files to a directory of your choice and add that path to your LD_LIBRARY_PATH variable:
<code>
# cp /opt/lcg/lib64/liblcgdm.so /home/myhome/libs/liblcgdm.so.1
# cp /opt/lcg/lib64/liblfc.so /home/myhome/libs/liblfc.so.1
# export LD_LIBRARY_PATH=/home/myhome/libs:$LD_LIBRARY_PATH
</code>

Make sure your LFC variables are set, like:
<code>
export LFC_HOST=lfc-biomed.in2p3.fr
export LFC_HOME=/grid/biomed/mylogin
</code>

====  Usage  ====

<code>
usage syntax: ./LFCBrowseSEv2 <SE> [[--vo|<VO>]] [--sfn] [[--lfn]] [--dn] [[--size]] [--guid] [[--summary]][--rep|<DstSE>] [[--keep]]

<code>
 SE: affected SE from files will be listed
 --vo VO: optional, only list files belonging to the specified VO
 --sfn: optional, lists all the SURLs of the files affected.
 --lfn: optional, lists all the LFNs of the files affected.
 --dn: optional, displays the DNs of the owners of all the files affected.
 --size: optional, displays the size of the files affected.
 --guid: optional, lists the GUIDs of the files affected.
 --summary: optional, displays a summary of the different users with files affected and the total storage space occupied
 --quiet: optional, it does not display the progress
 --rep <DstSE>> optional, replicates matching instances on the specified SE
 --keep: optional, it does not delete the temporary files
</code>

====  Credits  ====

This tool is developed at [[http://www.upv.es/index-en.html|Universitat Politica de Valencia]].

====  Example  ====
List LFNs/DNs on an SE (e.g. in case of decommissioning): 
<code> ./LFCBrowseSE serv02.hep.phy.cam.ac.uk --vo biomed --lfn --dn </code>