Difference between revisions of "Accessing Swestore with the ARC client"

From SNIC Documentation
Jump to: navigation, search
(Swestore documentation moved)
(Tag: New redirect)
 
(40 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Grid computing]]
+
#REDIRECT[[Swestore Documentation Moved]]
[[Category:Storage]]
 
[[Category:SweStore]]
 
[[Category:SweGrid user guide]]
 
[[Getting started with SweGrid|< Getting started with SweGrid]]<br>
 
[[Swestore National Storage|< Swestore National Storage]]
 
 
 
(PAGE UNDER DEVELOPMENT)
 
 
 
= The ARC client =
 
 
 
This guide describes how to use the [http://www.nordugrid.org Nordugrid]
 
''ARC'' client for storing and retrieving files from SweStore National
 
Storage. The ARC client is usually used for sending grid jobs to grid
 
clusters, but it also contain commands for data management.
 
 
 
If your system doesn't have the ARC client installed you can look at
 
the [[ARC_client_installation|ARC client installation]] page in this wiki or the official
 
Nordugrid [http://www.nordugrid.org/documents/arc-client-install.html ARC installation] page for more information. Please note that
 
the windows and MacOS clients are a bit unstable.
 
 
 
A complete user guide for the ARC client can be found in
 
http://www.nordugrid.org/documents/arc-ui.pdf.
 
 
 
== ARC 0.8 versus 1.0 ==
 
 
 
In late spring 2011 Nordugrid release the 1.0 version of ARC
 
(sometimes called 11.05). One of the new features of 1.0 compared to
 
the previous 0.8 release was a new command set. Basically most of the
 
ng* commands was replaced with the new arc* commands. Some
 
functionality moved between commands (ngstat became arcinfo and
 
arcstat) and some new commands was introduced (arcproxy as an
 
replacement for grid-proxy-init, which wasn't an arc command at all
 
but a part of the Globus Toolkit). There are still legacy compat
 
binaries in place for the old ng* commands, but I strongly suggest
 
that you use arc* when available.
 
 
 
= Copying files =
 
 
 
Copying files to and from resources is accomplished using the
 
'''arccp''' command. The command can handle many
 
protocols, such as: ''http, https, httpg, ftp, gsiftp, lfc, rls,
 
srm''. Only the srm protocol is supported when accessing SweStore using the ARC client.
 
 
 
== Copying single files ==
 
 
 
Copying single files is accomplished in the same way as using the normal '''cp''' command as shown in the following example:
 
 
 
[jonas@localhost]$ arccp archive.tar.gz srm://srm.swegrid.se/ops/
 
 
 
== Recursive copying ==
 
 
 
Recursive copying is accomplished using the '''--recursive''' option. The argument to the option determines the depth of the recursive copy.
 
 
 
[jonas@localhost$ arccp --recursive=3 jonas2/ srm://srm.swegrid.se/ops/jonas/jonas2/
 
 
 
= Listing files =
 
 
 
Listing files on a resources is done using the '''arcls''' command. In the simplest form the command just takes a URL as input and displays names and directories without any extra information as shown in the following example:
 
 
 
[jonas@localhost]$ arcls srm://srm.swegrid.se/ops/
 
motd.1
 
bla
 
generated
 
ops
 
motd.f343
 
GridFTP-1.0.20-linux.gtk.x86.zip
 
 
 
Additional information can be listed by adding the '''--long''' option.
 
 
 
[jonas@localhost]$ arcls --long srm://srm.swegrid.se/ops
 
<Name> <Type> <Size> <Creation> <Validity> <CheckSum> <Latency>
 
motd.1 file 354 2008-06-05 12:28:23 (n/a) adler32:582d7718 NEARLINE
 
bla dir 512 2008-08-22 12:23:49 (n/a) (n/a) NEARLINE
 
generated dir 512 2008-11-17 15:07:39 (n/a) (n/a) NEARLINE
 
ops dir 512 2010-01-21 11:26:00 (n/a) (n/a) NEARLINE
 
motd.f343 file 436 2010-01-08 14:35:40 (n/a) adler32:0fed94f2 ONLINE
 
GridFTP-1.0.20-linux.gtk.x86.zip file 30479220 2011-03-09 09:49:20 (n/a) adler32:5c67686b ONLINE
 
 
 
Metadatainformation on a specific file can be listed by specifying the '''-m''' or '''--metadata''' option. In the following example the metadata information of the '''motd.1''' file is shown:
 
 
 
[jonas@localhost]$ arcls --metadata srm://srm.swegrid.se/ops/motd.1
 
/ops/motd.1
 
accessperm:rw-r--r--
 
checksum:adler32:582d7718
 
ctime:2008-06-05 12:28:23
 
filestoragetype:PERMANENT
 
group:25001
 
latency:NEARLINE
 
lifetimeassigned:PT1S
 
lifetimeleft:PT1S
 
mtime:2011-03-24 12:57:42
 
owner:25001
 
path:/ops/motd.1
 
size:354
 
spacetokens:
 
type:file
 
 
 
= Creating directories =
 
 
 
There is no command line tool for creating directories. This command will probably be added in a upcoming release. All required directories are created when needed. In the meantime the following procedure can be used:
 
 
 
[jonas@localhost]$ mkdir mydir
 
[jonas@localhost]$ touch mydir/dummyfile
 
[jonas@localhost]$ arccp ./mydir/ srm://srm.swegrid.se/ops/mydir/
 
[jonas@localhost]$ arcls srm://srm.swegrid.se/ops/mydir
 
dummyfile
 
 
 
The dummmy file can be removed using the arcrm command described in the following section.
 
 
 
= Removing files or directories =
 
 
 
[jonas@localhost]$ arcrm srm://srm.swegrid.se/ops/mydir/dummyfile
 
[jonas@localhost]$ arcrm srm://srm.swegrid.se/ops/mydir
 
 
 
To remove directories they have to be empty.
 

Latest revision as of 09:55, 8 February 2023