debian man page for condor_gather_info

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

								  September 2012					     condor_gather_info(1)