Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

condor_drain(1) [debian man page]

condor_drain(1) 					      General Commands Manual						   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_drainis  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 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:

       -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 effective retirement time for all of the jobs is the longer one. If no
	  draining schedule is specified, -gracefulis chosen by default.

       -quick

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

       -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 pre-
       vious time during draining, the -canceloption may be used. The -resume-on-completionoption results in automatic resumption of normal opera-
       tion 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.

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 Condor pool, if the default one is not desired.

       -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_negotiatorto use the machine again.

       -request-id id

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

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

Author
       Condor Team, University of Wisconsin-Madison

Copyright
       Copyright (C) 1990-2012 Condor Team, Computer Sciences Department, University of  Wisconsin-Madison,  Madison,  WI.  All  Rights  Reserved.
       Licensed under the Apache License, Version 2.0.

       See the Condor Version 7.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu

								  September 2012						   condor_drain(1)

Check Out this Related Man Page

condor_off(1)						      General Commands Manual						     condor_off(1)

Name
       condor_off Shutdown - Condor daemons

Synopsis
       condor_off [-help -version]

       condor_off[-graceful    -fast	-peaceful]    [-debug]	  [-pool    centralmanagerhostname[:portnumber]]    [-name   hostnamehostname-addr
       "<a.b.c.d:port>""<a.b.c.d:port>"-constraint expression-all] [-daemon daemonname]

Description
       condor_offshuts down a set of the Condor daemons running on a set of one or more machines. It does this cleanly so that checkpointable jobs
       may gracefully exit with minimal loss of work.

       The  command  condor_offwithout	any arguments will shut down all daemons except condor_master. The condor_mastercan then handle both local
       and remote requests to restart the other Condor daemons if need be. To restart Condor running on a machine, see the condor_oncommand.

       With the -daemon masteroption, condor_offwill shut down all daemons including the condor_master. Specification using the -daemonoption will
       shut down only the specified daemon.

       For  security  purposes	(authentication  and authorization), this command requires an administrator's level of access. See section 3.6.1on
       page for further explanation.

Options
       -help

	  Display usage information

       -version

	  Display version information

       -graceful

	  Gracefully shutdown daemons (the default)

       -fast

	  Quickly shutdown daemons

       -peaceful

	  Wait indefinitely for jobs to finish

       -debug

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

       -pool centralmanagerhostname[:portnumber]

	  Specify a pool by giving the central manager's host name and an optional port number

       -name hostname

	  Send the command to a machine identified by hostname

       hostname

	  Send the command to a machine identified by hostname

       -addr <a.b.c.d:port>

	  Send the command to a machine's master located at "<a.b.c.d:port>"

       <a.b.c.d:port>

	  Send the command to a machine located at "<a.b.c.d:port>"

       -constraint expression

	  Apply this command only to machines matching the given ClassAd expression

       -all

	  Send the command to all machines in the pool

       -daemon daemonname

	  Send the command to the named daemon. Without this option, the command is sent to the condor_masterdaemon.

Exit Status
       condor_off will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.

Examples
       To shut down all daemons (other than condor_master) on the local host:

       % condor_off

       To shut down only the condor_collectoron three named machines:

       % condor_off   cinnamon cloves vanilla -daemon collector

       To shut down daemons within a pool of machines other than the local pool, use the -pooloption. The argument is the name of the central man-
       ager for the pool. Note that one or more machines within the pool must be specified as the targets for the command. This command shuts down
       all daemons except the condor_masteron the single machine named cae17within the pool of machines that has condor.cae.wisc.eduas its central
       manager:

       % condor_off   -pool condor.cae.wisc.edu -name cae17

Author
       Condor Team, University of Wisconsin-Madison

Copyright
       Copyright  (C)  1990-2012  Condor  Team,  Computer  Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
       Licensed under the Apache License, Version 2.0.

       See the Condor Version 7.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu

								  September 2012						     condor_off(1)
Man Page