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