Gather information about an HTCondor installation and a queued job
condor_gather_info [–jobid ClusterId.ProcId] [–scratch /path/to/directory]
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
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
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
the process ID is that of the condor_gather_info executable.
The information gathered by this tool:
User name who generated the report
Script location and machine name
Date of report creation
ps -auxww -forest
ls 'condor_config_val LOG'
ldd 'condor_config_val SBIN'/condor_schedd
Network interface configuration (
Location of HTCondor configuration files
HTCondor configuration variables
All variables and values
Definition locations for each configuration variable
condor_q -l jobid
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.
- -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
<PID>is replaced by the process ID of condor_gather_info.
condor-profile.txtThe 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.gzThe output file which contains all of the information produced by this tool.
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.