CONDOR_VACATE_JOB(1)

NAME
condor_vacate_job - HTCondor Manual

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_job finds 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 running job running 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 -fast option is used, the job(s) will be immediately killed.

If the -name option is specified, the named condor_schedd is targeted for processing. If the -addr option is used, the condor_schedd at the given address is targeted for processing. Otherwise, the local condor_schedd is 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_job on 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_job with condor_vacate. condor_vacate is 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_vacate to evict jobs from a given host. condor_vacate_job is 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 vanilla universe jobs owned by Mary:

            $ condor_vacate_job -constraint 'JobUniverse == 5 && 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_job will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.

AUTHOR
HTCondor Team

COPYRIGHT
1990-2024, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.