CONDOR_GATHER_INFO(1)

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 <href="../classad-attributes/job-classad-attributes.html#ClusterId"> and ProcId <href="../classad-attributes/job-classad-attributes.html#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-2026, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.