Man page - condor_gather_info(1)

Packages contains this manual

Manual

CONDOR_GATHER_INFO

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
EXIT STATUS
AUTHOR
COPYRIGHT

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.