1CHELONIA(1) NorduGrid Users Manual CHELONIA(1)
2
6 chelonia - Client for the Chelonia storage system
7
9 chelonia [-x] [method] [arguments]
10
12 chelonia is a client tool for accessing the Chelonia storage system.
13 With it you can create, remove and list collections, upload, download
14 and remove files, and move and stat collections and files, using Logi‐
15 cal Names.
16 Running without arguments it prints usage information. If you just
18 specify the method without any other argument, it prints usage informa‐
19 tion for that method.
20
23 -x prints the SOAP messages as XML documents.
24 list LN [LN ...]
26 List the content of the given collections specified by the given
27 Logical Names (LN)
28 makeCollection LN
30 Create a new collection with the Logical Name 'LN'.
31 unmakeCollection LN
33 Remove the collection with the Logical Name 'LN'.
34 putFile source target
36 Upload the local file 'source' to the Logical Name 'target'.
37 getFile source [target]
39 Download the file with Logical Name 'source', and store it
40 locally as 'target' or as the filename in the Logical Name if
41 'target' is not specified.
42 delFile LN [LN ...]
44 Remove the files with the specified Logical Names.
45 move source target
47 Move the file or collection with Logical Name 'source' to the
48 Logical Name 'target'.
49 stat LN [LN ...]
51 Get state information about files with Logical Names (LN)
52
54 ARC_BARTENDER_URL
55 The URL of the Bartender service can be specified by this vari‐
56 able.
57 If this variable is not set, http://localhost:60000/Bartender
59 will be used.
60 ARC_LOCATION
63 The location where ARC is installed can be specified by this
64 variable. If not specified the install location will be deter‐
65 mined from the path to the command being executed, and if this
66 fails a WARNING will be given stating the location which will be
67 used.
68 ARC_PLUGIN_PATH
71 The location of ARC plugins can be specified by this variable.
72 Multiple locations can be specified by separating them by : (;
73 in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
74 Windows).
75
78 Let's see some examples with results:
79 $ chelonia list /
81 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
82 - Calling the Bartender's list method...
83 - done in 0.03 seconds.
84 '/': not found
85 $ chelonia -x list /
86 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
87 - Calling the Bartender's list method...
88 Request:
89 <soap-env:Envelope>
90 <soap-env:Body>
91 <list>
92 <listRequestList>
93 <listRequestElement>
94 <requestID>0</requestID>
95 <LN>/</LN>
96 </listRequestElement>
97 </listRequestList>
98 <neededMetadataList>
99 <neededMetadataElement>
100 <section>entry</section>
101 <property></property>
102 </neededMetadataElement>
103 </neededMetadataList>
104 </list>
105 </soap-env:Body>
106 </soap-env:Envelope>
107 Response:
109 <soap-env:Envelope>
110 <soap-env:Body>
111 <bar:listResponse>
112 <bar:listResponseList>
113 <bar:listResponseElement>
114 <bar:requestID>0</bar:requestID>
115 <bar:entries></bar:entries>
116 <bar:status>not found</bar:status>
117 </bar:listResponseElement>
118 </bar:listResponseList>
119 </bar:listResponse>
120 </soap-env:Body>
121 </soap-env:Envelope>
122 - done in 0.03 seconds.
124 '/': not found
125 $ chelonia makeCollection /
126 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
127 - Calling the Bartender's makeCollection method...
128 - done in 0.05 seconds.
129 Creating collection '/': done
130 The methods can be listed with:
132 $ chelonia
133 Usage:
134 chelonia <method> [<arguments>]
135 Supported methods: stat, make[Collection], unmake[Collection], list, move, put[File], get[File], del[File]
136 Without arguments, each method prints its own help.
137 $ chelonia move
138 Usage: move <sourceLN> <targetLN>
139 LN means Logical Name everywhere in this system, this is the path in the global namespace.
141 The LNs are always absolute, must start with a '/'. (or with a '<GUID>/'...)
142 $ chelonia list /
144 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
145 - Calling the Bartender's list method...
146 - done in 0.04 seconds.
147 '/': collection
148 empty.
149 Actually you only need to type the first three character of the command:
151 $ chelonia lis /
153 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
154 - Calling the Bartender's list method...
155 - done in 0.04 seconds.
156 '/': collection
157 empty.
158 And you can use 'ls', 'mv', 'rmdir', 'mkdir', 'rm' as well:
160 $ chelonia ls /
162 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
163 - Calling the Bartender's list method...
164 - done in 0.03 seconds.
165 '/': collection
166 empty.
167 Let's create some sub-collections (sub-directories):
169 $ chelonia mkdir /tmp
170 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
171 - Calling the Bartender's makeCollection method...
172 - done in 0.06 seconds.
173 Creating collection '/tmp': done
174 $ chelonia mkdir /home
175 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
176 - Calling the Bartender's makeCollection method...
177 - done in 0.06 seconds.
178 Creating collection '/home': done
179 Let's move them:
181 $ chelonia mv /home /tmp
183 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
184 - Calling the Bartender's move method...
185 - done in 0.05 seconds.
186 Moving '/home' to '/tmp': targetexists
187 $ chelonia mv /home /tmp/
188 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
189 - Calling the Bartender's move method...
190 - done in 0.07 seconds.
191 Moving '/home' to '/tmp/': moved
192 Let's list them:
194 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
196 $ chelonia ls /
197 - Calling the Bartender's list method...
198 - done in 0.04 seconds.
199 '/': collection
200 tmp <collection>
201 $ chelonia ls /tmp
202 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
203 - Calling the Bartender's list method...
204 - done in 0.04 seconds.
205 '/tmp': collection
206 home <collection>
207 $ chelonia ls /tmp/home
208 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
209 - Calling the Bartender's list method...
210 - done in 0.05 seconds.
211 '/tmp/home': collection
212 empty.
213 $ chelonia ls / /tmp /tmp/home
214 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
215 - Calling the Bartender's list method...
216 - done in 0.08 seconds.
217 '/tmp': collection
218 home <collection>
219 '/': collection
220 tmp <collection>
221 '/tmp/home': collection
222 empty.
223 Let's upload a file:
225 $ cat testfile
227 This is a testfile.
228 $ chelonia put testfile /tmp
229 - The size of the file is 20 bytes
230 - The md5 checksum of the file is 9a9dffa22d227afe0f1959f936993a80
231 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
232 - Calling the Bartender's putFile method...
233 - done in 0.04 seconds.
234 /tmp: LN exists
235 $ chelonia put testfile /tmp/
236 - The size of the file is 20 bytes
237 - The md5 checksum of the file is 9a9dffa22d227afe0f1959f936993a80
238 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
239 - Calling the Bartender's putFile method...
240 - done in 0.08 seconds.
241 - Got transfer URL: http://localhost:60000/httpd/d15900f5-34ee-4bba-bb10-73d60d1c0d75
242 - Uploading from 'testfile' to 'http://localhost:60000/httpd/d15900f5-34ee-4bba-bb10-73d60d1c0d75' with http...
243 Uploading 20 bytes... data sent, waiting... done.
244 - done in 0.0042 seconds.
245 'testfile' (20 bytes) uploaded as '/tmp/testfile'.
246 Let's get some stats:
248 $ chelonia stat /
250 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
251 - Calling the Bartender's stat method...
252 - done in 0.03 seconds.
253 '/': found
254 states
255 closed: 0
256 entry
257 type: collection
258 timestamps
259 created: 1210231805.48
260 entries
261 tmp: 51e12fab-fd3d-43ec-9bc5-17041da3f0b2
262 $ chelonia stat /tmp
263 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
264 - Calling the Bartender's stat method...
265 - done in 0.03 seconds.
266 '/tmp': found
267 states
268 closed: 0
269 timestamps
270 created: 1210231940.04
271 entry
272 type: collection
273 parents
274 0/tmp: parent
275 entries
276 testfile: e635a620-da69-48a3-80d6-b4f68f4aeaa5
277 home: e6f5d1f0-71a8-4ea6-adc4-8b36807e5562
278 $ chelonia stat /tmp/testfile
279 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
280 - Calling the Bartender's stat method...
281 - done in 0.05 seconds.
282 '/tmp/testfile': found
283 states
284 checksumType: md5
285 neededReplicas: 1
286 size: 20
287 checksum: 9a9dffa22d227afe0f1959f936993a80
288 timestamps
289 created: 1210232135.57
290 parents
291 51e12fab-fd3d-43ec-9bc5-17041da3f0b2/testfile: parent
292 locations
293 http://localhost:60000/Shepherd fc0d3d99-6406-4c43-b2eb-c7ec6d6ab7fe: alive
294 entry
295 type: file
296 Let's download the file:
298 $ chelonia get /tmp/testfile newfile
300 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
301 - Calling the Bartender's getFile method...
302 - done in 0.05 seconds.
303 - Got transfer URL: http://localhost:60000/httpd/dab911d0-110f-468e-b0c3-627af6e3af31
304 - Downloading from 'http://localhost:60000/httpd/dab911d0-110f-468e-b0c3-627af6e3af31' to 'newfile' with http...
305 Downloading 20 bytes... done.
306 - done in 0.0035 seconds.
307 '/tmp/testfile' (20 bytes) downloaded as 'newfile'.
308 $ cat newfile
309 This is a testfile.
310 Let's remove everything:
312 $ chelonia unmakeCollection /tmp
314 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
315 - Calling the Bartender's unmakeCollection method...
316 - done in 0.03 seconds.
317 Removing collection '/tmp': collection is not empty
318 $ chelonia unmakeCollection /tmp/home
319 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
320 - Calling the Bartender's unmakeCollection method...
321 - done in 0.06 seconds.
322 Removing collection '/tmp/home': removed
323 $ chelonia del /tmp/testfile
324 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
325 - Calling the Bartender's delFile method...
326 - done in 0.05 seconds.
327 /tmp/testfile: deleted
328 $ chelonia rmdir /tmp
329 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
330 - Calling the Bartender's unmakeCollection method...
331 - done in 0.05 seconds.
332 Removing collection '/tmp': removed
333 $ chelonia ls /
334 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
335 - Calling the Bartender's list method...
336 - done in 0.04 seconds.
337 '/': collection
338 empty.
339 $ chelonia unmakeCollection /
340 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
341 - Calling the Bartender's unmakeCollection method...
342 - done in 0.04 seconds.
343 Removing collection '/': removed
344 $ chelonia list /
345 - ARC_BARTENDER_URL environment variable not found, using http://localhost:60000/Bartender
346 - Calling the Bartender's list method...
347 - done in 0.04 seconds.
348 '/': not found
349
351 Report bugs to http://bugzilla.nordugrid.org/
352
355 APACHE LICENSE Version 2.0
356
359 Zsombor Nagy, zsombor@niif.hu
360NorduGrid ARC 1.1.0 10 July 2008 CHELONIA(1)