NAME

       condor_findhost - HTCondor Manual

       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_findhost  searches  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_findhost returns a fully-qualified domain name for  each  machine.  The  search  is
       limited  (constrained)  to  a specific set of machines using the -c option. The search can
       use the -r option 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 num machines that fulfill  the  specification.   num  is  an
                 integer greater than zero.

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

          -r r_expr
                 r_expr is the rank expression evaluated to use as a basis for machine selection.
                 r_expr is 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_findhost is 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_findhost  know  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_findhost is 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_findhost only locates 6, the exit  status
       will be 7. If not able to locate any machines, or an error is encountered, condor_findhost
       will 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

       HTCondor Team

COPYRIGHT

       1990-2024, Center for High Throughput Computing, Computer Sciences Department,  University
       of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                           Apr 14, 2024                        CONDOR_FINDHOST(1)