Scroll to navigation

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-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-2014 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 2015