xenial (1) condor_fetchlog.1.gz

Provided by: htcondor_8.4.2~dfsg.1-1build1_amd64 bug

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 (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)