glite-transfer-submit

glite-transfer-submit — Submits a data transfer job

Synopsis

glite-transfer-submit [ -h ] [ -q ] [ -s SERVICE ] [ -V ] [ -v ] [ --verbose ] [ --source SSITE ] [ --dest DSITE ] [ -b ] [ -g PARAM ] [ -m SERVER ] [ -p PASSWORD ] [ -I DELEGATION_ID ] [ -t, --dest-token TOKEN ] [ -S, --source-token TOKEN ] [ -e EXPIRATION_TIME ] [ -f FILE ] [ -i TIME ] [ --copy-pin-lifetime N ] [ --lan-connection ] [ --fail-nearline ] [ --compare-checksums ] SOURCE-SURL DEST-SURL [CHECKSUM]

DESCRIPTION

glite-transfer-submit is a command-line tool for submitting new transfer jobs.

OPTIONS

-h

Print a short help message on parameters and usage, and exit.

-q

Quiet operation.

-s SERVICE

Specifies the service endpoint to use. If SERVICE starts with http://, https:// or httpg://, then it is taken as a direct service endpoint URL. Otherwise SERVICE is taken as a service instance name and Service Discovery is invoked to look up the endpoint. If no entries are found, SERVICE is then interpreted as site or host name and Service Discovery is again invoked. In that case, if more than one entry is returned, the client interface version is taken as reference to choose between all the discovered instances.

If this option is not specified, Service Discovery will be invoked and the first available transfer service will be used. If the Service Discovery fails, the program will exit with an error.

Note

If this option is not specified, only services with a known good status will be returned by Service Discovery. However if you explicitely specify a service name or an endpoint, the tool will try to use it regardless of its registered status.

-v

Print details about the service endpoint being used.

--verbose

Increases the verbosity level.

-V

Print the version number and exit.

--source SSITE
Specify source site to use. If used with the --dest option, service discovery if used to get the associated FileTransfer services of the ChannelAgent services which provide a channel from SSITE to DSITE.
--dest DSITE

Specify destination site to use.

-b

Blocking mode, wait until the transfer job completes.

-i TIME

Interval between two status polls in blocking mode.

-p PASSWORD

MyProxy password to send with the job

-g PARAMS

Pass the PARAMS parameters to gridftp.

-m SERVER

Pass SERVER as the MyProxy server.

-p PASSWORD

Specify MyProxy password as PASSWORD. This will force the use of MyProxy legacy mode on delegation-enabled FTS servers.

-I DELEGATION_ID

Specify the delegation ID as DELEGATION_ID.

-t --dest-token TOKEN

Specify the optional destination space token description as TOKEN. This option will only be used for SRM 2.2 destinations.

-S --source-token TOKEN

Specify the optional source space token description as TOKEN. This option will only be used for SRM 2.2 destinations.

-e EXPIRATION_TIME

Request the delegated credential to be valid for EXPIRATION_TIM minutes.

-f FILE

Read the list of files to transfer from FILE (- means the standard input). FILE must contain one source and one destination SURL, and may contain an optional ALGORITHM:CHECKSUM string per line, separated by white space. If either SURL contains white space, it must be protected using \ (backslash).

SOURCE-SURL

The source SURL.

DEST-SURL

The destination SURL.

[CHECKSUM]

The optional checksum provided by the client. It has the format of 'ALGORITHM:CHECKSUM', for example 'ADLER32:12345678'.

--copy-pin-lifetime N

pin lifetime of the copy of the file created after a successful srmPutDone or srmCopy operations, in seconds.

--lan-connection

use "LAN" as ConnectionType (FTS by default uses WAN).

--fail-nearline

fail the transfer immediately if the file location is NEARLINE (do not even start the transfer).

--compare-checksums

compare the checksum of the source and destination files, which implies fetching the checksum of the source, even if it is provided by the client

ENVIRONMENT VARIABLES

GLITE_SD_FTS_TYPE

Specifies the type of the service to use during service discovery. The default value is org.glite.FileTransfer.

SEE ALSO

glite-transfer-list(1) glite-delegation-init(1) glite-delegation-info(1) glite-delegation-destroy(1)