1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
*condor_gather_info*
======================
Gather information about an HTCondor installation and a queued job
:index:`condor_gather_info<single: condor_gather_info; HTCondor commands>`\ :index:`condor_gather_info command`
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
:ad-attr:`ClusterId` and :ad-attr:`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
.. code-block:: text
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:
#. 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
#. 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.
|
