fts-rest-transfer-submit man page

fts-rest-transfer-submit

Synopis

Usage: fts-rest-transfer-submit options (#options) SOURCE DESTINATION [CHECKSUM]

Description

This command can be used to submit new jobs to FTS3. It supports simple and bulk submissions. The bulk format is as follows:

{
  "files": [
    {
      "sources": [
        "gsiftp://source.host/file"
      ],
      "destinations": [
        "gsiftp://destination.host/file"
      ],
      "metadata": "file-metadata",
      "checksum": "ADLER32:1234",
      "filesize": 1024
    },
    {
      "sources": [
        "gsiftp://source.host/file2"
      ],
      "destinations": [
        "gsiftp://destination.host/file2"
      ],
      "metadata": "file2-metadata",
      "checksum": "ADLER32:4321",
      "filesize": 2048,
      "activity": "default"
    }
  ]
}

Options

-h/--help
Show this help message and exit
-v/--verbose
Verbose output.
-s/--endpoint
Fts3 rest endpoint.
-j/--json
Print the output in json format.
--key
The user certificate private key.
--cert
The user certificate.
--capath
Use the specified directory to verify the peer
--insecure
Do not validate the server certificate
--access-token
Oauth2 access token (supported only by some endpoints, takes precedence)
-b/--blocking
Blocking mode. Wait until the operation completes.
-i/--interval
Interval between two poll operations in blocking mode.
-e/--expire
Expiration time of the delegation in minutes.
-o/--overwrite
Overwrite files.
-r/--reuse
Enable session reuse for the transfer job.
--job-metadata
Transfer job metadata.
--file-metadata
File metadata.
--file-size
File size (in bytes)
-g/--gparam
Gridftp parameters.
-t/--dest-token
The destination space token or its description.
-S/--source-token
The source space token or its description.
-K/--compare-checksum
Compare checksums between source and destination.
--copy-pin-lifetime
Pin lifetime of the copy in seconds.
--bring-online
Bring online timeout in seconds.
--fail-nearline
Fail the transfer is the file is nearline.
--dry-run
Do not send anything, just print the json message.
-f/--file
Name of configuration file
--retry
Number of retries. If 0, the server default will be used. If negative, there will be no retries.
-m/--multi-hop
Submit a multihop transfer.
--cloud-credentials
Use cloud credentials for the job (i. E. Dropbox).
--nostreams
Number of streams
--ipv4
Force ipv4
--ipv6
Force ipv6

Example

$ fts-rest-transfer-submit -s https://fts3-devel.cern.ch:8446 gsiftp://source.host/file gsiftp://destination.host/file
Job successfully submitted.
Job id: 9fee8c1e-c46d-11e3-8299-02163e00a17a

$ fts-rest-transfer-submit -s https://fts3-devel.cern.ch:8446 -f bulk.json
Job successfully submitted.
Job id: 9fee8c1e-c46d-11e3-8299-02163e00a17a

Authors

fts-devel@cern.ch.

Info

October 05, 2015 fts-rest-transfer-submit