Provided by: htcondor_8.0.5~dfsg.1-1ubuntu1_amd64 
Name
condor_status Display - status of the HTCondor pool
Synopsis
condor_status [-debug] [help options] [query options] [display options] [custom options]
[name ... ]
Description
condor_status is a versatile tool that may be used to monitor and query the HTCondor 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_statusbelong to five groups:
* Help optionsprovide information about the condor_status tool.
* Query optionscontrol the content and presentation of status information.
* Display optionscontrol the display of the queried information.
* Custom optionsallow the user to customize query and display information.
* Host optionsspecify specific machines to be queried
At any time, only one help option, one query optionand one display optionmay be specified.
Any number of custom optionsand host optionsmay 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 ClassAd without performing query
-absent
(Query option) Query for and display only absent resources.
-any
(Query option) Query all ClassAds and display their type, target type, and name
-avail
(Query option) Query condor_startdClassAds and identify resources which are available
-ckptsrvr
(Query option) Query condor_ckpt_serverClassAds and display checkpoint server
attributes
-claimed
(Query option) Query condor_startdClassAds 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.
-collector
(Query option) Query condor_collectorClassAds and display attributes
-direct hostname
(Query option) Go directly to the given host name to get the ClassAds to display. By
default, returns the condor_startdClassAd. If -scheddis also given, return the
condor_scheddClassAd on that host.
-java
(Query option) Display only Java-capable resources.
-license
(Query option) Display license attributes.
-master
(Query option) Query condor_masterClassAds and display daemon master attributes
-negotiator
(Query option) Query condor_negotiatorClassAds 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.
-run
(Query option) Display information about machines currently running jobs.
-schedd
(Query option) Query condor_scheddClassAds and display attributes
-server
(Query option) Query condor_startdClassAds and display resource attributes
-startd
(Query option) Query condor_startdClassAds
-state
(Query option) Query condor_startdClassAds and display resource state information
-statistics WhichStatistics
(Query option) Can only be used if the -directoption has been specified. Identifies
which Statistics attributes to include in the ClassAd. WhichStatisticsis specified
using the same syntax as defined for STATISTICS_TO_PUBLISH . A definition is in the
HTCondor Administrator's manual section on configuration.
-storage
(Query option) Display attributes of machines with network storage resources.
-submitters
(Query option) Query ClassAds sent by submitters and display important submitter
attributes
-subsystem type
(Query option) If typeis one of collector, negotiator, master, schedd, startd, or
quill, then behavior is the same as the query option without the -subsystemoption. For
example, -subsystem collectoris the same as -collector. A value of typeof CkptServer,
Machine, DaemonMaster, or Schedulertargets that type of ClassAd.
-vm
(Query option) Query condor_startdClassAds, 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.
-attributes Attr1[,Attr2 ... ]
(Display option) Explicitly list the attributes in a comma separated list which should
be displayed when using the -xmlor -longoptions. Limiting the number of attributes
increases the efficiency of the query.
-expert
(Display option) Display shortened error messages
-long
(Display option) Display entire ClassAds (same as -verbose)
-sort expr
(Display option) Change the display order to be based on ascending values of an
evaluated expression given by expr. Evaluated expressions of a string type are in a
case insensitive alphabetical order. If multiple -sortarguments appear on the command
line, the primary sort will be on the leftmost one within the command line, and it is
numbered 0. A secondary sort will be based on the second expression, and it is numbered
1. For informational or debugging purposes, the ClassAd output to be displayed will
appear as if the ClassAd had two additional attributes. CondorStatusSortKeyExpr<N> is
the expression, where <N> is replaced by the number of the sort.
CondorStatusSortKey<N> gives the result of evaluating the sort expression that is
numbered <N> .
-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 in the reference manual, obtained from the ClassAds web page, with a link at
http://research.cs.wisc.edu/htcondor/research.html.
-constraint const
(Custom option) Add constraint expression.
-format fmt attr
(Custom option) Display attribute or expression attrin 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 . %v
identifies the type of the attribute, and then prints the value in an appropriate
format. %V identifies the type of the attribute, and then prints the value in an
appropriate format as it would appear in the -longformat. As an example, strings used
with %V will have quote marks. 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 -formatoption 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
n to specify a line break.
-autoformat[:tn,lVh] attr1 [attr2 ...]
(Custom option) Display machine ClassAd attribute values formatted in a default way
according to their attribute types. This option takes an arbitrary number of attribute
names as arguments, and prints out their values. It is like the -formatoption, but no
format strings are required. It is assumed that no attribute names begin with a dash
character, so that the next word that begins with dash is the start of the next option.
The autoformatoption may be followed by a colon character and formatting qualifiers:
tadd a tab character before each field instead of the default space character,
nadd a newline character after each field,
,add a comma character after each field,
llabel each field,
Vuse %V rather than %v for formatting,
hprint headings before the first line of output.
The newline and comma characters may notbe used together.
-target filename
(Custom option) Where evaluation requires a target ClassAd to evaluate against, file
filenamecontains the target ClassAd.
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 HTCondor 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
-formatoption (described above).
* The information obtained from condor_startdand condor_schedddaemons may sometimes
appear to be inconsistent. This is normal since condor_startdand condor_schedddaemons
update the HTCondor 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 notthe amount of time that the
machine has been idle. See the section on condor_startdstates in the Administrator's
Manualfor 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, HTCondor 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 -directoption 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 -directare
-scheddand -master. Most other options use startd ads for their information, so they
work seamlessly with -direct. The only other restriction on -directis that you may only
use 1 -directoption 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 -pooloption in conjunction with -directjust 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 1To 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 2To 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
The Unix command to use the constraint option to see all machines with the OpSys of
"LINUX" :
% condor_status -constraint OpSys==\"LINUX\"
Note that quotation marks must be escaped with the backslash characters for most shells.
The Windows command to do the same thing:
>condor_status -constraint " OpSys==""LINUX"" "
Note that quotation marks are used to delimit the single argument which is the expression,
and the quotation marks that identify the string must be escaped by using a set of two
double quote marks without any intervening spaces.
To see all machines that are currently in the Idle state, the Unix command is
% condor_status -constraint State==\"Idle\"
To see all machines that are bench marked to have a MIPS rating of more than 750, the Unix
command is
% condor_status -constraint 'Mips>750'
-cod option example
The -codoption displays the status of COD claims within a given HTCondor 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
-format option exampleTo display the name and memory attributes of each job ClassAd in a
format that is easily parsable by other tools:
% condor_status -format "%s " Name -format "%d\n" Memory
To do the same with the autoformatoption, run
% condor_status -autoformat Name Memory
Exit Status
condor_statuswill exit with a status value of 0 (zero) upon success, and it will exit with
the value 1 (one) upon failure.
Author
Center for High Throughput Computing, University of Wisconsin-Madison
Copyright
Copyright (C) 1990-2013 Center for High Throughput Computing, Computer Sciences
Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed
under the Apache License, Version 2.0.
January 2014 condor_status(1)