Name

       condor_findhost  find  -  machine(s)  in  the pool that can be used with minimal impact on
       currently running HTCondor jobs and best meet any specified constraints

Synopsis

       condor_findhost [-help] [-m] [-n num] [-c c_expr] [-r r_expr] [-p centralmanagerhostname]

Description

       condor_findhostsearches an HTCondor pool of machines for the best machine or machines that
       will have the minimum impact on running HTCondor jobs if the machine or machines are taken
       out of the pool. The search may be limited to the machine or machines that match a set  of
       constraints and rank expression.

       condor_findhostreturns  a  fully-qualified  domain  name  for  each machine. The search is
       limited (constrained) to a specific set of machines using the -coption. The search can use
       the  -roption  for  rank,  the criterion used for selecting a machine or machines from the
       constrained list.

Options

       -help

          Display usage information and exit

       -m

          Only search for entire machines. Slots within an entire machine are not considered.

       -n num

          Find and list up to nummachines  that  fulfill  the  specification.  numis  an  integer
          greater than zero.

       -c c_expr

          Constrain  the  search  to  only  consider  machines that result from the evaluation of
          c_expr. c_expris a ClassAd expression.

       -r r_expr

          r_expris the rank expression evaluated  to  use  as  a  basis  for  machine  selection.
          r_expris a ClassAd expression.

       -p centralmanagerhostname

          Specify the pool to be searched by giving the central manager's host name. Without this
          option, the current pool is searched.

General Remarks

       condor_findhostis used to locate a machine within a pool that can be taken out of the pool
       with the least disturbance of the pool.

       An administrator should set preemption requirements for the HTCondor pool. The expression

       (Interactive =?= TRUE )

       will  let  condor_findhostknow  that  it  can  claim  a machine even if HTCondor would not
       normally preempt a job running on that machine.

Exit Status

       The exit status of condor_findhostis zero on success. If not  able  to  identify  as  many
       machines  as  requested,  it  returns one more than the number of machines identified. For
       example, if 8 machines are requested, and condor_findhostonly locates 6, the  exit  status
       will   be   7.  If  not  able  to  locate  any  machines,  or  an  error  is  encountered,
       condor_findhostwill return the value 1.

Examples

       To find and list four machines, preferring  those  with  the  highest  mips  (on  Drystone
       benchmark) rating:

       condor_findhost  -n 4 -r "mips"

       To  find  and  list 24 machines, considering only those where the  kflops attribute is not
       defined:

       condor_findhost  -n 24 -c "kflops=?=undefined"

Author

       Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

       Copyright  (C)  1990-2013  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.

                                           January 2014                        condor_findhost(1)