1CONDOR_FINDHOST(1)              HTCondor Manual             CONDOR_FINDHOST(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

17       condor_findhost  searches an HTCondor pool of machines for the best ma‐
18       chine or machines that will have the minimum impact on running HTCondor
19       jobs  if  the machine or machines are taken out of the pool. The search
20       may be limited to the machine or machines that  match  a  set  of  con‐
21       straints and rank expression.
22
23       condor_findhost returns a fully-qualified domain name for each machine.
24       The search is limited (constrained) to a specific set of machines using
25       the -c option. The search can use the -r option for rank, the criterion
26       used for selecting a machine or machines from the constrained list.
27

OPTIONS

29          -help  Display usage information and exit
30
31          -m     Only search for entire machines. Slots within an  entire  ma‐
32                 chine are not considered.
33
34          -n num Find  and list up to num machines that fulfill the specifica‐
35                 tion.  num is an integer greater than zero.
36
37          -c c_expr
38                 Constrain the search to only consider  machines  that  result
39                 from  the  evaluation  of c_expr. c_expr is a ClassAd expres‐
40                 sion.
41
42          -r r_expr
43                 r_expr is the rank expression evaluated to use as a basis for
44                 machine selection. r_expr is a ClassAd expression.
45
46          -p centralmanagerhostname
47                 Specify  the  pool  to be searched by giving the central man‐
48                 ager's host name. Without this option, the  current  pool  is
49                 searched.
50

GENERAL REMARKS

52       condor_findhost  is  used to locate a machine within a pool that can be
53       taken out of the pool with the least disturbance of the pool.
54
55       An administrator should set preemption requirements  for  the  HTCondor
56       pool. The expression
57
58          (Interactive =?= TRUE )
59
60       will  let  condor_findhost know that it can claim a machine even if HT‐
61       Condor would not normally preempt a job running on that machine.
62

EXIT STATUS

64       The exit status of condor_findhost is zero on success. If not  able  to
65       identify  as  many  machines as requested, it returns one more than the
66       number of machines identified. For  example,  if  8  machines  are  re‐
67       quested, and condor_findhost only locates 6, the exit status will be 7.
68       If not able to locate any machines, or an error  is  encountered,  con‐
69       dor_findhost will return the value 1.
70

EXAMPLES

72       To  find and list four machines, preferring those with the highest mips
73       (on Drystone benchmark) rating:
74
75          $ condor_findhost -n 4 -r "mips"
76
77       To find and list 24 machines, considering only those where  the  kflops
78       attribute is not defined:
79
80          $ condor_findhost -n 24 -c "kflops=?=undefined"
81

AUTHOR

83       HTCondor Team
84

86       1990-2023,  Center for High Throughput Computing, Computer Sciences De‐
87       partment, University of Wisconsin-Madison, Madison,  WI,  US.  Licensed
88       under the Apache License, Version 2.0.
89
90
91
92
93                                 Oct 02, 2023               CONDOR_FINDHOST(1)
Impressum