Control draining of an execute machine
condor_drain [-debug] [-pool pool-name] [-graceful | -quick | -fast] [-resume-on-completion] [-check expr] [-start expr] machine-name
condor_drain [-debug] [-pool pool-name] -cancel [-request-id id] machine-name
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 unless the -start expression specifies otherwise. Which machine to drain is specified by the argument machine-name, and will be the same as the machine ClassAd attribute Machine.
How currently running jobs are treated depends on the draining schedule that is chosen with a command-line option:
If you specify -graceful, you may also specify -start. On a gracefully-draining machine, some jobs may finish retiring before others. By default, the resources used by the newly-retired jobs do not become available for use by other jobs until the machine exits the draining state (see below). The -start expression you supply replaces the draining machine’s normal START expression for the duration of the draining state, potentially making those resources available. See section 3.7.1 for more information.
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 -resume-on-completion option results in automatic resumption of normal operation 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, facilitating de-fragmentation and whole machine negotiation.
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 © 1990-2018 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.
⇐ ↙ ↑ ⇑ ⇒ Contents Index