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

FreeBSD Manual Pages


home | help
just-man-pages/condor_drain(General Commands Manjust-man-pages/condor_drain(1)

       condor_drain Control draining of	an execute machine

       condor_drain [ -help ]

       condor_drain  [	-debug	]  [  -pool pool-name ]	[ -graceful | -quick |
       -fast ] [ -resume-on-completion ] [ -check expr ] machine-name

       condor_drain [ -debug ] [ -pool pool-name ] -cancel [ -request-id id  ]

       condor_drain  is	an administrative command used to control the draining
       of all slots on an execute machine. When	a machine is draining, it will
       not accept any new jobs.	Which machine to drain is specified by the ar-
       gument machine-name , and will be the same as the machine  ClassAd  at-
       tribute	Machine	.

       How currently running jobs are treated depends on the draining schedule
       that is chosen with a command-line option:


	  Initiate a graceful eviction of the job.  This  means	 all  promises
	  that have been made to the job are honored, including	 MaxJobRetire-
	  mentTime . The eviction of jobs is coordinated to reduce idle	 time.
	  This	means  that  if	one slot has a job with	a long retirement time
	  and the other	slots have jobs	with shorter retirement	times, the ef-
	  fective retirement time for all of the jobs is the longer one. If no
	  draining schedule is specified, -graceful is chosen by default.


	   MaxJobRetirementTime	is not honored.	Eviction of  jobs  is  immedi-
	  ately	initiated. Jobs	are given time to shut down and	produce	check-
	  points, according to the usual policy, that is, given	 by   Machine-
	  MaxVacateTime	.


	  Jobs	are immediately	hard-killed, with no chance to gracefully shut
	  down or produce a checkpoint.

       Once draining is	complete, the  machine	will  enter  the  Drained/Idle
       state.  To  resume  normal  operation (negotiation) at that time	or any
       previous	time during draining, the -cancel option may be	used. The -re-
       sume-on-completion option results in automatic resumption of normal op-
       eration once draining has completed, and	may be	used  when  initiating
       draining.  This	is  useful  for	forcing	a machine with a partitionable
       slots to	join all of the	resources back together	into one machine,  fa-
       cilitating de-fragmentation and whole machine negotiation.


	  Display brief	usage information and exit.


	  Causes  debugging  information  to be	sent to	 stderr	, based	on the
	  value	of the configuration variable  TOOL_DEBUG

       -pool pool-name

	  Specify an alternate HTCondor	pool, if the default one  is  not  de-


	  (the default)	Honor the maximum vacate and retirement	time policy.


	  Honor	the maximum vacate time, but not the retirement	time policy.


	  Honor	neither	the maximum vacate time	policy nor the retirement time


	  When done draining, resume normal operation, such  that  potentially
	  the whole machine could be claimed.

       -check expr

	  Abort	draining, if  expr is not true for all slots to	be drained.


	  Cancel  a prior draining request, to permit the condor_negotiator to
	  use the machine again.

       -request-id id

	  Specify a specific draining request to cancel, where id is given  by
	  the  DrainingRequestId machine ClassAd attribute.

Exit Status
       condor_drain  will  exit	 with  a non-zero status value if it fails and
       zero status if it succeeds.

       Center for High Throughput Computing, University	of Wisconsin-Madison

       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_drain(1)

Name | Synopsis | Description | Options | Exit Status | Author | Copyright

Want to link to this manual page? Use this URL:

home | help