fts-rest-transfer-submit man page

fts-rest-transfer-submit

Synopis

Usage: fts-rest-transfer-submit 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.

–delegate-when-lifetime-lt

Delegate the proxy when the remote lifetime is less than this value (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

Deprecated: compare checksums between source and destination.

-C/–checksum-mode

Compare checksums in source, target, both or none.

–copy-pin-lifetime

Pin lifetime of the copy in seconds.

–bring-online

Bring online timeout in seconds.

–timeout

Transfer 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

August 24, 2016 fts-rest-transfer-submit