NAME

       condor_gather_info - HTCondor Manual

       Gather information about an HTCondor installation and a queued job

SYNOPSIS

       condor_gather_info [--jobid ClusterId.ProcId] [--scratch /path/to/directory]

DESCRIPTION

       condor_gather_info  is a Linux-only tool that will collect and output information about the machine it is
       run upon, about the HTCondor installation local to the machine, and optionally about a specified HTCondor
       job. The information gathered by this tool is most often used as a debugging aid for  the  developers  of
       HTCondor.

       Without the --jobid option, information about the local machine and its HTCondor installation is gathered
       and  placed  into  the  file called condor-profile.txt, in the current working directory. The information
       gathered is under the category of Identity.

       With the --jobid option, additional information is gathered about the  job  given  in  the  command  line
       argument  and  identified  by  its ClusterId and ProcId ClassAd attributes. The information includes both
       categories, Identity and Job  information.  As  the  quantity  of  information  can  be  extensive,  this
       information  is placed into a compressed tar file. The file is placed into the current working directory,
       and it is named using the format

          cgi-<username>-jid<ClusterId>.<ProcId>-<year>-<month>-<day>-<hour>_<minute>_<second>-<TZ>.tar.gz

       All values within <> are substituted with current values. The building of this potentially large tar file
       can require a fair amount of temporary space. If the --scratch  option  is  specified,  it  identifies  a
       directory  in  which  to build the tar file. If the --scratch option is not specified, then the directory
       will be /tmp/cgi-<PID>, where the process ID is that of the condor_gather_info executable.

       The information gathered by this tool:

       1. Identity

          • User name who generated the report

          • Script location and machine name

          • Date of report creation

          • uname -a

          • Contents of /etc/issue

          • Contents of /etc/redhat-release

          • Contents of /etc/debian_version

          • Contents of $(LOG)/MasterLog

          • Contents of $(LOG)/ShadowLog

          • Contents of $(LOG)/SchedLog

          • Output of ps -auxww -forest

          • Output of df -h

          • Output of iptables -L

          • Output of ls 'condor_config_val LOG'

          • Output of ldd 'condor_config_val SBIN'/condor_schedd

          • Contents of /etc/hosts

          • Contents of /etc/nsswitch.conf

          • Output of ulimit -a

          • Output of uptime

          • Output of free

          • Network interface configuration (ifconfig)

          • HTCondor version

          • Location of HTCondor configuration files

          • HTCondor configuration variables

             • All variables and values

             • Definition locations for each configuration variable

       2. Job Information

          • Output of condor_q jobid

          • Output of condor_q -l jobid

          • Output of condor_q -analyze jobid

          • Job event log, if it exists

             • Only events pertaining to the job ID

          • If condor_gather_info has the proper permissions, it runs condor_fetchlog on the machine  where  the
            job  most recently ran, and includes the contents of the logs from the condor_master, condor_startd,
            and condor_starter.

OPTIONS

          -jobid <ClusterId.ProcId>
                 Data mine information about  this  HTCondor  job  from  the  local  HTCondor  installation  and
                 condor_schedd.

          -scratch /path/to/directory
                 A   path   to  temporary  space  needed  when  building  the  output  tar  file.   Defaults  to
                 /tmp/cgi-<PID>, where <PID> is replaced by the process ID of condor_gather_info.

FILES

       • condor-profile.txt The Identity portion of the information  gathered  when  condor_gather_info  is  run
         without arguments.

       • cgi-<username>-jid<cluster>.<proc>-<year>-<month>-<day>-<hour>_<minute>_<second>-<TZ>.tar.gz The output
         file which contains all of the information produced by this tool.

EXIT STATUS

       condor_gather_info  will  exit  with  a  status value of 0 (zero) upon success, and it will exit with the
       value 1 (one) upon failure.

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024, Center for High Throughput Computing, Computer Sciences Department, University  of  Wisconsin-
       Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                                  Jun 20, 2025                             CONDOR_GATHER_INFO(1)