arcget(1)

1ARCGET(1)                   NorduGrid Users Manual                   ARCGET(1)
2
3
4

NAME

6       arcget - ARC Get
7
8

DESCRIPTION

10       The arcget command is used for retrieving the results from a job.
11
12

SYNOPSIS

14       arcget [options] [job ...]
15
16

OPTIONS

18       -a, --all
19              all jobs
20
21       -j, --joblist=filename
22              the   file   storing  information  about  active  jobs  (default
23              ~/.arc/jobs.xml)
24
25       -i, --jobids-from-file=filename
26              a file containing a list of jobIDs
27
28       -c, --cluster=[-]name
29              explicitly select or reject a specific cluster
30
31       -s, --status=statusstr
32              only select jobs whose status is statusstr
33
34       -D, --dir=dirname
35              download directory (the job directory will be  created  in  this
36              directory)
37
38       -J, --usejobname
39              use  the  jobname  instead  of the short ID as the job directory
40              name
41
42       -k, --keep
43              keep files on the remote cluster (do not clean)
44
45       -f, --force
46              force download (overwrite existing job directory)
47
48       -P, --listplugins
49              list the available plugins
50
51       -t, --timeout=seconds
52              timeout in seconds (default 20)
53
54       -z, --conffile=filename
55              configuration file (default ~/.arc/client.conf)
56
57       -d, --debug=debuglevel
58              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
59
60       -v, --version
61              print version information
62
63       -?, --help
64              print help
65

ARGUMENTS

67       job ...
68              list of jobids and/or jobnames
69

EXTENDED DESCRIPTION

71       The arcget command downloads the results after a job has  completed  on
72       an  grid enabled computing resource. Only the results of jobs that have
73       finished can be downloaded. The job can be referred to  either  by  the
74       jobid  that was returned by arcsub(1) at submission time or by its job‐
75       name if the job description that  was  submitted  contained  a  jobname
76       attribute.
77
78       More  than  one jobid and/or jobname can be given. If several jobs were
79       submitted with the same jobname the results of all those jobs are down‐
80       loaded. If the --joblist option is used the list of jobs is read from a
81       file with the specified filename. By specifying the --all  option,  the
82       results of all active jobs are downloaded.
83
84       The  --cluster  option can be used to select or reject jobs at specific
85       clusters. See arcsub(1) for a discussion of the format of arguments  to
86       this  option.  The --status option can be used to select jobs in a spe‐
87       cific state. These options can be repeated several times.
88
89       For each job that is downloaded a subdirectory will be created  in  the
90       download directory that will contain the downloaded files.
91
92       If  the download was successful the job will be removed from the remote
93       cluster unless the --keep option was specified.
94
95

FILES

97       ~/.arc/client.conf
98              Some options can be given default values by specifying  them  in
99              the  ARC  client  configuration  file.  By  using the --conffile
100              option a different configuration  file  can  be  used  than  the
101              default.
102
103
104       ~/.arc/jobs.xml
105              This  a local list of the user's active jobs. When a job is suc‐
106              cessfully submitted it is added to this  list  and  when  it  is
107              removed  from  the  remote cluster it is removed from this list.
108              This list is used as the list of all active jobs when  the  user
109              specifies  the  --all  option  to the various NorduGrid ARC user
110              interface commands. By using the --joblist  option  a  different
111              file can be used than the default.
112
113

ENVIRONMENT VARIABLES

115       X509_USER_PROXY
116              The  location  of  the  user's grid proxy file. Shouldn't be set
117              unless the proxy is in a non-standard location.
118
119
120       ARC_LOCATION
121              The location where ARC is installed can  be  specified  by  this
122              variable.  If  not specified the install location will be deter‐
123              mined from the path to the command being executed, and  if  this
124              fails a WARNING will be given stating the location which will be
125              used.
126
127
128       ARC_PLUGIN_PATH
129              The location of ARC plugins can be specified by  this  variable.
130              Multiple  locations  can be specified by separating them by : (;
131              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
132              Windows).
133
134

COPYRIGHT

136       APACHE LICENSE Version 2.0
137
138

AUTHOR

140       Mattias Ellert <mattias.ellert@fysast.uu.se>
141
142