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 SoftKillSigin 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_USERSmacro) 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

General Remarks

       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 © 1990-2016 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.

                                                  January 2020                              condor_vacate_job(1)