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-namesubsystem[.extension]

Description

       condor_fetchlogcontacts HTCondor 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
       ADMINISTRATOR level of access.

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

       The subsystemargument is any value  $(SUBSYSTEM) that has a defined configuration variable
       of  $(SUBSYSTEM)_LOG , or any of

          *  NEGOTIATOR_MATCH

          *  HISTORY

          *  STARTD_HISTORY

       A value for the optional .extensionto the subsystemargument 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.

       A  subsystemargument  of  STARTD_HISTORY fetches all condor_startdhistory by concatenating
       all instances of log files resulting from rotation.

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

       Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

       Copyright  (C)  1990-2015  Center  for  High  Throughput  Computing,   Computer   Sciences
       Department,  University  of  Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed
       under the Apache License, Version 2.0.

                                          February 2016                        condor_fetchlog(1)