=====  Show-se-space  =====

''show-se-space'' computes the SE data provided by lcg-infosites to allow for sorting the result by column, and calculate the sum of each column: available, used and total space (in GB), and percentage of used space.

====  Install & configuration  ====

Download the project from the [[Biomed-Shifts:Biomed-support-tools|VO support tools page]].

Define variable VO_SUPPORT_TOOLS to like:
<code>export VO_SUPPORT_TOOLS=/home/fmichel/biomed-support-tools</code>

The tool can be executed on any well configured gLite UI, it does not require any proxy certificate. The lcg-infosites command must be reachable in the path.

====  Usage  ====

Usage:
<code>
$VO_SUPPORT_TOOLS/SE/shwow-se-space/show-se-space.sh [-h|--help]
$VO_SUPPORT_TOOLS/SE/shwow-se-space/show-se-space.sh [--vo|<VO>] [--sort <sort type>]
             [--reverse] [--max|<nblines>] [--multiples] [--no-sum] [--no-header]
  --vo <VO> the Virtual Organisation to query. Defaults to biomed.
  -s, --sort {name | avail | used | total | %used}: sort output by hostname, available space,
      used space, total space, or %age of used space. Defaults to name
  --r, --reverse: sort in reverse order
  -m, --max <nblines> display only the given number of lines
  --multiples: display only multiple entries of the same SE
  --no-header: do not display header lines
  --no-sum: do not calculate the final sum of each column
  -h, --help: display this help</code>
</code>

====  Credits  ====

This tool is developed at [[http://www.i3s.unice.fr/I3S/|CNRS I3S]].

====  Examples  ====

**1. Get all biomed SEs sorted by hostname**
<code>
$ $VO_SUPPORT_TOOLS/SE/shwow-se-space/show-se-space.sh
</code>

**2. Get all biomed SEs sorted by % of used space in reverse order**
<code>
$ $VO_SUPPORT_TOOLS/SE/shwow-se-space/show-se-space.sh --sort --reverse %used
</code>

**3. Get the top 10 of the free SEs supporting VO vlemed with no final sum**
<code>
$ $VO_SUPPORT_TOOLS/SE/shwow-se-space/show-se-space.sh --vo vlemed --sort avail --reverse --max 10 --no-sum
</code>