1FTS-REST-CLI(1)                                                FTS-REST-CLI(1)
2
3
4

NAME

6       fts-rest-transfer-submit
7

SYNOPIS

9       Usage: fts-rest-transfer-submit options SOURCE DESTINATION [CHECKSUM]
10

DESCRIPTION

12       This  command can be used to submit new jobs to FTS3.  It supports sim‐
13       ple and bulk submissions.  The bulk format is as follows:
14
15              {
16                "files": [
17                  {
18                    "sources": [
19                      "gsiftp://source.host/file"
20                    ],
21                    "destinations": [
22                      "gsiftp://destination.host/file"
23                    ],
24                    "metadata": "file-metadata",
25                    "checksum": "ADLER32:1234",
26                    "filesize": 1024
27                  },
28                  {
29                    "sources": [
30                      "gsiftp://source.host/file2"
31                    ],
32                    "destinations": [
33                      "gsiftp://destination.host/file2"
34                    ],
35                    "metadata": "file2-metadata",
36                    "checksum": "ADLER32:4321",
37                    "filesize": 2048,
38                    "activity": "default"
39                  }
40                ]
41              }
42

OPTIONS

44       -h/–help
45              Show this help message and exit
46
47       -v/–verbose
48              Verbose output.
49
50       -s/–endpoint
51              Fts3 rest endpoint.
52
53       -j/–json
54              Print the output in json format.
55
56       –key   The user certificate private key.
57
58       –cert  The user certificate.
59
60       –capath
61              Use the specified directory to verify the peer
62
63       –insecure
64              Do not validate the server certificate
65
66       –access-token
67              IAM-XDC access token (supported only by  some  endpoints,  takes
68              precedence)
69
70       –target-qos
71              the  target QoS that the destination has to have when the opera‐
72              tion is finished
73
74       -b/–blocking
75              Blocking mode.  Wait until the operation completes.
76
77       -i/–interval
78              Interval between two poll operations in blocking mode.
79
80       -e/–expire
81              Expiration time of the delegation in minutes.
82
83       –delegate-when-lifetime-lt
84              Delegate the proxy when the remote lifetime is  less  than  this
85              value (in minutes)
86
87       -o/–overwrite
88              Overwrite files.
89
90       -r/–reuse
91              Enable session reuse for the transfer job.
92
93       –job-metadata
94              Transfer job metadata.
95
96       –file-metadata
97              File metadata.
98
99       –file-size
100              File size (in bytes)
101
102       -g/–gparam
103              Gridftp parameters.
104
105       -t/–dest-token
106              The destination space token or its description.
107
108       -S/–source-token
109              The source space token or its description.
110
111       -K/–compare-checksum
112              Deprecated: compare checksums between source and destination.
113
114       -C/–checksum-mode
115              Compare checksums in source, target, both or none.
116
117       –copy-pin-lifetime
118              Pin lifetime of the copy in seconds.
119
120       –bring-online
121              Bring online timeout in seconds.
122
123       –timeout
124              Transfer timeout in seconds.
125
126       –fail-nearline
127              Fail the transfer is the file is nearline.
128
129       –dry-run
130              Do not send anything, just print the json message.
131
132       -f/–file
133              Name of configuration file
134
135       –retry Number  of  retries.  If 0, the server default will be used.  If
136              negative, there will be no retries.
137
138       -m/–multi-hop
139              Submit a multihop transfer.
140
141       –cloud-credentials
142              Use cloud credentials for the job (i.  E.  Dropbox).
143
144       –nostreams
145              Number of streams
146
147       –ipv4  Force ipv4
148
149       –ipv6  Force ipv6
150

EXAMPLE

152              $ fts-rest-transfer-submit -s https://fts3-devel.cern.ch:8446 gsiftp://source.host/file gsiftp://destination.host/file
153              Job successfully submitted.
154              Job id: 9fee8c1e-c46d-11e3-8299-02163e00a17a
155
156              $ fts-rest-transfer-submit -s https://fts3-devel.cern.ch:8446 -f bulk.json
157              Job successfully submitted.
158              Job id: 9fee8c1e-c46d-11e3-8299-02163e00a17a
159

AUTHORS

161       fts-devel@cern.ch.
162
163
164
165fts-rest-transfer-submit        August 24, 2016                FTS-REST-CLI(1)
Impressum