Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
just-man-pages/condor_vacateGeneral Commandjust-man-pages/condor_vacate_job(1)

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... clus-
       ter.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  job  running under the standard universe will	first produce a	check-
       point 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	begin-
       ning somewhere else.

       If  the	-fast  option  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 -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  con-
       dor_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 op-
	  tional 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_va-
       cate_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 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_job  will	exit with a status value of 0 (zero) upon suc-
       cess, 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-2015 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.

				     date  just-man-pages/condor_vacate_job(1)

Name | Synopsis | Description | Options | General Remarks | Examples | Exit Status | Author | Copyright

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=condor_vacate_job&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help