FTS commands reference
======================
                                   Derek Feichtinger <derek.feichtinger@psi.ch>


===========================
FTS endpoints

List of endpoints from BDII:
$> lcg-infosites --vo cms  fts


Most important endpoint for CSCS:
export FTSEP=https://fts-fzk.gridka.de:8443/glite-data-transfer-fts/services

also useful to define the SRM base address at FZK, if one wants to copy files
from there.
export FZKSRM="srm://gridka-dcache.fzk.de:8443/srm/managerv1?SFN="


FTS service URLs consist of a base URL + a service class string at the end
Service classes: ChannelManagement, FileTransfer, FileTransferStats

=========================
Authentication:

Create a myproxy long lived certificate:
The default myproxy server is: myproxy-fts.cern.ch.
Use -d option to register credentialsunder your certificate subject's name:

$> myproxy-init -d -s myproxy-fts.cern.ch
# your cert's subject line is used as username (-d option)

Check the credential:
$> myproxy-info -d -s myproxy-fts.cern.ch

Get a delegated proxy
$> myproxy-get-delegation -v -l "$mycertsubject" -s myproxy-fts.cern.ch \
                -o /tmp/mydelegated_proxy
  Note: for some reason -d flag seems not to work here


=====================================================================
JOB SUBMISSION

$> glite-transfer-submit -s $FTSEP/FileTransfer \
 $FZKSRM/pnfs/gridka.de/cms/disk-only/phedex_monarctest/FZK-DISK2/LoadTest07_FZK_93 \
 $SRM/cms/local_tests/derek-fts7.tst

or using a transfer file with (src trg) lines (you can specify multiple files)

Put a line like this into a file copyjob.tst (using our variable definitions):
$> echo \
  "$FZKSRM/pnfs/gridka.de/cms/disk-only/phedex_monarctest/FZK-DISK2/LoadTest07_FZK_93 $SRM/cms/local_tests/derek-fts7.tst" \
  > copyjob.tst

$> glite-transfer-submit -s $FTSEP/FileTransfer -f transferfile

==========================
QUERY FUNCTIONS:

listing active jobs:
$> glite-transfer-list -s $FTSEP/FileTransfer
$> glite-transfer-list -s $FTSEP/FileTransfer -c STAR-CSCS
7f24373b-efc0-11da-87a7-af210a7068ea    Active
    to find out about the job submission time, you need to use the "--verbose"
    switch, it's not the same as "-v"!!!

Job status query:
$> glite-transfer-status -l -v -s $FTSEP/FileTransfer 7f24373b-efc0-11da-87a7-af210a7068ea
    to find out about the job submission time, you need to use the "--verbose"
    switch, it's not the same as "-v"!!!


$> glite-transfer-stats-channel -s $FTSEP/FileTransferStats -v STAR-CSCS
Request returns empty set of results. Not yet implemented, I think


Service queries:
$> glite-transfer-service-info --version -s $FTSEP/FileTransfer
# Service version: 3.2.0


$> glite-transfer-stats-agents -s $FTSEP/FileTransferStats
I no longer have permission to do this. The output used to be
...
--== Agent 30/34 ==--
Name:        channel:STAR-CSCS
DN:          /O=GermanGrid/OU=FZK/CN=fts-fzk.gridka.de
Host:        fts-fzk.gridka.de
Type:        channel
Last active: 2006-9-7 12:40:2
State:       Started
Version:     2.2.2
Contact:     (null)
...

=====================================================================
MANAGEMENT FUNCTIONS:

You need to be a VO or channel manager for many of these functions

$> glite-transfer-channel-list -s $FTSEP/ChannelManagement
$> glite-transfer-channel-listmanagers -s $FTSEP/ChannelManagement STAR-CSCS
$> glite-transfer-channel-list -s $FTSEP/ChannelManagement STAR-CSCS
Channel: STAR-CSCS
Between: * and CSCS-LCG2
State: Active
Contact: (null)
Bandwidth: 0
Nominal throughput: 0
Number of files: 10, streams: 10
Number of VO shares: 4
VO 'dteam' share is: 25
VO 'atlas' share is: 25
VO 'cms' share is: 25
VO 'lhcb' share is: 25

$> glite-transfer-getroles -s $FTSEP/FileTransfer
You current clientDN is: /O=GRID-FR/C=CH/O=CSCS/OU=CC-LCG/CN=Derek Feichtinger

You are not authorised as Service Admin on this service.

You are authorised to submit to this service because your cert contains the
following principal: /O=GRID-FR/C=CH/O=CSCS/OU=CC-LCG/CN=Derek Feichtinger

You are VO manager for 0 VOs.

You are channel manager for 1 channels.
You are channel manager for channel <STAR-CSCS> because your cert contains the
following principal: /O=GRID-FR/C=CH/O=CSCS/OU=CC-LCG/CN=Derek Feichtinger


Set state (running or not):
$> glite-transfer-channel-set -s $FTSEP/ChannelManagement -S Active CSCS-CERN
$> glite-transfer-channel-set -s $FTSEP/ChannelManagement -S Inactive CSCS-CERN


Set number of concurrent transfers:
$> glite-transfer-channel-set -s $FTSEP/ChannelManagement -f 10 CSCS-CERN


Set default TCP streams:
$> glite-transfer-channel-set -s $FTSEP/ChannelManagement -T 1 STAR-CSCS