next up previous contents index
Next: condor_ store_cred Up: 9. Command Reference Manual Previous: condor_ stats   Contents   Index

Subsections


condor_ status

Display status of the Condor pool

Synopsis

condor_ status [-debug] [help options] [query options] [display options] [custom options] [hostname ... ]

Description

condor_ status is a versatile tool that may be used to monitor and query the Condor pool. The condor_ status tool can be used to query resource information, submitter information, checkpoint server information, and daemon master information. The specific query sent and the resulting information display is controlled by the query options supplied. Queries and display formats can also be customized.

The options that may be supplied to condor_ status belong to five groups:

At any time, only one help option, one query option and one custom option may be specified. Any number of custom and host options may be specified.

Options

-debug
Causes debugging information to be sent to stderr based on the value of the configuration variable TOOL_DEBUG
-help
(Help option) Display usage information
-diagnose
(Help option) Print out query ad without performing query
-avail
(Query option) Query condor_ startd ads and identify resources which are available
-claimed
(Query option) Query condor_ startd ads and print information about claimed resources
-ckptsrvr
(Query option) Query condor_ ckpt_server ads and display checkpoint server attributes
-direct hostname
(Query option) Go directly to the given hostname to get the ads to display
-java
(Query option) Display only Java-capable resources.
-master
(Query option) Query condor_ master ads and display daemon master attributes
-pool centralmanagerhostname[:portnumber]
(Query option) Query the specified central manager using an optional port number. (condor_ status queries COLLECTOR_HOST by default)
-schedd
(Query option) Query condor_ schedd ads and display attributes
-negotiator
(Query option) Query condor_ negotiator ads and display attributes
-server
(Query option) Query condor_ startd ads and display resource attributes
-startd
(Query option) Query condor_ startd ads
-state
(Query option) Query condor_ startd ads and display resource state information
-submitters
(Query option) Query ads sent by submitters and display important submitter attributes
-cod
(Display option) Display only machine ClassAds that have COD claims. Information displayed includes the claim ID, the owner of the claim, and the state of the COD claim.
-verbose
(Display option) Display entire ClassAds. Implies that totals will not be displayed.
-long
(Display option) Display entire ClassAds (same as -verbose)
-total
(Display option) Display totals only
-xml
(Display option) Display entire ClassAds, in xml format. The xml format is fully defined at http://www.cs.wisc.edu/condor/classad/refman/.
-expert
(Display option) Display shortened error messages
-sort attr
(Display option) Display entries in ascending order based on the value of the named attribute
-constraint const
(Custom option) Add constraint expression. See section 4.1 for details on writing expressions.
-format fmt attr
(Custom option) Display attribute or expression attr in format fmt. To display the attribute or expression the format must contain a single printf(3) style conversion specifier. Attributes must be from the resource ClassAd. Expressions are ClassAd expressions and may refer to attributes in the resource ClassAd. If the attribute is not present in a given ClassAd and cannot be parsed as an expression then the format option will be silently skipped. The conversion specifier must match the type of the attribute or expression. %s is suitable for strings such as Name, %d for integers such as LastHeardFrom, and %f for floating point numbers such as LoadAvg. An incorrect format will result in undefined behavior. Do not use more than one conversion specifier in a given format. More than one conversion specifier will result in undefined behavior. To output multiple attributes repeat the -format option once for each desired attribute. Like printf(3) style formats, you can include other text that will be reproduced directly. You can specify a format without any conversion specifiers, but you must still give an attribute. You can include $\mathtt{\backslash}$n to add specify a line break.

General Remarks

Examples

Example 1 To view information from all nodes of an SMP machine, use only the hostname. For example, if you had a 4-CPU machine, named vulture.cs.wisc.edu, you might see

% condor_status vulture

Name          OpSys       Arch   State      Activity   LoadAv Mem   ActvtyTime

vm1@vulture.c SOLARIS26   INTEL  Owner      Idle       0.020  128   0+00:57:13
vm2@vulture.c SOLARIS26   INTEL  Claimed    Busy       1.006  128   0+01:16:03
vm3@vulture.c SOLARIS26   INTEL  Claimed    Busy       0.978  128   0+03:32:53
vm4@vulture.c SOLARIS26   INTEL  Claimed    Busy       1.001  128   0+02:21:07

                     Machines Owner Claimed Unclaimed Matched Preempting

     INTEL/SOLARIS26        4     0       4         0       0          0

               Total        4     0       4         0       0          0

Example 2 To view information from a specific nodes of an SMP machine, specify the node directly. You do this by providing the name of the virtual machine. This has the form vm#@hostname. For example:

% condor_status vm2@vulture

Name          OpSys       Arch   State      Activity   LoadAv Mem   ActvtyTime

vm2@vulture.c SOLARIS26   INTEL  Claimed    Busy       1.006  128   0+01:16:03

                     Machines Owner Claimed Unclaimed Matched Preempting

     INTEL/SOLARIS26        1     0       1         0       0          0

               Total        1     0       1         0       0          0

Constraint option examples

To use the constraint option to see all machines with the OpSys of "LINUX", use

% condor_status -constraint OpSys==\"LINUX\"
Note that quotation marks must be escaped with the backslash characters for most shells.

To see all machines that are currently in the Idle state, use

% condor_status -constraint State==\"Idle\"

To see all machines that are bench marked to have a MIPS rating of more than 750, use

% condor_status -constraint 'Mips>750' 

-cod option example

The -cod option displays the status of COD claims within a given Condor pool.

Name        ID   ClaimState TimeInState RemoteUser JobId Keyword
astro.cs.wi COD1 Idle        0+00:00:04 wright
chopin.cs.w COD1 Running     0+00:02:05 wright     3.0   fractgen
chopin.cs.w COD2 Suspended   0+00:10:21 wright     4.0   fractgen

               Total  Idle  Running  Suspended  Vacating  Killing
 INTEL/LINUX       3     1        1          1         0        0
       Total       3     1        1          1         0        0

Exit Status

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

Author

Condor Team, University of Wisconsin-Madison

Copyright

Copyright © 1990-2006 Condor Team, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. No use of the Condor Software Program is authorized without the express consent of the Condor Team. For more information contact: Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.

U.S. Government Rights Restrictions: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable, Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.

See the Condor Version 6.8.3 Manual for additional notices.


next up previous contents index
Next: condor_ store_cred Up: 9. Command Reference Manual Previous: condor_ stats   Contents   Index
condor-admin@cs.wisc.edu