1condor_findhost(1)          General Commands Manual         condor_findhost(1)
2
3
4

Name

6       condor_findhostfind  machine(s) in the pool that can be used with mini‐
7       mal impact on currently running HTCondor jobs and best meet any  speci‐
8       fied constraints
9

Synopsis

11       condor_findhost[-help]  [-m]  [-n num] [-c c_expr] [-r r_expr] [-p cen‐
12       tralmanagerhostname]
13

Description

15       condor_findhostsearches an HTCondor  pool  of  machines  for  the  best
16       machine or machines that will have the minimum impact on running HTCon‐
17       dor jobs if the machine or machines are taken  out  of  the  pool.  The
18       search  may  be  limited to the machine or machines that match a set of
19       constraints and rank expression.
20
21       condor_findhostreturns a fully-qualified domain name for each  machine.
22       The search is limited (constrained) to a specific set of machines using
23       the -coption. The search can use the -roption for rank,  the  criterion
24       used for selecting a machine or machines from the constrained list.
25

Options

27       -help
28
29          Display usage information and exit
30
31
32
33       -m
34
35          Only  search for entire machines. Slots within an entire machine are
36          not considered.
37
38
39
40       -n num
41
42          Find and list up to  nummachines  that  fulfill  the  specification.
43          numis an integer greater than zero.
44
45
46
47       -c c_expr
48
49          Constrain  the search to only consider machines that result from the
50          evaluation of c_expr. c_expris a ClassAd expression.
51
52
53
54       -r r_expr
55
56          r_expris the rank expression evaluated to use as a basis for machine
57          selection. r_expris a ClassAd expression.
58
59
60
61       -p centralmanagerhostname
62
63          Specify the pool to be searched by giving the central manager's host
64          name. Without this option, the current pool is searched.
65
66
67

General Remarks

69       condor_findhostis used to locate a machine within a pool  that  can  be
70       taken out of the pool with the least disturbance of the pool.
71
72       An  administrator  should  set preemption requirements for the HTCondor
73       pool. The expression
74
75       (Interactive =?= TRUE )
76
77       will let condor_findhostknow that it can claim a machine even if HTCon‐
78       dor would not normally preempt a job running on that machine.
79

Exit Status

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

Examples

89       To find and list four machines, preferring those with the highest  mips
90       (on Drystone benchmark) rating:
91
92       condor_findhost -n 4 -r "mips"
93
94       To  find  and list 24 machines, considering only those where the kflop‐
95       sattribute is not defined:
96
97       condor_findhost -n 24 -c "kflops=?=undefined"
98

Author

100       Center for High Throughput Computing, University of Wisconsin-Madison
101

103       Copyright (C) 1990-2019 Center for High Throughput Computing,  Computer
104       Sciences  Department, University of Wisconsin-Madison, Madison, WI. All
105       Rights Reserved. Licensed under the Apache License, Version 2.0.
106
107                                     date                   condor_findhost(1)
Impressum