---
name: "condor_gather_info"
section: "1"
platform: "linux"
package: "condor"
version: "23.9.6+dfsg-2.1+b10"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/condor_gather_info"
---

# condor\_gather\_info(1)

HTCondor Manual Gather information about an HTCondor installation and a queued job

## 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.