1ARCMIGRATE(1) NorduGrid Users Manual ARCMIGRATE(1)
2
6 arcmigrate - ARC Migration
7
10 The arcmigrate command is used for migrating queued jobs from one clus‐
11 ter to another cluster. Currently migration only works between clusters
12 running A-REX.
13
16 arcmigrate [options] [jobid ...]
17
20 -c, --cluster=[-]name
21 explicitly select or reject a specific cluster holding queued
22 jobs
23 -q, --qluster=[-]name
25 explicitly select or reject a specific cluster which queued jobs
26 should/shouldn't be migrated to
27 -g, --index=[-]name
29 explicitly select or reject an index server
30 -j, --joblist=filename
32 the file storing information about active jobs (default
33 ~/.arc/jobs.xml)
34 -i, --jobids-from-file=filename
36 a file containing a list of jobIDs
37 -a, --all
39 all jobs specified in the jobfile will be tried migrated
40 -f, --force
42 force migration, ignore kill failure
43 -P, --listplugins
45 list the available plugins
46 -t, --timeout=seconds
48 timeout in seconds (default 20)
49 -z, --conffile=filename
51 configuration file (default ~/.arc/client.conf)
52 -d, --debug=debuglevel
54 FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
55 -b, --broker=broker
57 selected broker: Random (default), FastestQueue or custom
58 -v, --version
60 print version information
61 -?, --help
63 print help
64
66 jobid ...
67 id of a queued job which should be migrated
68
70 The arcmigrate command is used for migrating jobs which are queuing in
71 the batch system. Currently only jobs having status Queuing can be
72 migrated, and the command is only supported for migration between clus‐
73 ters running A-REX.
74 The --qluster option can be used to force the job to be migrated to a
76 particular cluster, or to reject migration to a particular cluster. The
77 --qluster option can be repeated several times. The name of the cluster
78 should be given in the format
79 [ARC1:][protocol://]hostname[:port]/path
81 Examples:
83 arcmigrate -q example.org:60000/arex ...
85 will migrate the job to example.org.
86 arcmigrate -q -example.org:60000/arex ...
88 will migrate the job to some other cluster than
89 interop.grid.niif.hu.
90 Jobs to be migrated can be specified in serveral ways. Job IDs can be
92 specified as arguments on the command line, clusters holding queued
93 jobs can be specified with the --cluster option, and to migrate all
94 jobs in the jobfile the --all option can be given.
95 If the job(s) is successfully migrated a jobid(s) is printed to stdout.
97 This jobid uniquely identifies the job while it is being executed.
98 Information about active jobs, including the old job id of the migrated
100 job, are stored in a local joblist file. By using the --joblist option
101 a customized location for this file can be defined. If this option is
102 used when migrating a job using arcmigrate, the same joblist file must
103 be specified using the --joblist option for all subsequent handling of
104 the job using arcstat(1), arcget(1), etc.
105 The arcmigrate command locates the available clusters by querying
107 information index servers. Which servers to query can be specified by
108 giving the --index option to the command. The name of the index server
109 should be given in the format
110 Flavor:protocol://hostname[:port]/path
112 Example:
114 arcmigrate -g index1.nordugrid.org ...
116 use the NorduGrid index at index1.nordugrid.org
117 arcmigrate -g -grid.tsl.uu.se ...
119 do not use the Sweden index at grid.tsl.uu.se
120
123 ~/.arc/client.conf
124 Some options can be given default values by specifying them in
125 the ARC client configuration file. By using the --conffile
126 option a different configuration file can be used than the
127 default.
128 ~/.arc/jobs.xml
131 This a local list of the user's active jobs. When a job is suc‐
132 cessfully migrated the old jobid is removed and the new is added
133 to this list. This list is used as the list of all active jobs
134 when the user specifies the --all option to the various Nor‐
135 duGrid ARC user interface commands. By using the --joblist
136 option a different file can be used than the default.
137
140 X509_USER_PROXY
141 The location of the user's grid proxy file. Shouldn't be set
142 unless the proxy is in a non-standard location.
143 ARC_LOCATION
146 The location where ARC is installed can be specified by this
147 variable. If not specified the install location will be deter‐
148 mined from the path to the command being executed, and if this
149 fails a WARNING will be given stating the location which will be
150 used.
151 ARC_PLUGIN_PATH
154 The location of ARC plugins can be specified by this variable.
155 Multiple locations can be specified by separating them by : (;
156 in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
157 Windows).
158
161 APACHE LICENSE Version 2.0
162
165 Mattias Ellert <mattias.ellert@fysast.uu.se>
166
169 arccat(1), arcclean(1), arccp(1), arcget(1), arcinfo(1), arckill(1),
170 arcls(1), arcproxy(1), arcrenew(1), arcresub(1), arcresume(1),
171 arcrm(1), arcstat(1), arcsub(1), arcsync(1), arctest(1)
172NorduGrid ARC 1.1.0 2011-10-24 ARCMIGRATE(1)