debian man page for condor_fetchlog

condor_fetchlog(1)					      General Commands Manual						condor_fetchlog(1)

Name
       condor_fetchlog Retrieve - a daemon's log file that is located on another computer

Synopsis
       condor_fetchlog [-help -version]

       condor_fetchlog[-pool  centralmanagerhostname[:portnumber]]  [-master  -startd  -schedd	-collector  -negotiator -kbdd] machine-namesubsys-
       tem[.extension]

Description
       condor_fetchlogcontacts Condor running on the machine specified by machine-name, and asks it to return a log file from that machine.  Which
       log file is determined from the subsystem[.extension]argument. The log file is printed to standard output. This command eliminates the need
       to remotely log in to a machine in order to retrieve a daemon's log file.

       For security purposes of authentication and authorization, this command requires an administrator's level of access.  See  section  3.6.1on
       page for more details about Condor's security mechanisms.

       The subsystem[.extension]argument is utilized to construct the log file's name. Without an optional .extension, the value of the configura-
       tion variable named subsystem_LOG defines the log file's name. When specified, the .extensionis appended to this value.

       Typical strings for the argument subsystemare as given as possible values of the predefined configuration variable  $(SUBSYSTEM) . See  the
       definition  in  section 3.3.1. Note that access to any additional logs can be enabled by simply specifying the path to each log in the con-
       figuration file with a configuration parameter named  <NAME>_LOG , choosing an arbitrary unique name for each case.

       A value for the optional .extensionargument is typically one of the three strings:

	  1.  .old

	  2.  .slot<X>

	  3.  .slot<X>.old Within these strings,  <X> is substituted with the slot number.

Options
       -help

	  Display usage information

       -version

	  Display version information

       -pool centralmanagerhostname[:portnumber]

	  Specify a pool by giving the central manager's host name and an optional port number

       -master

	  Send the command to the condor_masterdaemon (default)

       -startd

	  Send the command to the condor_startddaemon

       -schedd

	  Send the command to the condor_schedddaemon

       -collector

	  Send the command to the condor_collectordaemon

       -kbdd

	  Send the command to the condor_kbdddaemon

Examples
       To get the condor_negotiatordaemon's log from a host named  head.example.com from within the current pool:

       condor_fetchlog	head.example.com NEGOTIATOR

       To get the condor_startddaemon's log from a host named  execute.example.com from within the current pool:

       condor_fetchlog	execute.example.com STARTD

       This command requested the condor_startddaemon's log from the condor_master. If	the  condor_masterhas  crashed	or  is	unresponsive,  ask
       another daemon running on that computer to return the log. For example, ask the condor_startddaemon to return the condor_master's log:

       condor_fetchlog	-startd execute.example.com MASTER

Exit Status
       condor_fetchlog will 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_fetchlog(1)