condor_ status

Display status of the Condor pool

Synopsis

condor_ status [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:

• 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

-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

-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

-constraint const

(Custom option) Add constraint expression. See section 4.1 for details on writing expressions.

-format fmt attr

(Custom option) Register display format and attribute name. The fmt string has the same format as printf(3), and attr is the name of the attribute that should be displayed in the specified format.

General Remarks

• The information obtained from condor_ startds and condor_ schedds may sometimes appear to be inconsistent. This is normal since startds and schedds 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 hostname, in which case you will get back information about all virtual machines that are represented on that host, or you can list specific virtual machines by name. See the examples below for details.

• If you specify hostnames, without domains, Condor will automatically try to resolve those hostnames into fully qualified hostnames for you. This also works when specifying specific nodes of an SMP machine. In this case, everything after the ``@'' sign is treated as a hostname 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 hostname 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, just use the hostname. For example, if you had a 4-CPU machine, named ``vulture.cs.wisc.edu'', here's what 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 benchmarked 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-2003 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.6.0 Manual for additional notices.