1just-man-pages/condor_status(G1e)neral Commands Manjuuaslt-man-pages/condor_status(1)
2
6 condor_status Display status of the HTCondor pool
7
9 condor_status [ -debug ] [ help options ] [ query options ] [ display
10 options ] [ custom options ] [ name ... ]
11
13 condor_status is a versatile tool that may be used to monitor and query
14 the HTCondor pool. The condor_status tool 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 The options that may be supplied to condor_status belong to five
21 groups:
22 * Help options provide information about the condor_status tool.
24 * Query options control the content and presentation of status
26 information.
27 * Display options control the display of the queried information.
29 * Custom options allow the user to customize query and display
31 information.
32 * Host options specify specific machines to be queried
34 At any time, only one help option , one query option and one display
36 option may be specified. Any number of custom options and host options
37 may be specified.
38
40 -debug
41 Causes debugging information to be sent to stderr , based on the
43 value of the configuration variable TOOL_DEBUG .
44 -help
48 (Help option) Display usage information.
50 -diagnose
54 (Help option) Print out ClassAd query without performing the query.
56 -absent
60 (Query option) Query for and display only absent resources.
62 -ads filename
66 (Query option) Read the set of ClassAds in the file specified by
68 filename , instead of querying the condor_collector .
69 -any
73 (Query option) Query all ClassAds and display their type, target
75 type, and name.
76 -avail
80 (Query option) Query condor_startd ClassAds and identify resources
82 which are available.
83 -ckptsrvr
87 (Query option) Query condor_ckpt_server ClassAds and display check‐
89 point server attributes.
90 -claimed
94 (Query option) Query condor_startd ClassAds and print information
96 about claimed resources.
97 -cod
101 (Query option) Display only machine ClassAds that have COD claims.
103 Information displayed includes the claim ID, the owner of the claim,
104 and the state of the COD claim.
105 -collector
109 (Query option) Query condor_collector ClassAds and display
111 attributes.
112 -defrag
116 (Query option) Query condor_defrag ClassAds.
118 -direct hostname
122 (Query option) Go directly to the given host name to get the Clas‐
124 sAds to display. By default, returns the condor_startd ClassAd. If
125 -schedd is also given, return the condor_schedd ClassAd on that
126 host.
127 -java
131 (Query option) Display only Java-capable resources.
133 -license
137 (Query option) Display license attributes.
139 -master
143 (Query option) Query condor_master ClassAds and display daemon mas‐
145 ter attributes.
146 -negotiator
150 (Query option) Query condor_negotiator ClassAds and display
152 attributes.
153 -pool centralmanagerhostname[:portnumber]
157 (Query option) Query the specified central manager using an optional
159 port number. condor_status queries the machine specified by the
160 configuration variable COLLECTOR_HOST by default.
161 -run
165 (Query option) Display information about machines currently running
167 jobs.
168 -schedd
172 (Query option) Query condor_schedd ClassAds and display attributes.
174 -server
178 (Query option) Query condor_startd ClassAds and display resource
180 attributes.
181 -startd
185 (Query option) Query condor_startd ClassAds.
187 -state
191 (Query option) Query condor_startd ClassAds and display resource
193 state information.
194 -statistics WhichStatistics
198 (Query option) Can only be used if the -direct option has been spec‐
200 ified. Identifies which Statistics attributes to include in the
201 ClassAd. WhichStatistics is specified using the same syntax as
202 defined for STATISTICS_TO_PUBLISH . A definition is in the HTCondor
203 Administrator's manual section on configuration.
204 -storage
208 (Query option) Display attributes of machines with network storage
210 resources.
211 -submitters
215 (Query option) Query ClassAds sent by submitters and display impor‐
217 tant submitter attributes.
218 -subsystem type
222 (Query option) If type is one of collector , negotiator , master ,
224 schedd , startd , or quill , then behavior is the same as the query
225 option without the -subsystem option. For example, -subsystem col‐
226 lector is the same as -collector . A value of type of CkptServer ,
227 Machine , DaemonMaster , or Scheduler targets that type of ClassAd.
228 -vm
232 (Query option) Query condor_startd ClassAds, and display only VM-
234 enabled machines. Information displayed includes the machine name,
235 the virtual machine software version, the state of machine, the vir‐
236 tual machine memory, and the type of networking.
237 -offline
241 (Query option) Query condor_startd ClassAds, and display, for each
243 machine with at least one offline universe, which universes are off‐
244 line for it.
245 -attributes Attr1[,Attr2 ...]
249 (Display option) Explicitly list the attributes in a comma separated
251 list which should be displayed when using the -xml , -json or -long
252 options. Limiting the number of attributes increases the efficiency
253 of the query.
254 -expert
258 (Display option) Display shortened error messages.
260 -long
264 (Display option) Display entire ClassAds. Implies that totals will
266 not be displayed.
267 -sort expr
271 (Display option) Change the display order to be based on ascending
273 values of an evaluated expression given by expr . Evaluated expres‐
274 sions of a string type are in a case insensitive alphabetical order.
275 If multiple -sort arguments appear on the command line, the primary
276 sort will be on the leftmost one within the command line, and it is
277 numbered 0. A secondary sort will be based on the second expression,
278 and it is numbered 1. For informational or debugging purposes, the
279 ClassAd output to be displayed will appear as if the ClassAd had two
280 additional attributes. CondorStatusSortKeyExpr<N> is the expres‐
281 sion, where <N> is replaced by the number of the sort. CondorSta‐
282 tusSortKey<N> gives the result of evaluating the sort expression
283 that is numbered <N> .
284 -total
288 (Display option) Display totals only.
290 -xml
294 (Display option) Display entire ClassAds, in XML format. The XML
296 format is fully defined in the reference manual, obtained from the
297 ClassAds web page, with a link at http://htcondor.org/classad/clas‐
298 sad.html.
299 -json
303 (Display option) Display entire ClassAds in JSON format.
305 -constraint const
309 (Custom option) Add constraint expression.
311 -compact #21498#>
315 (Custom option) Show compact form, rolling up slots into a single
317 line.
318 -format fmt attr
322 (Custom option) Display attribute or expression attr in format fmt .
324 To display the attribute or expression the format must contain a
325 single printf(3) -style conversion specifier. Attributes must be
326 from the resource ClassAd. Expressions are ClassAd expressions and
327 may refer to attributes in the resource ClassAd. If the attribute is
328 not present in a given ClassAd and cannot be parsed as an expres‐
329 sion, then the format option will be silently skipped. %r prints the
330 unevaluated, or raw values. The conversion specifier must match the
331 type of the attribute or expression. %s is suitable for strings such
332 as Name , %d for integers such as LastHeardFrom , and %f for
333 floating point numbers such as LoadAvg . %v identifies the type of
334 the attribute, and then prints the value in an appropriate format.
335 %V identifies the type of the attribute, and then prints the value
336 in an appropriate format as it would appear in the -long format. As
337 an example, strings used with %V will have quote marks. An incorrect
338 format will result in undefined behavior. Do not use more than one
339 conversion specifier in a given format. More than one conversion
340 specifier will result in undefined behavior. To output multiple
341 attributes repeat the -format option once for each desired
342 attribute. Like printf(3) -style formats, one may include other
343 text that will be reproduced directly. A format without any conver‐
344 sion specifiers may be specified, but an attribute is still
345 required. Include n to specify a line break.
346 -autoformat[:lhVr,tng] attr1 [attr2 ...] or -af[:lhVr,tng] attr1
352 [attr2 ...]
353 (Output option) Display attribute(s) or expression(s) formatted in a
355 default way according to attribute types. This option takes an arbi‐
356 trary number of attribute names as arguments, and prints out their
357 values, with a space between each value and a newline character
358 after the last value. It is like the -format option without format
359 strings. This output option does not work in conjunction with the
360 -run option.
361 It is assumed that no attribute names begin with a dash character,
363 so that the next word that begins with dash is the start of the next
364 option. The autoformat option may be followed by a colon character
365 and formatting qualifiers to deviate the output formatting from the
366 default:
367 l label each field,
369 h print column headings before the first line of output,
371 V use %V rather than %v for formatting (string values are quoted),
373 r print "raw", or unevaluated values,
375 , add a comma character after each field,
377 t add a tab character before each field instead of the default space
379 character,
380 n add a newline character after each field,
382 g add a newline character between ClassAds, and suppress spaces
384 before each field.
385 Use -af:h to get tabular values with headings.
387 Use -af:lrng to get -long equivalent format.
389 The newline and comma characters may not be used together. The l and
391 h characters may not be used together.
392 -target filename
396 (Custom option) Where evaluation requires a target ClassAd to evalu‐
398 ate against, file filename contains the target ClassAd.
399
403 * The default output from condor_status is formatted to be human
404 readable, not script readable. In an effort to make the output fit
405 within 80 characters, values in some fields might be truncated. Fur‐
406 thermore, the HTCondor Project can (and does) change the formatting
407 of this default output as we see fit. Therefore, any script that is
408 attempting to parse data from condor_status is strongly encouraged
409 to use the -format option (described above).
410 * The information obtained from condor_startd and condor_schedd dae‐
414 mons may sometimes appear to be inconsistent. This is normal since
415 condor_startd and condor_schedd daemons update the HTCondor manager
416 at different rates, and since there is a delay as information propa‐
417 gates through the network and the system.
418 * Note that the ActivityTime in the Idle state is not the amount
422 of time that the machine has been idle. See the section on con‐
423 dor_startd states in the Administrator's Manual for more informa‐
424 tion.
425 * When using condor_status on a pool with SMP machines, you can
429 either provide the host name, in which case you will get back infor‐
430 mation about all slots that are represented on that host, or you can
431 list specific slots by name. See the examples below for details.
432 * If you specify host names, without domains, HTCondor will automat‐
436 ically try to resolve those host names into fully qualified host
437 names for you. This also works when specifying specific nodes of an
438 SMP machine. In this case, everything after the ``@'' sign is
439 treated as a host name and that is what is resolved.
440 * You can use the -direct option in conjunction with almost any
444 other set of options. However, at this time, the only daemon that
445 will allow direct queries for its ad(s) is the condor_startd . So,
446 the only options currently not supported with -direct are -schedd
447 and -master . Most other options use startd ads for their informa‐
448 tion, so they work seamlessly with -direct . The only other restric‐
449 tion on -direct is that you may only use 1 -direct option at a time.
450 If you want to query information directly from multiple hosts, you
451 must run condor_status multiple times.
452 * Unless you use the local host name with -direct , condor_status
456 will still have to contact a collector to find the address where the
457 specified daemon is listening. So, using a -pool option in conjunc‐
458 tion with -direct just tells condor_status which collector to query
459 to find the address of the daemon you want. The information actually
460 displayed will still be retrieved directly from the daemon you spec‐
461 ified as the argument to -direct .
462
466 Example 1 To view information from all nodes of an SMP machine, use
467 only the host name. For example, if you had a 4-CPU machine, named
468 vulture.cs.wisc.edu , you might see
469 % condor_status vulture
471 Name OpSys Arch State Activity LoadAv Mem
473 ActvtyTime
474 slot1@vulture.cs.w LINUX INTEL Claimed Busy 1.050 512
476 0+01:47:42
477 slot2@vulture.cs.w LINUX INTEL Claimed Busy 1.000 512
478 0+01:48:19
479 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512
480 1+11:05:32
481 slot4@vulture.cs.w LINUX INTEL Unclaimed Idle 0.000 512
482 1+11:05:34
483 Total Owner Claimed Unclaimed Matched Preempting
485 Backfill
486 INTEL/LINUX 4 0 2 2 0 0
488 0
489 Total 4 0 2 2 0 0
491 0
492 Example 2 To view information from a specific nodes of an SMP machine,
494 specify the node directly. You do this by providing the name of the
495 slot. This has the form slot#@hostname . For example:
496 % condor_status slot3@vulture
498 Name OpSys Arch State Activity LoadAv Mem
500 ActvtyTime
501 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512
503 1+11:10:32
504 Total Owner Claimed Unclaimed Matched Preempting
506 Backfill
507 INTEL/LINUX 1 0 0 1 0 0
509 0
510 Total 1 0 0 1 0 0
512 0
513 Constraint option examples
515 The Unix command to use the constraint option to see all machines with
517 the OpSys of "LINUX" :
518 % condor_status -constraint OpSys==\"LINUX\"
520 Note that quotation marks must be escaped with the backslash characters
522 for most shells.
523 The Windows command to do the same thing:
525 >condor_status -constraint " OpSys==""LINUX"" "
527 Note that quotation marks are used to delimit the single argument which
529 is the expression, and the quotation marks that identify the string
530 must be escaped by using a set of two double quote marks without any
531 intervening spaces.
532 To see all machines that are currently in the Idle state, the Unix com‐
534 mand is
535 % condor_status -constraint State==\"Idle\"
537 To see all machines that are bench marked to have a MIPS rating of more
539 than 750, the Unix command is
540 % condor_status -constraint 'Mips>750'
542 -cod option example
544 The -cod option displays the status of COD claims within a given HTCon‐
546 dor pool.
547 Name ID ClaimState TimeInState RemoteUser JobId Keyword
549 astro.cs.wi COD1 Idle 0+00:00:04 wright
550 chopin.cs.w COD1 Running 0+00:02:05 wright 3.0 fractgen
551 chopin.cs.w COD2 Suspended 0+00:10:21 wright 4.0 fractgen
552 Total Idle Running Suspended Vacating Killing
554 INTEL/LINUX 3 1 1 1 0 0
555 Total 3 1 1 1 0 0
556 -format option example To display the name and memory attributes of
558 each job ClassAd in a format that is easily parsable by other tools:
559 % condor_status -format "%s " Name -format "%d\n" Memory
561 To do the same with the autoformat option, run
563 % condor_status -autoformat Name Memory
565
567 condor_status will exit with a status value of 0 (zero) upon success,
568 and it will exit with the value 1 (one) upon failure.
569
571 Center for High Throughput Computing, University of Wisconsin-Madison
572
574 Copyright (C) 1990-2018 Center for High Throughput Computing, Computer
575 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
576 Rights Reserved. Licensed under the Apache License, Version 2.0.
577 date just-man-pages/condor_status(1)