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