Next: condor_ store_cred
Up: 9. Command Reference Manual
Previous: condor_ stats
Contents
Index
Subsections
condor_ status
Display status of the Condor pool
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.
- -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
n to add specify a line break.
- 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 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 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
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.
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
condor_ status will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.
Condor Team, University of Wisconsin-Madison
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: condor_ store_cred
Up: 9. Command Reference Manual
Previous: condor_ stats
Contents
Index
condor-admin@cs.wisc.edu