summaryrefslogtreecommitdiff
path: root/docs/system/task-scheduler.rst
blob: 7fe49988d5adf01d0ed7af54210ba542bf81b181 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
.. _task-scheduler:


Task scheduler
--------------

| Task scheduler — allows scheduled task execution. Note that scripts excecuted this way are executed as root user - this may be dangerous.
| Together with :ref:`commandscripting` this can be used for automating configuration.

.. code-block:: none

  system
      task-scheduler
          task <name>
              cron-spec <UNIX cron time spec>
              executable
                  arguments <arguments string>
                  path <path to executable>
              interval
                  <int32>[mhd]

Interval
********

You are able to set the time as an time interval.

.. code-block:: none

  set system task-scheduler task <name> interval <value><suffix>

Sets the task to execute every N minutes, hours, or days. Suffixes:

 * m — minutes
 * h — hours
 * d — days

If suffix is omitted, minutes are implied.

Or set the execution time in common cron time.

.. code-block:: none

  set system task-scheduler task TEST crontab-spec "* * * 1 *"

Example
*******

.. code-block:: none

  system
      task-scheduler
          task mytask
              interval 2h
              executable
                  path /config/scripts/mytask
                  arguments "arg1 arg2 arg3"
          task anothertask
              cron-spec "* * * 1 *"
              executable
                  path /config/scripts/anothertask