Name¶
condor_vacate_job vacate - jobs in the HTCondor queue from the hosts where they
are running
Synopsis¶
condor_vacate_job [-help -version]
condor_vacate_job[-pool centralmanagerhostname[:portnumber]-name
scheddname][-addr "<a.b.c.d:port>"] [-fast] cluster...
cluster.process... user... -constraint expression...
condor_vacate_job[-pool centralmanagerhostname[:portnumber]-name
scheddname][-addr "<a.b.c.d:port>"] [-fast] -all
Description¶
condor_vacate_jobfinds one or more jobs from the HTCondor job queue and vacates
them from the host(s) where they are currently running. The jobs remain in the
job queue and return to the idle state.
A job running under the standard universe will first produce a checkpoint and
then the job will be killed. HTCondor will then restart the job somewhere
else, using the checkpoint to continue from where it left off. A job running
under any other universe will be sent a soft kill signal (SIGTERM by default,
or whatever is defined as the SoftKillSig in the job ClassAd), and HTCondor
will restart the job from the beginning somewhere else.
If the -fastoption is used, the job(s) will be immediately killed, meaning that
standard universe jobs will not be allowed to checkpoint, and the job will
have to revert to the last checkpoint or start over from the beginning.
If the -nameoption is specified, the named condor_scheddis targeted for
processing. If the -addroption is used, the condor_scheddat the given address
is targeted for processing. Otherwise, the local condor_scheddis targeted. The
jobs to be vacated are identified by one or more job identifiers, as described
below. For any given job, only the owner of the job or one of the queue super
users (defined by the QUEUE_SUPER_USERS macro) can vacate the job.
Using condor_vacate_jobon jobs which are not currently running has no effect.
Options¶
-help
-
- Display usage information
-
-version
-
- Display version information
-
-pool centralmanagerhostname[:portnumber]
-
- Specify a pool by giving the central manager's host name and an optional
port number
-
-name scheddname
-
- Send the command to a machine identified by scheddname
-
-addr <a.b.c.d:port>
-
- Send the command to a machine located at
"<a.b.c.d:port>"
-
cluster
-
- Vacate all jobs in the specified cluster
-
cluster.process
-
- Vacate the specific job in the cluster
-
user
-
- Vacate jobs belonging to specified user
-
-constraint expression
-
- Vacate all jobs which match the job ClassAd expression constraint
-
-all
-
- Vacate all the jobs in the queue
-
-fast
-
- Perform a fast vacate and hard kill the jobs
-
Do not confuse condor_vacate_jobwith condor_vacate. condor_vacateis given a list
of hosts to vacate, regardless of what jobs happen to be running on them. Only
machine owners and administrators have permission to use condor_vacateto evict
jobs from a given host. condor_vacate_jobis given a list of job to vacate,
regardless of which hosts they happen to be running on. Only the owner of the
jobs or queue super users have permission to use condor_vacate_job.
Examples¶
To vacate job 23.0:
% condor_vacate_job 23.0
To vacate all jobs of a user named Mary:
% condor_vacate_job mary
To vacate all standard universe jobs owned by Mary:
% condor_vacate_job -constraint 'JobUniverse == 1 && Owner ==
"mary"'
Note that the entire constraint, including the quotation marks, must be enclosed
in single quote marks for most shells.
Exit Status¶
condor_vacate_jobwill exit with a status value of 0 (zero) upon success, and it
will exit with the value 1 (one) upon failure.
Author¶
Center for High Throughput Computing, University of Wisconsin-Madison
Copyright¶
Copyright (C) 1990-2014 Center for High Throughput Computing, Computer Sciences
Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
Licensed under the Apache License, Version 2.0.