TRONCTL(1)

NAME
tronctl - control Tron jobs and services

SYNOPSYS

tronctl [--server <host:port>] [--verbose] <command> <job_name | job_run_id | action_run_id | service_name>

DESCRIPTION

tronctl is the control interface for Tron. tronctl allows you to enable, disable, start, stop and cancel Tron Jobs and Services.

OPTIONS

--server=<config-file>
    Config file containing the address of the server the tron instance is running on

--verbose
    Displays status messages along the way

--run-date=<YYYY-MM-DD>
    For starting a new job, specifies the run date that should be set. Defaults to today.

JOB COMMANDS

disable <job_name>
    Disables the job. Cancels all scheduled and queued runs. Doesn't schedule any more.

enable <job_name>
    Enables the job and schedules a new run.

start <job_name>
    Creates a new run of the specified job and runs it immediately.

start <job_run_id>
    Attempt to start the given job run. A Job run only starts if no other instance is running. If the job has already started, it will attempt to start any actions in the SCH or QUE state.

start <action_run_id>
    Attempt to start the action run.

restart <job_run_id>
    Creates a new job run with the same run time as this job.

cancel <job_run_id | action_run_id>
    Cancels the specified job run or action run.

success <job_run_id | action_run_id>
    Marks the specified job run or action run as succeeded. This behaves the same as the run actually completing. Dependant actions are run and queued runs start.

skip <action_run_id>
    Marks the specified action run as skipped. This allows dependant actions to run.

fail <job_run_id | action_run_id>
    Marks the specified job run or action run as failed. This behaves the same as the job actually failing.

stop <action_run_id>
    Stop an action run

stop <service>
    Stop (SIGTERM) a service

kill <service>
    Force stop (SIGKILL) a service

kill <action_run_id>
    Force stop (SIGKILL) an action run

move <job_name> <new_job_name>
    Rename a job

publish <action_run_trigger>
    Pulish a action run trigger. This command can be used to trigger an action run in waiting state. e.g. tronctl publish yelp-main.transaction_extract_report.run.shortdate.2019-10-31

discard <action_run_trigger>
    Discard existing actionrun trigger. e.g. tronctl discard yelp-main.transaction_extract_report.run.shortdate.2019-10-31

version
    Print tron client and server versions

SERVICE COMMANDS

start <service name>
    Start the service.

stop <service name>
    Stop the service.

EXAMPLES

$ tronctl start job0
New Job Run job0.2 created
$ tronctl start job0.3
Job Run job0.3 now in state RUNN
$ tronctl cancel job0.4
Job Run job0.4 now in state CANC
$ tronctl fail job0.4
Job Run job0.4 now in state FAIL
$ tronctl restart job0.4
Job Run job0.4 now in state RUNN
$ tronctl success job0.5
Job Run job0.5 now in state SUCC

BUGS

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

SEE ALSO

trond (8), tronfig (1), tronview (1),

AUTHOR
Yelp, Inc.

COPYRIGHT
2011, Yelp, Inc.