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

Name

6       condor_statusDisplay status of the HTCondor pool
7

Synopsis

9       condor_status[-debug]  [help options] [query options] [display options]
10       [custom options] [name ...]
11

Description

13       condor_statusis a versatile tool that may be used to monitor and  query
14       the  HTCondor pool. The condor_statustool can be used to query resource
15       information, submitter information, checkpoint server information,  and
16       daemon  master  information.  The specific query sent and the resulting
17       information display  is  controlled  by  the  query  options  supplied.
18       Queries and display formats can also be customized.
19
20       The options that may be supplied to condor_statusbelong to five groups:
21
22          * Help optionsprovide information about the condor_statustool.
23
24          * Query optionscontrol the content and presentation of status infor‐
25          mation.
26
27          * Display optionscontrol the display of the queried information.
28
29          * Custom optionsallow the user to customize query and display infor‐
30          mation.
31
32          * Host optionsspecify specific machines to be queried
33
34       At  any  time,  only  one  help option, one query optionand one display
35       optionmay be specified. Any number of custom optionsand host optionsmay
36       be specified.
37

Options

39       -debug
40
41          Causes  debugging  information  to  be  sent to stderr, based on the
42          value of the configuration variable TOOL_DEBUG.
43
44
45
46       -help
47
48          (Help option) Display usage information.
49
50
51
52       -diagnose
53
54          (Help option) Print out ClassAd query without performing the query.
55
56
57
58       -absent
59
60          (Query option) Query for and display only absent resources.
61
62
63
64       -ads filename
65
66          (Query option) Read the set of ClassAds in  the  file  specified  by
67          filename, instead of querying the condor_collector.
68
69
70
71       -annex name
72
73          (Query  option)  Query  for  and display only resources in the named
74          annex.
75
76
77
78       -any
79
80          (Query option) Query all ClassAds and  display  their  type,  target
81          type, and name.
82
83
84
85       -avail
86
87          (Query  option)  Query  condor_startdClassAds and identify resources
88          which are available.
89
90
91
92       -ckptsrvr
93
94          (Query option) Query condor_ckpt_serverClassAds and  display  check‐
95          point server attributes.
96
97
98
99       -claimed
100
101          (Query  option)  Query  condor_startdClassAds  and print information
102          about claimed resources.
103
104
105
106       -cod
107
108          (Query option) Display only machine ClassAds that have  COD  claims.
109          Information displayed includes the claim ID, the owner of the claim,
110          and the state of the COD claim.
111
112
113
114       -collector
115
116          (Query   option)   Query   condor_collectorClassAds   and    display
117          attributes.
118
119
120
121       -defrag
122
123          (Query option) Query condor_defragClassAds.
124
125
126
127       -direct hostname
128
129          (Query  option)  Go directly to the given host name to get the Clas‐
130          sAds to display. By default, returns  the  condor_startdClassAd.  If
131          -scheddis also given, return the condor_scheddClassAd on that host.
132
133
134
135       -java
136
137          (Query option) Display only Java-capable resources.
138
139
140
141       -license
142
143          (Query option) Display license attributes.
144
145
146
147       -master
148
149          (Query option) Query condor_masterClassAds and display daemon master
150          attributes.
151
152
153
154       -negotiator
155
156          (Query   option)   Query   condor_negotiatorClassAds   and   display
157          attributes.
158
159
160
161       -pool centralmanagerhostname[:portnumber]
162
163          (Query option) Query the specified central manager using an optional
164          port number. condor_statusqueries the machine specified by the  con‐
165          figuration variable COLLECTOR_HOSTby default.
166
167
168
169       -run
170
171          (Query  option) Display information about machines currently running
172          jobs.
173
174
175
176       -schedd
177
178          (Query option) Query condor_scheddClassAds and display attributes.
179
180
181
182       -server
183
184          (Query option)  Query  condor_startdClassAds  and  display  resource
185          attributes.
186
187
188
189       -startd
190
191          (Query option) Query condor_startdClassAds.
192
193
194
195       -state
196
197          (Query  option)  Query  condor_startdClassAds  and  display resource
198          state information.
199
200
201
202       -statistics WhichStatistics
203
204          (Query option) Can only be used if the -directoption has been speci‐
205          fied. Identifies which Statistics attributes to include in the Clas‐
206          sAd. WhichStatisticsis specified using the same  syntax  as  defined
207          for  STATISTICS_TO_PUBLISH. A definition is in the HTCondor Adminis‐
208          trator's manual section on configuration (section ).
209
210
211
212       -storage
213
214          (Query option) Display attributes of machines with  network  storage
215          resources.
216
217
218
219       -submitters
220
221          (Query  option) Query ClassAds sent by submitters and display impor‐
222          tant submitter attributes.
223
224
225
226       -subsystem type
227
228          (Query option) If  typeis  one  of  collector,  negotiator,  master,
229          schedd,  or  startd,  then  behavior is the same as the query option
230          without the -subsystemoption. For  example,  -subsystem  collectoris
231          the  same as -collector. A value of typeof CkptServer, Machine, Dae‐
232          monMaster, or Schedulertargets that type of ClassAd.
233
234
235
236       -vm
237
238          (Query option) Query condor_startdClassAds,  and  display  only  VM-
239          enabled  machines.  Information displayed includes the machine name,
240          the virtual machine software version, the state of machine, the vir‐
241          tual machine memory, and the type of networking.
242
243
244
245       -offline
246
247          (Query  option)  Query  condor_startdClassAds, and display, for each
248          machine with at least one offline universe, which universes are off‐
249          line for it.
250
251
252
253       -attributes Attr1[,Attr2 ...]
254
255          (Display option) Explicitly list the attributes in a comma separated
256          list which should be displayed when using the -xml, -jsonor -longop‐
257          tions. Limiting the number of attributes increases the efficiency of
258          the query.
259
260
261
262       -expert
263
264          (Display option) Display shortened error messages.
265
266
267
268       -long
269
270          (Display option) Display entire ClassAds. Implies that  totals  will
271          not be displayed.
272
273
274
275       -limitnum
276
277          (Query option) At most numresults should be displayed.
278
279
280
281       -sort expr
282
283          (Display  option)  Change the display order to be based on ascending
284          values of an evaluated expression given by expr.  Evaluated  expres‐
285          sions of a string type are in a case insensitive alphabetical order.
286          If multiple -sortarguments appear on the command line,  the  primary
287          sort  will be on the leftmost one within the command line, and it is
288          numbered 0. A secondary sort will be based on the second expression,
289          and  it  is numbered 1. For informational or debugging purposes, the
290          ClassAd output to be displayed will appear as if the ClassAd had two
291          additional  attributes. CondorStatusSortKeyExpr<N>is the expression,
292          where <N>is replaced  by  the  number  of  the  sort.  CondorStatus‐
293          SortKey<N>gives the result of evaluating the sort expression that is
294          numbered <N>.
295
296
297
298       -total
299
300          (Display option) Display totals only.
301
302
303
304       -xml
305
306          (Display option) Display entire ClassAds, in  XML  format.  The  XML
307          format  is  fully defined in the reference manual, obtained from the
308          ClassAds web page, with a link at  http://htcondor.org/classad/clas
309          sad.html.
310
311
312
313       -json
314
315          (Display option) Display entire ClassAds in JSON format.
316
317
318
319       -constraint const
320
321          (Custom option) Add constraint expression.
322
323
324
325       -compact
326
327          (Custom  option)  Show  compact form, rolling up slots into a single
328          line.
329
330
331
332       -format fmt attr
333
334          (Custom option) Display attribute or expression attrin  format  fmt.
335          To  display  the  attribute  or expression the format must contain a
336          single printf(3)-style conversion specifier. Attributes must be from
337          the  resource  ClassAd.  Expressions are ClassAd expressions and may
338          refer to attributes in the resource ClassAd. If the attribute is not
339          present  in  a  given ClassAd and cannot be parsed as an expression,
340          then the format option will  be  silently  skipped.  %r  prints  the
341          unevaluated,  or raw values. The conversion specifier must match the
342          type of the attribute or expression. %s is suitable for strings such
343          as  Name, %d for integers such as LastHeardFrom, and %f for floating
344          point numbers such  as  LoadAvg.  %v  identifies  the  type  of  the
345          attribute,  and  then  prints the value in an appropriate format. %V
346          identifies the type of the attribute, and then prints the  value  in
347          an  appropriate  format as it would appear in the -longformat. As an
348          example, strings used with %V will have quote  marks.  An  incorrect
349          format  will  result in undefined behavior. Do not use more than one
350          conversion specifier in a given format.  More  than  one  conversion
351          specifier  will  result  in  undefined  behavior. To output multiple
352          attributes repeat the -formatoption once for each desired attribute.
353          Like  printf(3)-style  formats, one may include other text that will
354          be reproduced directly. A format without any  conversion  specifiers
355          may  be  specified,  but  an  attribute is still required. Include a
356          backslash followed by an `n' to specify a line break.
357
358
359
360
361
362       -autoformat[:lhVr,tng] attr1 [attr2 ...]or -af[:lhVr,tng] attr1  [attr2
363       ...]
364
365          (Output option) Display attribute(s) or expression(s) formatted in a
366          default way according to attribute types. This option takes an arbi‐
367          trary  number  of attribute names as arguments, and prints out their
368          values, with a space between each  value  and  a  newline  character
369          after  the  last  value. It is like the -formatoption without format
370          strings. This output option does notwork  in  conjunction  with  the
371          -runoption.
372
373          It  is  assumed that no attribute names begin with a dash character,
374          so that the next word that begins with dash is the start of the next
375          option.  The  autoformatoption  may be followed by a colon character
376          and formatting qualifiers to deviate the output formatting from  the
377          default:
378
379          llabel each field,
380
381          hprint column headings before the first line of output,
382
383          Vuse %V rather than %v for formatting (string values are quoted),
384
385          rprint "raw", or unevaluated values,
386
387          ,add a comma character after each field,
388
389          tadd  a tab character before each field instead of the default space
390          character,
391
392          nadd a newline character after each field,
393
394          gadd a newline  character  between  ClassAds,  and  suppress  spaces
395          before each field.
396
397          Use -af:hto get tabular values with headings.
398
399          Use -af:lrngto get -long equivalent format.
400
401          The  newline  and comma characters may notbe used together. The land
402          hcharacters may notbe used together.
403
404
405
406       -target filename
407
408          (Custom option) Where evaluation requires a target ClassAd to evalu‐
409          ate against, file filenamecontains the target ClassAd.
410
411
412
413       -merge filename
414
415          (Custom  option)  Ads  will  be read from filename, which may be -to
416          indicate standard in, and compared to the ads selected by the  query
417          specified  by the remainder of the command line. Ads will be consid‐
418          ered the same if their sort keys match; sort keys may  be  specified
419          with  [-sort  <key>].  This  option will cause up to three tables to
420          print, in the  following  order,  depending  on  where  a  given  ad
421          appeared:  first,  the  ads  which  appeared in the query but not in
422          filename; second, the ads which appeared in both the  query  and  in
423          filename;  third,  the  ads which appeared in filenamebut not in the
424          query.
425
426          By default, banners will label each table. If -xmlis also given, the
427          same  banners  will separate three valid XML documents, one for each
428          table. If -jsonis also given, a single JSON object will be produced,
429          with  the  usual JSON output for each table labeled as an element in
430          the object.
431
432          The -annexoption changes this default so that the  banners  are  not
433          printed  and the tables are formatted differently. In this case, the
434          ads in filenameare expected to have different contents from the  ads
435          in the query, so many others will behave strangely.
436
437
438

General Remarks

440          *  The  default  output  from  condor_statusis formatted to be human
441          readable, not script readable. In an effort to make the  output  fit
442          within 80 characters, values in some fields might be truncated. Fur‐
443          thermore, the HTCondor Project can (and does) change the  formatting
444          of  this default output as we see fit. Therefore, any script that is
445          attempting to parse data from condor_statusis strongly encouraged to
446          use the -formatoption (described above).
447
448
449
450          *  The  information obtained from condor_startdand condor_schedddae‐
451          mons may sometimes appear to be inconsistent. This is  normal  since
452          condor_startdand condor_schedddaemons update the HTCondor manager at
453          different rates, and since there is a delay  as  information  propa‐
454          gates through the network and the system.
455
456
457
458          *  Note  that  the  ActivityTimein the Idlestate is notthe amount of
459          time that the machine  has  been  idle.  See  the  section  on  con‐
460          dor_startdstates  in  the Administrator's Manualfor more information
461          (section ).
462
463
464
465          * When using condor_statuson a  pool  with  SMP  machines,  you  can
466          either provide the host name, in which case you will get back infor‐
467          mation about all slots that are represented on that host, or you can
468          list specific slots by name. See the examples below for details.
469
470
471
472          * If you specify host names, without domains, HTCondor will automat‐
473          ically try to resolve those host names  into  fully  qualified  host
474          names  for you. This also works when specifying specific nodes of an
475          SMP machine. In this case, everything after the &ldquo;@&rdquo; sign
476          is treated as a host name and that is what is resolved.
477
478
479
480          * You can use the -directoption in conjunction with almost any other
481          set of options. However, at this time, the  only  daemon  that  will
482          allow  direct  queries  for  its ad(s) is the condor_startd. So, the
483          only options currently  not  supported  with  -directare  -scheddand
484          -master. Most other options use startd ads for their information, so
485          they work seamlessly with -direct. The  only  other  restriction  on
486          -directis  that  you  may only use 1 -directoption at a time. If you
487          want to query information directly from multiple hosts, you must run
488          condor_statusmultiple times.
489
490
491
492          * Unless you use the local host name with -direct, condor_statuswill
493          still have to contact a collector to  find  the  address  where  the
494          specified  daemon  is listening. So, using a -pooloption in conjunc‐
495          tion with -directjust tells condor_statuswhich collector to query to
496          find  the  address  of the daemon you want. The information actually
497          displayed will still be retrieved directly from the daemon you spec‐
498          ified as the argument to -direct.
499
500
501

Examples

503       Example 1To view information from all nodes of an SMP machine, use only
504       the host name. For example, if you had  a  4-CPU  machine,  named  vul‐
505       ture.cs.wisc.edu, you might see
506
507       % condor_status vulture
508
509       Name                OpSys       Arch    State      Activity  LoadAv Mem
510       ActvtyTime
511
512       slot1@vulture.cs.w LINUX      INTEL   Claimed    Busy      1.050    512
513       0+01:47:42
514       slot2@vulture.cs.w  LINUX       INTEL   Claimed    Busy     1.000   512
515       0+01:48:19
516       slot3@vulture.cs.w LINUX      INTEL   Unclaimed  Idle      0.070    512
517       1+11:05:32
518       slot4@vulture.cs.w  LINUX       INTEL   Unclaimed  Idle     0.000   512
519       1+11:05:34
520
521                            Total Owner Claimed Unclaimed  Matched  Preempting
522       Backfill
523
524                INTEL/LINUX      4      0       2         2       0          0
525       0
526
527                      Total     4     0       2         2        0           0
528       0
529
530       Example  2To  view information from a specific nodes of an SMP machine,
531       specify the node directly. You do this by providing  the  name  of  the
532       slot. This has the form slot#@hostname. For example:
533
534       % condor_status slot3@vulture
535
536       Name                OpSys       Arch    State      Activity  LoadAv Mem
537       ActvtyTime
538
539       slot3@vulture.cs.w LINUX      INTEL   Unclaimed  Idle      0.070    512
540       1+11:10:32
541
542                            Total  Owner  Claimed Unclaimed Matched Preempting
543       Backfill
544
545                INTEL/LINUX     1     0       0         1        0           0
546       0
547
548                      Total      1      0       0         1       0          0
549       0
550
551       Constraint option examples
552
553       The Unix command to use the constraint option to see all machines  with
554       the OpSysof "LINUX":
555
556       % condor_status -constraint OpSys==\"LINUX\"
557
558       Note that quotation marks must be escaped with the backslash characters
559       for most shells.
560
561       The Windows command to do the same thing:
562
563       >condor_status -constraint " OpSys==""LINUX"" "
564
565       Note that quotation marks are used to delimit the single argument which
566       is  the  expression,  and  the quotation marks that identify the string
567       must be escaped by using a set of two double quote  marks  without  any
568       intervening spaces.
569
570       To see all machines that are currently in the Idle state, the Unix com‐
571       mand is
572
573       % condor_status -constraint State==\"Idle\"
574
575       To see all machines that are bench marked to have a MIPS rating of more
576       than 750, the Unix command is
577
578       % condor_status -constraint 'Mips>750'
579
580       -cod option example
581
582       The  -codoption displays the status of COD claims within a given HTCon‐
583       dor pool.
584
585       Name        ID   ClaimState TimeInState RemoteUser JobId Keyword
586       astro.cs.wi COD1 Idle        0+00:00:04 wright
587       chopin.cs.w COD1 Running     0+00:02:05 wright     3.0   fractgen
588       chopin.cs.w COD2 Suspended   0+00:10:21 wright     4.0   fractgen
589
590                      Total  Idle  Running  Suspended  Vacating  Killing
591        INTEL/LINUX       3     1        1          1         0        0
592              Total       3     1        1          1         0        0
593
594       -format option exampleTo display the name and memory attributes of each
595       job ClassAd in a format that is easily parsable by other tools:
596
597       % condor_status -format "%s " Name -format "%d\n" Memory
598
599       To do the same with the autoformatoption, run
600
601       % condor_status -autoformat Name Memory
602

Exit Status

604       condor_statuswill  exit  with  a status value of 0 (zero) upon success,
605       and it will exit with the value 1 (one) upon failure.
606

Author

608       Center for High Throughput Computing, University of Wisconsin-Madison
609
611       Copyright (C) 1990-2019 Center for High Throughput Computing,  Computer
612       Sciences  Department, University of Wisconsin-Madison, Madison, WI. All
613       Rights Reserved. Licensed under the Apache License, Version 2.0.
614
615
616
617                                     date                     condor_status(1)
Impressum