1scrontab(1)                     Slurm Commands                     scrontab(1)
2
3
4

NAME

6       scrontab - manage Slurm crontab files
7
8

SYNOPSIS

10       scrontab [-u user] file
11       scrontab [-u user] [ -e | -l | -r ]
12
13

DESCRIPTION

15       scrontab  is  used  to  set,  edit,  and  remove a user's Slurm-managed
16       crontab.  This file can define a number of recurring batch jobs to  run
17       on a scheduled interval.
18
19       Lines  must  be  either  comments  starting with '#', whitespace, valid
20       crontab entries or custom variable settings.
21
22       Lines starting with #SCRON allow options to be defined for  the  single
23       following  crontab  entry.  Options  are  always  reset in between each
24       crontab entry. Options include most of those available  to  the  sbatch
25       command; details are available in the sbatch(1) man page.
26
27       Note  that  jobs  are  not guaranteed to execute at the preferred time.
28       Jobs will run no more frequently than requested,  but  are  managed  by
29       setting  the  BeginTime field to the next valid iteration, and are then
30       subject to queuing delays. The exact behavior will depend on the  local
31       site configuration.  Because of this method of implementation, the next
32       job in the series won't be submitted until after the previous  job  has
33       completed.  For example, if you have a monitoring job that is scheduled
34       to run every minute on a busy system, if the job scheduled to start  at
35       08:20:00  isn't able to start until 08:20:30 and it runs for 35 seconds
36       then the job at 08:21:00 will be skipped  and  the  next  job  will  be
37       scheduled for 08:22:00.
38
39       scrontab  uses  the  same  syntax for date and time specifiers as cron.
40       Each line has five fields that have the following meanings:
41              field           allowed values
42              -----           --------------
43              minute          0-59
44              hour            0-23
45              day of month    1-31
46              month           1-12 (or name)
47              day of week     0-7 (0 and 7 are Sunday, or use name)
48
49
50       A field can contain an asterisk (*) which means  that  it's  valid  for
51       each  of  the  allowed values for the given time period. Ranges are al‐
52       lowed where a range is two numbers with a  hyphen  between  them.   The
53       second  number  must be greater than the first. Lists are allowed, with
54       commas separating the numbers or ranges being  separated.  Step  values
55       can  be  specified by entering a slash (/), followed by the step value,
56       causing the job to run at the specified interval appropriate  for  that
57       field.
58
59
60       Custom  variables can be defined as within a regular shell script.  The
61       `$' character introduces variable expansion. Simple parameter expansion
62       is  the only currently accepted expansion variant (i.e. ${parameter} or
63       ${parameter:-word} are not supported). The variable expansion will only
64       occur  within scrontab job commands. It is not possible to expand vari‐
65       ables in other type of lines (other variable definitions,  comments  or
66       crontab  entries). The expansion will happen before submitting the job,
67       but the variable definitions will remain in the scrontab script. Unlike
68       crontab, the user environment variables are ignored.
69
70

OPTIONS

72       The  first  form  of this command is used to install a new crontab from
73       some named file or standard  input  if  the  pseudo-filename  ``-''  is
74       given.
75
76       -e     Edit the crontab. If a crontab does not exist already, a default
77              example (without any defined entries) will be  provided  in  the
78              editor.
79
80
81       -l     List the crontab. (Prints directly to stdout.)
82
83
84       -r     Remove  the  crontab. Any currently running crontab-defined jobs
85              will continue to  run  but  will  no  longer  recur.  All  other
86              crontab-defined jobs will be cancelled.
87
88
89       -u <user>
90              Edit  or  view  a different user's crontab. Listing is permitted
91              for Operators and Admins. Editing/removal is only permitted  for
92              root and the SlurmUser account.
93
94

SCRONTAB OPTIONS

96       scrontab allows you to use shortcuts to specify some common time inter‐
97       vals for the specified script to run.  These include the following:
98
99       @yearly | @annually
100              Job will become eligible at 00:00 Jan 01 each year.
101
102
103       @monthly
104              Job will become eligible at 00:00  on  the  first  day  of  each
105              month.
106
107
108       @weekly
109              Job will become eligible at 00:00 Sunday of each week.
110
111
112       @daily | @midnight
113              Job will become eligible at 00:00 each day.
114
115
116       @hourly
117              Job will become eligible at the first minute of each hour.
118
119

ENVIRONMENT VARIABLES

121       VISUAL              Used as the interactive editor if set.
122
123
124       EDITOR              Used  as  the interfactive editor if set and VISUAL
125                           is not defined.
126
127
128       SLURM_CONF          The location of the Slurm configuration file.
129
130

NOTES

132       scrontab is only available if  the  ScronParameters=enable  option  has
133       been  enabled in the slurm.conf.  scrontab will create a temporary file
134       in the directory set by TMPDIR environment variable, if the variable is
135       not set /tmp is used.
136
137

EXAMPLES

139       To create a job that would run at the beginning of each hour, using the
140       'high' partition, 'sub1' account and have a walltime of 1  minute,  you
141       would add the following to scrontab:
142
143              DIR=/home/user1
144              #SCRON -p high
145              #SCRON -A sub1
146              #SCRON -t 1:00
147              @hourly $DIR/date.printer.job
148
149
150       To  have  a  job  run every Wednesday, every other hour during the work
151       day, each of the first five minutes of the hour and again at the thirty
152       minute mark, you would add the following to scrontab.
153
154              1-5,30 8-17/2 * * wed $DIR/example.job
155
156

LIMITATIONS

158       The  Slurm  controller's timezone is what will be used to evaluate each
159       crontab's repetition intervals. User-specific timezones  are  not  sup‐
160       ported.
161
162

COPYING

164       Copyright (C) 2020-2021 SchedMD LLC.
165
166       This  file  is  part  of Slurm, a resource management program.  For de‐
167       tails, see <https://slurm.schedmd.com/>.
168
169       Slurm is free software; you can redistribute it and/or modify it  under
170       the  terms  of  the GNU General Public License as published by the Free
171       Software Foundation; either version 2 of the License, or (at  your  op‐
172       tion) any later version.
173
174       Slurm  is  distributed  in the hope that it will be useful, but WITHOUT
175       ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY  or
176       FITNESS  FOR  A PARTICULAR PURPOSE.  See the GNU General Public License
177       for more details.
178
179

SEE ALSO

181       sbatch(1), squeue(1), slurm.conf(5)
182
183
184
185July 2021                       Slurm Commands                     scrontab(1)
Impressum