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

NAME

6       arcsync - ARC Synchronize
7
8

DESCRIPTION

10       The arcsync command synchronizes your local jobs list with the informa‐
11       tion at a given cluster or index server.
12
13

SYNOPSIS

15       arcsync [options]
16
17

OPTIONS

19       -c, --cluster=name
20              select one or more computing elements: name can be an alias  for
21              a single CE, a group of CEs or a URL
22
23       -g, --index=name
24              select one or more registries: name can be an alias for a single
25              registry, a group of registries or a URL
26
27       -j, --joblist=filename
28              the  file  storing  information  about  active   jobs   (default
29              ~/.arc/jobs.xml)
30
31       -f, --force
32              don't ask for verification
33
34       -T, --truncate
35              shrinks the joblist before synchronizing
36
37       -C, --convert
38              instead  of  pulling  jobs  information from server read it from
39              jobs storage and write it back. This option is mostly  for  con‐
40              verting format of jobs storage file.
41
42       -P, --listplugins
43              list the available plugins
44
45       -t, --timeout=seconds
46              timeout in seconds (default 20)
47
48       -z, --conffile=filename
49              configuration file (default ~/.arc/client.conf)
50
51       -d, --debug=debuglevel
52              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
53
54       -v, --version
55              print version information
56
57       -?, --help
58              print help
59

EXTENDED DESCRIPTION

61       The  ARC  user interface keeps a local list of active jobs in the users
62       home directory (see arcsub(1)). If this file is lost, or the user wants
63       to recreate the file on a different computer,the arcsync command can be
64       used to recreate the file from the information available the  specified
65       cluster or index server.
66
67       Since  the  information  about  a  job  retrieved from a cluster can be
68       slightly out of date if the user very recently submitted or  removed  a
69       job  a  warning  is issued when this command is run. The --force option
70       disables this warning.
71
72       The --cluster options can be used to select  or  reject  clusters  that
73       should  be  considered  in the synchronization. This options can be re‐
74       peated several times.  See arcsub(1) for a discussion of the format  of
75       arguments to this option.
76
77       If  the joblist is not empty when invoking synchronization the old jobs
78       will be merged with the new  jobs,  unless  the  --truncate  option  is
79       given,  in which case the joblist will first be cleaned of old jobs and
80       then the new jobs will be added.
81
82

FILES

84       ~/.arc/client.conf
85              Some options can be given default values by specifying  them  in
86              the  ARC  client configuration file. By using the --conffile op‐
87              tion a different configuration file can be  used  than  the  de‐
88              fault.
89
90
91       ~/.arc/jobs.xml
92              This  is  a  local list of the user's active jobs. When a job is
93              successfully submitted it is added to this list and when  it  is
94              removed  from  the  remote cluster it is removed from this list.
95              This list is used as the list of all active jobs when  the  user
96              specifies the --all option to the various NorduGrid ARC user in‐
97              terface commands. By using the --joblist option a different file
98              can be used than the default.
99
100

ENVIRONMENT VARIABLES

102       X509_USER_PROXY
103              The location of the user's Grid proxy file. Shouldn't be set un‐
104              less the proxy is in a non-standard location.
105
106
107       ARC_LOCATION
108              The location where ARC is installed can  be  specified  by  this
109              variable.  If  not specified the install location will be deter‐
110              mined from the path to the command being executed, and  if  this
111              fails a WARNING will be given stating the location which will be
112              used.
113
114
115       ARC_PLUGIN_PATH
116              The location of ARC plugins can be specified by  this  variable.
117              Multiple  locations  can be specified by separating them by : (;
118              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
119              Windows).
120
121
123       APACHE LICENSE Version 2.0
124
125

AUTHOR

127       ARC    software   is   developed   by   the   NorduGrid   Collaboration
128       (http://www.nordugrid.org), please consult the AUTHORS file distributed
129       with    ARC.    Please    report   bugs   and   feature   requests   to
130       http://bugzilla.nordugrid.org
131
132

SEE ALSO

134       arccat(1), arcclean(1), arccp(1),  arcget(1),  arcinfo(1),  arckill(1),
135       arcls(1),  arcmkdir(1),  arcproxy(1),  arcrenew(1), arcresub(1), arcre‐
136       sume(1), arcrm(1), arcstat(1), arcsub(1), arctest(1)
137
138
139
140
141NorduGrid ARC 6.18.0              2023-10-25                        ARCSYNC(1)
Impressum