Merge remote branch 'kc/master' into new/bug_3013
[koha.git] / misc / cronjobs / crontab.example
1 # Koha Example Crontab File
2 # Author: Joe Atzberger <atz@liblime.com>
3 #
4 # This is an example of a crontab file for Debian.  It may not work 
5 # in other versions of crontab, like on Solaris 8 or BSD, for example.
6
7 # While similar in structure, 
8 # this is NOT an example for cron (as root).  Cron takes an extra
9 # argument per line to designate the user to run as.  You could 
10 # reasonably extrapolate the needed info from here though.
11 #
12 # WARNING: These jobs will do things like charge fines, send
13 # potentially VERY MANY emails to patrons and even debar offending
14 # users.  DO NOT RUN OR SCHEDULE these jobs without being sure you
15 # really intend to.  Make sure the relevant message templates are
16 # configured to your liking before scheduling messages to be sent.
17 #
18 # ENVIRONMENT:
19 # First, establish Koha's two important ENV variables.
20
21 PERL5LIB=/usr/share/koha/lib
22 KOHA_CONF=/etc/koha/koha-conf.xml
23
24 # Some additional variables to save you typing
25 KOHA_CRON_PATH = /usr/share/koha/bin/cronjobs
26 #
27 # MULTIPLE KOHA SUPPORT:
28 # You can still run jobs for this user's additional koha installs, 
29 # by manipulating those variables in the command.
30 #
31 # For example, on the same codebase:
32 # */10 * * * *    KOHA_CONF=/etc/koha/koha-conf.xml /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -a -z >/dev/null
33 #
34 # For example, on a separate codebase:
35 # */10 * * * *    KOHA_CONF=/etc/koha/koha-conf.xml PERL5LIB=/home/koha/kohaclone /home/koha/kohaclone/misc/migration_tools/rebuild_zebra.pl -b -a -z >/dev/null
36
37 # ADDITIONAL INFO:
38 # See the perldoc of individual scripts to determine what other options
39 # are available.  Check the man page for crontab to understand the 
40 # schedule syntax for your system.  
41 #
42 # NOTE: Don't forget to keep the empty line at the bottom. 
43 # Cron/crontab will choke without it.
44 #
45 # SCHEDULED JOBS:
46 # m h  dom mon dow   command
47
48 # OVERDUE NOTICES
49 0    1 * * *  $KOHA_CRON_PATH/overdue_notices.pl -t
50
51 # FINES
52 5    1 * * *  $KOHA_CRON_PATH/fines.pl
53
54 # ADVANCE NOTICES
55 10   1 * * *  $KOHA_CRON_PATH/advance_notices.pl -c
56
57 # PROCESS LONG OVERDUES
58 # updates item status from available to longoverdue for items long overdue
59 # 19 1 * * *  $KOHA_CRON_PATH/longoverdue.pl --lost 90=1 --confirm
60
61 # SEND EMAILS
62 15   * * * *  $KOHA_CRON_PATH/process_message_queue.pl
63
64 # Hourly holds queue updated
65 52   * * * *  $KOHA_CRON_PATH/holds/build_holds_queue.pl >/dev/null 2>&1
66
67 # Cancel expired holds
68 0 1 * * *  $KOHA_CRON_PATH/holds/cancel_expired_holds.pl >/dev/null 2>&1
69
70 # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day
71 # for both authorities and bibs
72 */10 * * * *  $KOHA_CRON_PATH/../migration_tools/rebuild_zebra.pl -b -a -z >/dev/null
73
74 # services_throttle -- resets the xISBN service
75 59 23 * * *  $KOHA_CRON_PATH/services_throttle.pl > /dev/null 2>&1
76
77 # clean up databases nightly.  Be sure not to run this with --sessions during a time when the system is in use!
78 16 1 * * * $KOHA_CRON_PATH/cleanup_database.pl --sessions --zebraqueue 10