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.

       Typical  strings  for  the  argument  subsystemare  as  given  as  possible  values of the
       predefined configuration variable  $(SUBSYSTEM) . Note that access to any additional  logs
       can  be enabled by simply specifying the path to each log in the configuration 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

       Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

       Copyright   (C)   1990-2013  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.

                                           January 2014                        condor_fetchlog(1)