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 ... ]

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:

Help options provide information about the condor_ status tool.
Query options control the content and presentation of status information.
Display options control the display of the queried information.
Custom options allow the user to customize query and display information.
Host options specify specific machines to be queried

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
-any: (Query option) Query all ads and display their type, target type, and name
-avail: (Query option) Query condor_ startd ads and identify resources which are available
-ckptsrvr: (Query option) Query condor_ ckpt_server ads and display checkpoint server attributes
-claimed: (Query option) Query condor_ startd ads and print information about claimed resources
-cod: (Query 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.
-direct hostname: (Query option) Go directly to the given host name to get the ads to display
-java: (Query option) Display only Java-capable resources.
-license: (Query option) Display license attributes.
-master: (Query option) Query condor_ master ads and display daemon master attributes
-negotiator: (Query option) Query condor_ negotiator ads and display attributes
-pool centralmanagerhostname[:portnumber]: (Query option) Query the specified central manager using an optional port number. condor_ status queries the machine specified by the configuration variable COLLECTOR_HOST by default.
-quill: (Query option) Display attributes of machines running Quill.
-run: (Query option) Display information about machines currently running jobs.
-schedd: (Query option) Query condor_ schedd 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
-storage: (Query option) Display attributes of machines with network storage resources.
-submitters: (Query option) Query ads sent by submitters and display important submitter attributes
-subsystem type: (Query option) If type is one of collector, negotiator, master, schedd, startd, or quill, then behavior is the same as the query option without the -subsystem option. For example, -subsystem collector is the same as -collector. A value of type of CkptServer, Machine, DaemonMaster, or Scheduler targets that type of ClassAd.
-vm: (Query option) Query condor_ startd ClassAds, and display only VM-enabled machines. Information displayed includes the the machine name, the virtual machine software version, the state of machine, the virtual machine memory, and the type of networking.
-expert: (Display option) Display shortened error messages
-long: (Display option) Display entire ClassAds (same as -verbose)
-sort attr: (Display option) Display entries in ascending order based on the value of the named attribute
-total: (Display option) Display totals only
-verbose: (Display option) Display entire ClassAds. Implies that totals will not be displayed.
-xml: (Display option) Display entire ClassAds, in XML format. The XML format is fully defined at http://www.cs.wisc.edu/condor/classad/refman/.
-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, one may include other text that will be reproduced directly. A format without any conversion specifiers may be specified, but an attribute is still required. Include $\mathtt{\backslash}$ n to specify a line break.

General Remarks

The default output from condor_ status is formatted to be human readable, not script readable. In an effort to make the output fit within 80 characters, values in some fields might be truncated. Furthermore, the Condor Project can (and does) change the formatting of this default output as we see fit. Therefore, any script that is attempting to parse data from condor_ status is strongly encouraged to use the -format option (described above).
The information obtained from condor_ startd and condor_ schedd daemons may sometimes appear to be inconsistent. This is normal since condor_ startd and condor_ schedd daemons update the Condor manager at different rates, and since there is a delay as information propagates through the network and the system.
Note that the ActivityTime in the Idle state is not the amount of time that the machine has been idle. See the section on condor_ startd states in the Administrator's Manual for more information.
When using condor_ status on a pool with SMP machines, you can either provide the host name, in which case you will get back information about all slots that are represented on that host, or you can list specific slots by name. See the examples below for details.
If you specify host names, without domains, Condor will automatically try to resolve those host names into fully qualified host names for you. This also works when specifying specific nodes of an SMP machine. In this case, everything after the ``@'' sign is treated as a host name and that is what is resolved.
You can use the -direct option in conjunction with almost any other set of options. However, at this time, the only daemon that will allow direct queries for its ad(s) is the condor_ startd. So, the only options currently not supported with -direct are -schedd and -master. Most other options use startd ads for their information, so they work seamlessly with -direct. The only other restriction on -direct is that you may only use 1 -direct option at a time. If you want to query information directly from multiple hosts, you must run condor_ status multiple times.
Unless you use the local host name with -direct, condor_ status will still have to contact a collector to find the address where the specified daemon is listening. So, using a -pool option in conjunction with -direct just tells condor_ status which collector to query to find the address of the daemon you want. The information actually displayed will still be retrieved directly from the daemon you specified as the argument to -direct.

Examples

Example 1 To view information from all nodes of an SMP machine, use only the host name. 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

slot1@vulture.cs.w LINUX      INTEL  Claimed   Busy     1.050   512  0+01:47:42
slot2@vulture.cs.w LINUX      INTEL  Claimed   Busy     1.000   512  0+01:48:19
slot3@vulture.cs.w LINUX      INTEL  Unclaimed Idle     0.070   512  1+11:05:32
slot4@vulture.cs.w LINUX      INTEL  Unclaimed Idle     0.000   512  1+11:05:34

                     Total Owner Claimed Unclaimed Matched Preempting Backfill

         INTEL/LINUX     4     0       2         2       0          0        0

               Total     4     0       2         2       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 slot. This has the form slot#@hostname. For example:

% condor_status slot3@vulture

Name               OpSys      Arch   State     Activity LoadAv Mem   ActvtyTime

slot3@vulture.cs.w LINUX      INTEL  Unclaimed Idle     0.070   512  1+11:10:32

                     Total Owner Claimed Unclaimed Matched Preempting Backfill

         INTEL/LINUX     1     0       0         1       0          0        0

               Total     1     0       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-2008 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 7.0.4 Manual for additional notices.

Next: condor_ store_cred Up: 9. Command Reference Manual Previous: condor_ stats Contents Index

condor-admin@cs.wisc.edu