Scroll to navigation

condor_gather_info(1) General Commands Manual condor_gather_info(1)

Name

condor_gather_info Gather - information about a Condor installation and a queued job

Synopsis

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

Description

NOTE: The usage information that the Condor versions 7.7.3 and 7.7.4 condor_gather_infotool outputs is not quite correct. This manual page is more accurate for those releases.
condor_gather_infowill collect and output information about the machine it is run upon, about the Condor installation local to the machine, and optionally about a specified Condor job. The information gathered by this tool is most often used as a debugging aid for the developers of Condor.
Without the -- jobidoption, information about the local machine and its Condor installation is gathered and placed into the file called condor-profile.txt , in the current working directory. Specification of the information gathered is given in the General Remarkssection below, under the category of Identity.
With the -- jobidoption, additional information is gathered about the job identified by its ClusterId and ProcId ClassAd attributes. This information includes both categories as given in the General Remarkssection below: 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 , where 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 -- scratchoption is specified, it identifies a directory in which to build the tar file. If the -- scratchoption is notspecified, then the directory will be /tmp/cgi-<PID> , where the process ID is that of the condor_gather_infoexecutable.

Options

 
--jobid <ClusterId.ProcId>
Data mine information about this Condor job from the local Condor 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 .
 

General Remarks

The information gathered by this tool is:
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
* ps -auxww -forest
* df -h
* iptables -L
* ls `condor_config_val LOG`
* ldd `condor_config_val SBIN`/condor_schedd
* Contents of /etc/hosts
* Contents of /etc/nsswitch.conf
* ulimit -a
* Network interface configuration ( ifconfig )
* Condor version
* Location of Condor configuration files
* Condor configuration variables
* All variables and values
* Definition locations for each configuration variable
2. Job Information
* condor_q jobid
* condor_q -l jobid
* condor_q -better-analyze jobid
* Job user log, if it exists
* Only events pertaining to the job ID

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_infowill 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-2012 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.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu
February 2015