1just-man-pages/condor_status(G1e)neral Commands Manjuuaslt-man-pages/condor_status(1)
2
6 condor_status Display status of the Condor 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 Condor 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 custom
36 option may be specified. Any number of custom and host options may be
37 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 query ClassAd without performing query
56 -any
60 (Query option) Query all ClassAds and display their type, target
62 type, and name
63 -avail
67 (Query option) Query condor_startd ClassAds and identify resources
69 which are available
70 -ckptsrvr
74 (Query option) Query condor_ckpt_server ClassAds and display check‐
76 point server attributes
77 -claimed
81 (Query option) Query condor_startd ClassAds and print information
83 about claimed resources
84 -cod
88 (Query option) Display only machine ClassAds that have COD claims.
90 Information displayed includes the claim ID, the owner of the claim,
91 and the state of the COD claim.
92 -collector
96 (Query option) Query condor_collector ClassAds and display
98 attributes
99 -direct hostname
103 (Query option) Go directly to the given host name to get the Clas‐
105 sAds to display
106 -java
110 (Query option) Display only Java-capable resources.
112 -license
116 (Query option) Display license attributes.
118 -master
122 (Query option) Query condor_master ClassAds and display daemon mas‐
124 ter attributes
125 -negotiator
129 (Query option) Query condor_negotiator ClassAds and display
131 attributes
132 -pool centralmanagerhostname[:portnumber]
136 (Query option) Query the specified central manager using an optional
138 port number. condor_status queries the machine specified by the
139 configuration variable COLLECTOR_HOSTby default.
140 -quill
144 (Query option) Display attributes of machines running Quill.
146 -run
150 (Query option) Display information about machines currently running
152 jobs.
153 -schedd
157 (Query option) Query condor_schedd ClassAds and display attributes
159 -server
163 (Query option) Query condor_startd ClassAds and display resource
165 attributes
166 -startd
170 (Query option) Query condor_startd ClassAds
172 -state
176 (Query option) Query condor_startd ClassAds and display resource
178 state information
179 -storage
183 (Query option) Display attributes of machines with network storage
185 resources.
186 -submitters
190 (Query option) Query ClassAds sent by submitters and display impor‐
192 tant submitter attributes
193 -subsystem type
197 (Query option) If type is one of collector , negotiator , master ,
199 schedd , startd , or quill , then behavior is the same as the query
200 option without the -subsystem option. For example, -subsystem col‐
201 lector is the same as -collector . A value of type of CkptServer ,
202 Machine , DaemonMaster , or Scheduler targets that type of ClassAd.
203 -vm
207 (Query option) Query condor_startd ClassAds, and display only VM-
209 enabled machines. Information displayed includes the the machine
210 name, the virtual machine software version, the state of machine,
211 the virtual machine memory, and the type of networking.
212 -attributes Attr1 [,Attr2 ... ]
218 (Display option) Explicitly list the attributes in a comma separated
220 list which should be displayed when using the -xml or -long options.
221 Limiting the number of attributes increases the efficiency of the
222 query.
223 -expert
227 (Display option) Display shortened error messages
229 -long
233 (Display option) Display entire ClassAds (same as -verbose )
235 -sort attr
239 (Display option) Display entries in ascending order based on the
241 value of the named attribute
242 -total
246 (Display option) Display totals only
248 -verbose
252 (Display option) Display entire ClassAds. Implies that totals will
254 not be displayed.
255 -xml
259 (Display option) Display entire ClassAds, in XML format. The XML
261 format is fully defined at http://www.cs.wisc.edu/condor/clas‐
262 sad/refman/.
263 -constraint const
269 (Custom option) Add constraint expression. See section for details
271 on writing expressions.
272 -format fmt attr
276 (Custom option) Display attribute or expression attr in format fmt .
278 To display the attribute or expression the format must contain a
279 single printf(3)style conversion specifier. Attributes must be from
280 the resource ClassAd. Expressions are ClassAd expressions and may
281 refer to attributes in the resource ClassAd. If the attribute is not
282 present in a given ClassAd and cannot be parsed as an expression,
283 then the format option will be silently skipped. The conversion
284 specifier must match the type of the attribute or expression. %s is
285 suitable for strings such as Name, %d for integers such as Last‐
286 HeardFrom, and %f for floating point numbers such as LoadAvg. An
287 incorrect format will result in undefined behavior. Do not use more
288 than one conversion specifier in a given format. More than one con‐
289 version specifier will result in undefined behavior. To output mul‐
290 tiple attributes repeat the -format option once for each desired
291 attribute. Like printf(3)style formats, one may include other text
292 that will be reproduced directly. A format without any conversion
293 specifiers may be specified, but an attribute is still required.
294 Include n to specify a line break.
295
299 * The default output from condor_status is formatted to be human
300 readable, not script readable. In an effort to make the output fit
301 within 80 characters, values in some fields might be truncated. Fur‐
302 thermore, the Condor Project can (and does) change the formatting of
303 this default output as we see fit. Therefore, any script that is
304 attempting to parse data from condor_status is strongly encouraged
305 to use the -format option (described above).
306 * The information obtained from condor_startd and condor_schedd dae‐
310 mons may sometimes appear to be inconsistent. This is normal since
311 condor_startd and condor_schedd daemons update the Condor manager at
312 different rates, and since there is a delay as information propa‐
313 gates through the network and the system.
314 * Note that the ActivityTimein the Idlestate is not the amount of
318 time that the machine has been idle. See the section on con‐
319 dor_startd states in the Administrator's Manual for more informa‐
320 tion.
321 * When using condor_status on a pool with SMP machines, you can
325 either provide the host name, in which case you will get back infor‐
326 mation about all slots that are represented on that host, or you can
327 list specific slots by name. See the examples below for details.
328 * If you specify host names, without domains, Condor will automati‐
332 cally try to resolve those host names into fully qualified host
333 names for you. This also works when specifying specific nodes of an
334 SMP machine. In this case, everything after the ``@'' sign is
335 treated as a host name and that is what is resolved.
336 * You can use the -direct option in conjunction with almost any
340 other set of options. However, at this time, the only daemon that
341 will allow direct queries for its ad(s) is the condor_startd . So,
342 the only options currently not supported with -direct are -schedd
343 and -master . Most other options use startd ads for their informa‐
344 tion, so they work seamlessly with -direct . The only other restric‐
345 tion on -direct is that you may only use 1 -direct option at a time.
346 If you want to query information directly from multiple hosts, you
347 must run condor_status multiple times.
348 * Unless you use the local host name with -direct , condor_status
352 will still have to contact a collector to find the address where the
353 specified daemon is listening. So, using a -pool option in conjunc‐
354 tion with -direct just tells condor_status which collector to query
355 to find the address of the daemon you want. The information actually
356 displayed will still be retrieved directly from the daemon you spec‐
357 ified as the argument to -direct .
358
362 Example 1 To view information from all nodes of an SMP machine, use
363 only the host name. For example, if you had a 4-CPU machine, named vul‐
364 ture.cs.wisc.edu, you might see
365 % condor_status vulture
367 Name OpSys Arch State Activity LoadAv Mem
369 ActvtyTime
370 slot1@vulture.cs.w LINUX INTEL Claimed Busy 1.050 512
372 0+01:47:42
373 slot2@vulture.cs.w LINUX INTEL Claimed Busy 1.000 512
374 0+01:48:19
375 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512
376 1+11:05:32
377 slot4@vulture.cs.w LINUX INTEL Unclaimed Idle 0.000 512
378 1+11:05:34
379 Total Owner Claimed Unclaimed Matched Preempting
381 Backfill
382 INTEL/LINUX 4 0 2 2 0 0
384 0
385 Total 4 0 2 2 0 0
387 0
388 Example 2 To view information from a specific nodes of an SMP machine,
390 specify the node directly. You do this by providing the name of the
391 slot. This has the form slot#@hostname. For example:
392 % condor_status slot3@vulture
394 Name OpSys Arch State Activity LoadAv Mem
396 ActvtyTime
397 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512
399 1+11:10:32
400 Total Owner Claimed Unclaimed Matched Preempting
402 Backfill
403 INTEL/LINUX 1 0 0 1 0 0
405 0
406 Total 1 0 0 1 0 0
408 0
409 Constraint option examples
411 To use the constraint option to see all machines with the OpSysof
413 "LINUX", use
414 % condor_status -constraint OpSys==
416 Note that quotation marks must be escaped with the backslash characters
418 for most shells.
419 To see all machines that are currently in the Idle state, use
421 % condor_status -constraint State==
423 To see all machines that are bench marked to have a MIPS rating of more
425 than 750, use
426 % condor_status -constraint 'Mips>750'
428 -cod option example
430 The -cod option displays the status of COD claims within a given Condor
432 pool.
433 Name ID ClaimState TimeInState RemoteUser JobId Keyword
435 astro.cs.wi COD1 Idle 0+00:00:04 wright
436 chopin.cs.w COD1 Running 0+00:02:05 wright 3.0 fractgen
437 chopin.cs.w COD2 Suspended 0+00:10:21 wright 4.0 fractgen
438 Total Idle Running Suspended Vacating Killing
440 INTEL/LINUX 3 1 1 1 0 0
441 Total 3 1 1 1 0 0
442
444 condor_status will exit with a status value of 0 (zero) upon success,
445 and it will exit with the value 1 (one) upon failure.
446
448 Condor Team, University of Wisconsin-Madison
449
451 Copyright (C) 1990-2009 Condor Team, Computer Sciences Department, Uni‐
452 versity of Wisconsin-Madison, Madison, WI. All Rights Reserved.
453 Licensed under the Apache License, Version 2.0.
454 See the Condor Version 7.4.2 Manual or http://www.condorpro‐
456 ject.org/licensefor additional notices. condor-admin@cs.wisc.edu
457 date just-man-pages/condor_status(1)