rt-crontool(1)						     Request Tracker Reference						    rt-crontool(1)

NAME

       rt-crontool - Command-line interface to Request Tracker

SYNOPSIS

	   # find all active tickets in the queue 'general' and set their priority to 99 if they are overdue:
	   rt-crontool 
	     --search RT::Search::ActiveTicketsInQueue	--search-arg general 
	     --condition RT::Condition::Overdue 
	     --action RT::Action::SetPriority --action-arg 99 
	     --verbose

	   # Escalate tickets
	     rt-crontool 
	       --search RT::Search::ActiveTicketsInQueue  --search-arg general 
	       --action RT::Action::EscalatePriority

DESCRIPTION

       This script is a tool to act on tickets from an external scheduling tool, such as cron.

       Security:

       This tool allows the user to run arbitrary perl modules from within RT. If this tool were setgid, a hostile local user could use this tool
       to gain administrative access to RT. It is incredibly important that nonprivileged users not be allowed to run this tool. It is suggested
       that you create a non-privileged unix user with the correct group membership and RT access to run this tool.

OPTIONS

       search
	   Specify the search module you want to use

       search-arg
	   An argument to pass to --search

       condition
	   Specify the condition module you want to use

       condition-arg
	   An argument to pass to --condition

       action
	   Specify the action module you want to use

       action-arg
	   An argument to pass to --action

       template
	   Specify name or id of template(s) you want to use

       transaction
	   Specify if you want to use either 'first', 'last' or 'all' transactions

       transaction-type
	   Specify the comma separated list of transactions' types you want to use

       log Adjust LogToScreen config option

       verbose
	   Output status updates to STDOUT

perl v5.14.2							    2013-05-22							    rt-crontool(1)