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