.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "CONDOR_GATHER_INFO" "1" "Apr 01, 2024" "" "HTCondor Manual" .SH NAME condor_gather_info \- HTCondor Manual .sp Gather information about an HTCondor installation and a queued job .SH SYNOPSIS .sp \fBcondor_gather_info\fP [\-\-\fBjobid\fP \fIClusterId.ProcId\fP] [\-\-\fBscratch\fP \fI/path/to/directory\fP] .SH DESCRIPTION .sp \fIcondor_gather_info\fP 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. .sp Without the \-\-\fBjobid\fP option, information about the local machine and its HTCondor installation is gathered and placed into the file called \fBcondor\-profile.txt\fP, in the current working directory. The information gathered is under the category of Identity. .sp With the \-\-\fBjobid\fP option, additional information is gathered about the job given in the command line argument and identified by its \fBClusterId\fP and \fBProcId\fP 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 .INDENT 0.0 .INDENT 3.5 .sp .EX cgi\-\-jid.\-\-\-\-__\-.tar.gz .EE .UNINDENT .UNINDENT .sp 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 \-\-\fBscratch\fP option is specified, it identifies a directory in which to build the tar file. If the \-\-\fBscratch\fP option is not specified, then the directory will be \fB/tmp/cgi\-\fP, where the process ID is that of the \fIcondor_gather_info\fP executable. .sp The information gathered by this tool: .INDENT 0.0 .IP 1. 3 Identity .INDENT 3.0 .IP \(bu 2 User name who generated the report .IP \(bu 2 Script location and machine name .IP \(bu 2 Date of report creation .IP \(bu 2 \fBuname \-a\fP .IP \(bu 2 Contents of \fB/etc/issue\fP .IP \(bu 2 Contents of \fB/etc/redhat\-release\fP .IP \(bu 2 Contents of \fB/etc/debian_version\fP .IP \(bu 2 Contents of \fB$(LOG)/MasterLog\fP .IP \(bu 2 Contents of \fB$(LOG)/ShadowLog\fP .IP \(bu 2 Contents of \fB$(LOG)/SchedLog\fP .IP \(bu 2 Output of \fBps \-auxww \-forest\fP .IP \(bu 2 Output of \fBdf \-h\fP .IP \(bu 2 Output of \fBiptables \-L\fP .IP \(bu 2 Output of \fBls \(aqcondor_config_val LOG\(aq\fP .IP \(bu 2 Output of \fBldd \(aqcondor_config_val SBIN\(aq/condor_schedd\fP .IP \(bu 2 Contents of \fB/etc/hosts\fP .IP \(bu 2 Contents of \fB/etc/nsswitch.conf\fP .IP \(bu 2 Output of \fBulimit \-a\fP .IP \(bu 2 Output of \fBuptime\fP .IP \(bu 2 Output of \fBfree\fP .IP \(bu 2 Network interface configuration (\fBifconfig\fP) .IP \(bu 2 HTCondor version .IP \(bu 2 Location of HTCondor configuration files .IP \(bu 2 HTCondor configuration variables .INDENT 3.0 .IP \(bu 2 All variables and values .IP \(bu 2 Definition locations for each configuration variable .UNINDENT .UNINDENT .IP 2. 3 Job Information .INDENT 3.0 .IP \(bu 2 Output of \fBcondor_q jobid\fP .IP \(bu 2 Output of \fBcondor_q \-l jobid\fP .IP \(bu 2 Output of \fBcondor_q \-analyze jobid\fP .IP \(bu 2 Job event log, if it exists .INDENT 3.0 .IP \(bu 2 Only events pertaining to the job ID .UNINDENT .IP \(bu 2 If \fIcondor_gather_info\fP has the proper permissions, it runs \fIcondor_fetchlog\fP on the machine where the job most recently ran, and includes the contents of the logs from the \fIcondor_master\fP, \fIcondor_startd\fP, and \fIcondor_starter\fP\&. .UNINDENT .UNINDENT .SH OPTIONS .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP \fB\-jobid\fP \fI\fP Data mine information about this HTCondor job from the local HTCondor installation and \fIcondor_schedd\fP\&. .TP \fB\-scratch\fP \fI/path/to/directory\fP A path to temporary space needed when building the output tar file. Defaults to \fB/tmp/cgi\-\fP, where \fB\fP is replaced by the process ID of \fIcondor_gather_info\fP\&. .UNINDENT .UNINDENT .UNINDENT .SH FILES .INDENT 0.0 .IP \(bu 2 \fBcondor\-profile.txt\fP The Identity portion of the information gathered when \fIcondor_gather_info\fP is run without arguments. .IP \(bu 2 \fBcgi\-\-jid.\-\-\-\-__\-.tar.gz\fP The output file which contains all of the information produced by this tool. .UNINDENT .SH EXIT STATUS .sp \fIcondor_gather_info\fP will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. .SH AUTHOR HTCondor Team .SH 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. .\" Generated by docutils manpage writer. .