trond

Synopsis

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

Description

trond is the tron daemon that manages all jobs.

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