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
18       machine or machines that will have the minimum impact on running HTCon‐
19       dor  jobs  if  the  machine  or machines are taken out of the pool. The
20       search may be limited to the machine or machines that match  a  set  of
21       constraints 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
32                 machine 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
61       HTCondor 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
67       requested,  and condor_findhost only locates 6, the exit status will be
68       7. 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-2020,  Center  for  High  Throughput  Computing, Computer Sciences
87       Department, University of Wisconsin-Madison, Madison, WI, US.  Licensed
88       under the Apache License, Version 2.0.
89
90
91
92
938.8                              Aug 06, 2020               CONDOR_FINDHOST(1)
Impressum