Man Linux: Main Page and Category List

Name

       condor_status - Display status of the Condor 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  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_HOSTby 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  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 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 ActivityTimein the Idlestate is not  the  amount  of
          time   that   the   machine  has  been  idle.  See  the  section  on
          condor_startd  states  in  the  Administrators  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  OpSysof
       "LINUX", use

       % condor_status -constraint OpSys==

       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==

       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  (C)  1990-2009  Condor  Team,  Computer Sciences Department,
       University of Wisconsin-Madison,  Madison,  WI.  All  Rights  Reserved.
       Licensed under the Apache License, Version 2.0.

       See       the       Condor       Version      7.2.4      Manual      or
       http://www.condorproject.org/licensefor  additional  notices.   condor-
       admin@cs.wisc.edu

                                     date      just-man-pages/condor_status(1)