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)

Name
       condor_drain Control draining of	an execute machine

Synopsis
       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  ]
       machine-name

Description
       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:

       -graceful

	  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.

       -quick

	   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	.

       -fast

	  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.

Options
       -help

	  Display brief	usage information and exit.

       -debug

	  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-
	  sired.

       -graceful

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

       -quick

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

       -fast

	  Honor	neither	the maximum vacate time	policy nor the retirement time
	  policy.

       -resume-on-completion

	  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

	  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.

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

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

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

home | help