Too many people have been confused about crontab dependent functions
"not working" automatically on their installations. This is probably
because there was no explicit step telling them to schedule the jobs.
The maintainers of the other INSTALL.* docs would be well advised
to insert similar lines in their docs, after confirming proper operation,
since cron/crontab are very system dependent.
---
INSTALL.debian | 30 +++++++++++++++++++++++++-----
1 files changed, 25 insertions(+), 5 deletions(-)
diff --git a/INSTALL.debian b/INSTALL.debian
index 139a2f3..885f3f9 100644
--- a/INSTALL.debian
+++ b/INSTALL.debian
@@ -300,8 +300,8 @@ virtual hosts for full instructions.
Note: it's recommended that you daemonize the Zebra process and add it to your
startup profile. For a non-production test/development installation, running
-Zebra from the command line can be useful. Pick from the two available options
-below, or roll your own :-)
+Zebra from the command line can be useful. Otherwise you will want zebrasrv
+running when Apache/Koha is.
Note: it's also recommended that you create a Koha system user, which you will
have specified during the install process. Alternatively, Zebra can be
@@ -318,7 +318,7 @@ Option 1: run the Zebra processes from the command line:
on the Zebra index; in development mode, you may wish to use your system
user.
- Zebraqueue Daemon:
+ Zebraqueue Daemon (not recommended -- use rebuild_zebra in crontab
instead):
$ sudo -u ${KOHA_USER} misc/bin/zebraqueue_daemon.pl
Note: if you are running in this mode, you may wish to defer starting the
@@ -337,7 +337,7 @@ Koha's command-line scripts are installed, e.g.,
/usr/share/koha/bin.
$ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
- Zebraqueue Daemon:
+ Zebraqueue Daemon (not recommended -- use rebuild_zebra in crontab
instead):
$ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh
/etc/init.d/koha-zebraqueue-daemon
$ sudo update-rc.d koha-zebraqueue-daemon defaults
( Note: see man chkconfig(8) on other distros )
@@ -360,6 +360,25 @@ Koha's command-line scripts are installed, e.g.,
/usr/share/koha/bin.
$ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
(note: use the correct path to your koha-conf.xml)
+7.0 Schedule crontab jobs
+ Do you want Koha to:
+ send mail?
+ automatically index added records?
+ generate overdue or advance notices?
+ mark items lost after they are long overdue?
+ assess fines?
+
+ All these and other regularly scheduled background tasks are handled by
crontab.
+ You need to examine the example crontab file, edit a copy to your liking,
and schedule it.
+
+ $ crontab -l # just check if you have any other jobs already
scheduled
+ $ cp ./misc/cronjobs/crontab.example my_crontab
+ $ vi my_crontab # select jobs or adjust times.
+ $ # If you had already scheduled lines, add them at
the bottom.
+ $ crontab my_crontab # This overwrites your scheduled jobs with the new
ones.
+
+ If you want to check to confirm, you can run crontab -l again.
+
7.1 Import:
Bibliographic data in MARC21 format
$ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
@@ -376,7 +395,8 @@ Koha's command-line scripts are installed, e.g.,
/usr/share/koha/bin.
7.3 Schedule regular index updates
run rebuild_zebra.pl -b -a -z as a regular cron job, check
misc/cronjobs/crontab.example
- for usage examples
+ for usage examples. Do not schedule rebuild_zebra AND run zebraqueue.
Pick one or the other.
+ See 7.0 above.
7.4 To enable public Z39.50/SRU servers, you'll need to edit your
koha-conf.xml and
change the <listen> options to listen on a TCP port; then restart the
zebra daemon.
--
1.5.6.5
_______________________________________________
Koha-patches mailing list
[email protected]
http://lists.koha.org/mailman/listinfo/koha-patches
