System Settings/Task Scheduler: Difference between revisions

From KDE Wiki Sandbox
m (Fix title hierarchy)
(Marked this version for translation)
 
(8 intermediate revisions by 3 users not shown)
Line 3: Line 3:


== General Information == <!--T:1-->
== General Information == <!--T:1-->
<!--T:31-->
Task Scheduler is a graphical front end to the standard "cron" utility. With it, commands (or "tasks") can be run at specific times, on a certain day or date, or at specific intervals (time between execution).
Task Scheduler is a graphical front end to the standard "cron" utility. With it, commands (or "tasks") can be run at specific times, on a certain day or date, or at specific intervals (time between execution).
<!--T:32-->
[[Image:Kcron-screenshot-de.png|thumb|300px|center|Task Scheduler in Plasma 5]]
[[Image:Kcron-screenshot-de.png|thumb|300px|center|Task Scheduler in Plasma 5]]


Line 15: Line 19:


<!--T:12-->
<!--T:12-->
* Click "New Task..." to add a new task, or "Modify" to modify an existing task. The '''Add or modify existing task''' page will be displayed.
* Click <menuchoice>New Task...</menuchoice> to add a new task, or "Modify" to modify an existing task. The '''Add or modify existing task''' page will be displayed.


<!--T:13-->
<!--T:13-->
Line 36: Line 40:


<!--T:19-->
<!--T:19-->
* Using the buttons, choose when the command should be run. Not all parameters are required, those not needed may be left blank.
* Using the buttons, choose when the command should be run. Not all parameters are required, those not needed may be left blank.</translate>
<translate>
<!--T:33-->
** Hours and Minutes are the time of day to run the task, not an interval.
** Hours and Minutes are the time of day to run the task, not an interval.


<!--T:24-->
* When done, click <menuchoice>OK</menuchoice>. The task will be added and scheduled if enabled.
* When done, click <menuchoice>OK</menuchoice>. The task will be added and scheduled if enabled.
{{Tip|Click Run Now to run a task immediately after adding or modifying the task.}}
 
<!--T:25-->
{{Tip|Click <menuchoice>Run Now</menuchoice> to run a task immediately after adding or modifying the task.}}
 
=== Removing a task === <!--T:20-->
=== Removing a task === <!--T:20-->
<!--T:26-->
To completely remove a task, select the task from the list and click the '''Delete''' button. This will permanently remove the task.
To completely remove a task, select the task from the list and click the '''Delete''' button. This will permanently remove the task.


== Environment Variables == <!--T:21-->
== Environment Variables == <!--T:21-->
Sometimes a task or multiple tasks need a specific variable set, it must be added in the '''Environment Variables''' section. The '''cron''' utility uses its own environment, system wide and user specific variables are not used. Click '''New Variable''' to add a new variable definition, or '''Modify''' to change an existing variable.
 
* Enter the name of the variable to use. This name:
<!--T:27-->
** Must consist of letters, digits and underscore ('_') only
Sometimes a task or multiple tasks need a specific variable set, it must be added in the '''Environment Variables''' section. The '''cron''' utility uses its own environment, system-wide and user-specific variables are not used. Click '''New Variable''' to add a new variable definition, or '''Modify''' to change an existing variable.
** Must start with a latter
 
<!--T:28-->
* Enter the name of the variable to use. This name:</translate>
<translate>
<!--T:34-->
** Must consist of letters, digits, and underscore ('_') only</translate>
<translate>
<!--T:35-->
** Must start with a letter</translate>
<translate>
<!--T:36-->
** Should not be a reserved or commonly used system variable. See https://pubs.opengroup.org/onlinepubs/000095399/basedefs/xbd_chap08.html for more information
** Should not be a reserved or commonly used system variable. See https://pubs.opengroup.org/onlinepubs/000095399/basedefs/xbd_chap08.html for more information
<!--T:29-->
* The value the variable will contain. This can be a number or string.
* The value the variable will contain. This can be a number or string.
<!--T:30-->
* Enter a brief description of the variable.
* Enter a brief description of the variable.


Line 60: Line 86:
<!--T:9-->
<!--T:9-->
* The command-line tool that allows you to have a look at the currently installed cron-jobs is {{Input|1=crontab -l}} (that's the letter L).
* The command-line tool that allows you to have a look at the currently installed cron-jobs is {{Input|1=crontab -l}} (that's the letter L).
==More Information== <!--T:22-->
<!--T:23-->
* [https://docs.kde.org/stable5/en/kdeadmin/kcontrol5/kcron/index.html KDE official documentation]
* [https://en.wikipedia.org/wiki/Cron Cron] (Wikipedia)
* [https://wiki.archlinux.org/index.php/cron Cron] (Arch Linux wiki)


<!--T:10-->
<!--T:10-->
[[Category:Desktop]]
[[Category:System]]
[[Category:System]]
[[Category:Configuration]]
</translate>
</translate>

Latest revision as of 08:22, 1 June 2019

Other languages:

General Information

Task Scheduler is a graphical front end to the standard "cron" utility. With it, commands (or "tasks") can be run at specific times, on a certain day or date, or at specific intervals (time between execution).

Task Scheduler in Plasma 5

Usage

Task Scheduler can be started by starting the System Settings application. Select Startup and Shutdown follwed by Task Scheduler.

Adding and Modifying tasks

  • Click New Task... to add a new task, or "Modify" to modify an existing task. The Add or modify existing task page will be displayed.
The "Add or modify task" page of SystemSettings
  • Enter the command to be run. Click the folder icon to choose it from a dialog.
  • Enter a comment (optional). This should be descriptive, explaining what the task will do as the command may not always be obvious.
  • Click Enable this task to enable the task to run.
  • Click Run at system bootup to enable the script to run each time the system is booted.
  • Click Run every day to enable the script to run every day. This will automatically select the appropriate options.
  • Using the buttons, choose when the command should be run. Not all parameters are required, those not needed may be left blank.
    • Hours and Minutes are the time of day to run the task, not an interval.
  • When done, click OK. The task will be added and scheduled if enabled.
Tip
Click Run Now to run a task immediately after adding or modifying the task.


Removing a task

To completely remove a task, select the task from the list and click the Delete button. This will permanently remove the task.

Environment Variables

Sometimes a task or multiple tasks need a specific variable set, it must be added in the Environment Variables section. The cron utility uses its own environment, system-wide and user-specific variables are not used. Click New Variable to add a new variable definition, or Modify to change an existing variable.

  • The value the variable will contain. This can be a number or string.
  • Enter a brief description of the variable.

Hints

  • All the files that are modified are located in the /etc/cron directory where there are numerous files to look at.
  • The command-line tool that allows you to have a look at the currently installed cron-jobs is 
    crontab -l
    (that's the letter L).

More Information

Retrieved from "https://wikisandbox.kde.org/index.php?title=System_Settings/Task_Scheduler&oldid=427564"