TROND(8)

NAME
trond - trond documentation

SYNOPSYS

trond [--working-dir=<working dir>] [--verbose] [--debug]

DESCRIPTION

trond is the tron daemon that manages all jobs and services.

OPTIONS

--version
    show program's version number and exit

-h, --help
    show this help message and exit

--working-dir=WORKING_DIR
    Directory where tron's state and output is stored (default /var/lib/tron/)

-l LOG_CONF, --log-conf=LOG_CONF
    Logging configuration file to setup python logger

-c CONFIG_FILE, --config-file=CONFIG_FILE
    Configuration file to load (default in working dir)

-v, --verbose
    Verbose logging

--debug
    Debug mode, extra error reporting, no daemonizing

--nodaemon
    (DEPRECATED in 0.9.4) Indicates we should not fork and daemonize the process (default False)

--lock-file=LOCKFILE
    Where to store the lock file of the executing process (default /var/run/tron.lock)

-P LISTEN_PORT, --port=LISTEN_PORT
    What port to listen on, defaults 8089

-H LISTEN_HOST, --host=LISTEN_HOST
    What host to listen on defaults to localhost

FILES

Working directory
    The directory where state and saved output of processes are stored.

Lock file
    Ensures only one daemon runs at a time.

Log File
    trond error log, configured from logging.conf

SIGNALS

SIGINT
    Graceful shutdown. Waits for running jobs to complete.

SIGTERM
    Does some cleanup before shutting down.

SIGHUP
    Reload the configuration file.

SIGUSR1
    Will drop into an ipdb debugging prompt.

LOGGING

Tron uses Python's standard logging and by default uses a rotating log file handler that rotates files each day. Logs go to /var/log/tron/tron.log.

To configure logging pass -l <logging.conf> to trond. You can modify the default logging.conf by coping it from tron/logging.conf. See http://docs.python.org/howto/logging.html#configuring-logging

BUGS

trond has issues around daylight savings time and may run jobs an hour early at the boundary.

Post further bugs to http://www.github.com/yelp/tron/issues.

SEE ALSO

tronctl (1), tronfig (1), tronview (1),

AUTHOR
Yelp, Inc.

COPYRIGHT
2011, Yelp, Inc.