tronctl

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

disableall
Disables all jobs
enableall
Enables all jobs
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

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

See Also

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

Table Of Contents

Previous topic

Man Pages

Next topic

trond

This Page