1RT-CRONTOOL(1)        User Contributed Perl Documentation       RT-CRONTOOL(1)
2
3
4

NAME

6       rt-crontool - a tool to act on tickets from an external scheduling tool
7

SYNOPSIS

9           # find all active tickets in the queue 'general' and set their priority to 99 if they are overdue:
10           rt-crontool \
11             --search RT::Search::ActiveTicketsInQueue  --search-arg general \
12             --condition RT::Condition::Overdue \
13             --action RT::Action::SetPriority --action-arg 99 \
14             --verbose
15
16           # Escalate tickets
17             rt-crontool \
18               --search RT::Search::ActiveTicketsInQueue  --search-arg general \
19               --action RT::Action::EscalatePriority
20
21           # Process tickets in parallel
22             rt-crontool \
23               --search RT::Search::ActiveTicketsInQueue  --search-arg general \
24               --action RT::Action::SomeTimeConsumingAction
25               --max-processes 10 --max-tickets-per-process 100
26

DESCRIPTION

28       This script is a tool to act on tickets from an external scheduling
29       tool, such as cron.
30
31       Security:
32
33       This tool allows the user to run arbitrary perl modules from within RT.
34       If this tool were setgid, a hostile local user could use this tool to
35       gain administrative access to RT. It is incredibly important that
36       nonprivileged users not be allowed to run this tool. It is suggested
37       that you create a non-privileged unix user with the correct group
38       membership and RT access to run this tool.
39

OPTIONS

41       search
42           Specify the search module you want to use
43
44       search-arg
45           An argument to pass to --search
46
47       condition
48           Specify the condition module you want to use
49
50       condition-arg
51           An argument to pass to --condition
52
53       action
54           Specify the action module you want to use. This option may be
55           repeated to apply multiple actions to found tickets.
56
57       action-arg
58           An argument to pass to --action. This option may be repeated to
59           pass corresponding arguments to multiple calls of --action.
60
61       template
62           Specify name or id of template(s) you want to use
63
64       transaction
65           Specify if you want to use either 'first', 'last' or 'all'
66           transactions
67
68       transaction-type
69           Specify the comma separated list of transactions' types you want to
70           use
71
72       reload-ticket
73           Reload ticket before processing in tickets iteration. This is to
74           refresh ticket metadata, which is useful especially for long-
75           running jobs.
76
77       max-processes
78           Specify the max number of children to maintain. This implies
79           parallel processing, which is false by default.
80
81       max-tickets-per-process
82           Specify the max number of tickets to process in each child. Only
83           take effect with --max-processes.  Default is 100.
84
85       log Adjust LogToSTDERR config option
86
87       verbose
88           Output status updates to STDOUT
89
90       dry-run
91           Actions are composed of 2 parts: "Prepare" and "Commit".  "dry-run"
92           skips the "Commit" part.
93
94
95
96perl v5.34.0                      2022-03-01                    RT-CRONTOOL(1)
Impressum