From e03cd35d3778d5278d7618703572fe457a3adbda Mon Sep 17 00:00:00 2001 From: "Zeno Tajoli tajoli@cilea.it" Date: Tue, 20 Mar 2012 16:31:20 +0100 Subject: [PATCH] Bug 7759, update of install files to use background indexing Content-Type: text/plain; charset="utf-8" --- INSTALL | 1 + INSTALL.debian | 10 +++++++--- INSTALL.fedora7 | 5 +++++ INSTALL.opensuse | 24 +++++++++++++++++++++++- INSTALL.ubuntu | 14 +++++++++----- INSTALL.ubuntu.lucid | 14 +++++++++----- 6 files changed, 54 insertions(+), 14 deletions(-) diff --git a/INSTALL b/INSTALL index c4e51bc..0c48250 100644 --- a/INSTALL +++ b/INSTALL @@ -128,6 +128,7 @@ WHAT NEXT? 4. Schedule regular index updates run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example for usage examples + You can also setup indexing in background, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra 5. To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and change the options to listen on a TCP port; then restart the zebra daemon. diff --git a/INSTALL.debian b/INSTALL.debian index c423473..a87147c 100644 --- a/INSTALL.debian +++ b/INSTALL.debian @@ -8,7 +8,7 @@ Some parts copyright 2011 MJ Ray and software.coop Feedback/bug reports: Koha Developer's List: http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel -This document last modified: 2011-06-19 +This document last modified: 2012-March-20 Installation Instructions ============================= @@ -280,6 +280,8 @@ For Zebra indexing, you are looking for the example that begins with It may be easiest to copy/paste the example into your own crontab and modify as necessary. +You can also indexing in background, see: http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra + 7. What next? @@ -306,11 +308,13 @@ Authority data in MARC21 format Once the indexing has completed, you will be able to search for records in your system. NOTE: This script should be run as the kohauser (the default is 'koha', this is the user we set up in step 2.3). -7.3 Schedule regular index updates +7.3 Schedule regular index updates or setup indexing in background You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above. NOTE: This job should be setup under the kohauser (the default is 'koha', this is the user we set up in step 2.3). - + + To setup indexing in background see 6.2.2 + 7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and change the options to listen on a TCP port; then restart the zebra daemon. diff --git a/INSTALL.fedora7 b/INSTALL.fedora7 index 5e5f0d4..c1f84cf 100644 --- a/INSTALL.fedora7 +++ b/INSTALL.fedora7 @@ -1,3 +1,8 @@ +THIS FILE IS TOO OLD AND NOT UPDATED. +CHECK KOHA WIKI:http://wiki.koha-community.org +CHECK OTHERS INSTALL FILES +ASK IN KOHA MAILING LIST + ============================= Installation Guide for Installing Koha on Fedora Core 7 ============================= diff --git a/INSTALL.opensuse b/INSTALL.opensuse index b028fd3..0c54f48 100644 --- a/INSTALL.opensuse +++ b/INSTALL.opensuse @@ -9,7 +9,7 @@ Feedback/bug reports: Koha Developer's List: http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel -This document last modified: 15 Oct 2010 +This document last modified: 20 Mar 2012 == Installation Instructions == @@ -1355,3 +1355,25 @@ If not you may have forgotten to open the 8080 port. You may now login with your koha administrator username and password and reply to the several questions you will be asked. +== Add Zebra Indexer == + +Add an entry in Koha user crontab to process scheduled added/updated/deleted records +indexing by Zebra. cronjobs/crontab.example contains examples for these cron jobs (and many more). + +NOTE: The cronjobs should be setup under the kohauser (the default is 'koha', but +this is the user you set up in section 'Create the Koha User and Group'). + +Edit the crontab for the koha user by running + $ sudo -u crontab -e + +For Zebra indexing, you are looking for the example that begins with + + # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day + # for both authorities and bibs + +It may be easiest to copy/paste the example into your own crontab and modify as necessary. + +You can also indexing in background, see: http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra + + + diff --git a/INSTALL.ubuntu b/INSTALL.ubuntu index 2bedddc..961390b 100644 --- a/INSTALL.ubuntu +++ b/INSTALL.ubuntu @@ -11,7 +11,7 @@ Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu) Feedback/bug reports: Koha Developer's List: http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel -This document last modified: 19 May 2010 +This document last modified: 20 March 2010 Installation Instructions ============================= @@ -283,7 +283,7 @@ To add a user do: Option 1: run the Zebra processes from the command line: -1.1 Zebra Search Server +5.1.1 Zebra Search Server This process send responses to search requests sent by Koha or Z39.50/SRU/SRW clients. @@ -296,7 +296,7 @@ Note: the user you run Zebra as will be the only user with write permission on the Zebra index; in development mode, you may wish to use your system user. -1.2 Zebra Indexer +5.1.2 Zebra Indexer Added/updated/deleted records in Koha MySQL database must be indexed into Zebra. A specific script must be launched each time a bibliographic @@ -310,7 +310,7 @@ Option 2: run the Zebra process as a daemon, and add to startup process: Note that references to $SCRIPT_DIR refer to the directory where Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. -1.1 Zebra Search Server +5.2.1 Zebra Search Server $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install) @@ -319,7 +319,7 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start -1.2 Zebra Indexer +5.2.2 Zebra Indexer Add an entry in Koha user crontab to scheduled added/updated/deleted records indexing by Zebra with this command: @@ -329,6 +329,8 @@ indexing by Zebra with this command: See check misc/cronjobs/crontab.example for usage examples. NOTE: This job should be setup under the kohauser (the default is 'koha'). +You can also indexing in background, see: http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra + 6. Run the Web Installer, populate the database, initial configuration of settings Point your browser to http://:8080/ @@ -362,6 +364,8 @@ NOTE: This job should be setup under the kohauser (the default is 'koha'). You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above. NOTE: This job should be setup under the kohauser (the default is 'koha'). + + You can also indexing in background, see 5.2.2 above 7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and change the options to listen on a TCP port; then restart the zebra daemon. diff --git a/INSTALL.ubuntu.lucid b/INSTALL.ubuntu.lucid index 562dafd..6d8158f 100644 --- a/INSTALL.ubuntu.lucid +++ b/INSTALL.ubuntu.lucid @@ -11,7 +11,7 @@ Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu) Feedback/bug reports: Koha Developer's List: http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel -This document last modified: 11 Sep 2010 +This document last modified: 20 Marchp 2012 Installation Instructions ============================= @@ -217,7 +217,7 @@ To add a user do: Option 1: run the Zebra processes from the command line: -1.1 Zebra Search Server +5.1.1 Zebra Search Server This process send responses to search requests sent by Koha or Z39.50/SRU/SRW clients. @@ -230,7 +230,7 @@ Note: the user you run Zebra as will be the only user with write permission on the Zebra index; in development mode, you may wish to use your system user. -1.2 Zebra Indexer +5.1.2 Zebra Indexer Added/updated/deleted records in Koha MySQL database must be indexed into Zebra. A specific script must be launched each time a bibliographic @@ -244,7 +244,7 @@ Option 2: run the Zebra process as a daemon, and add to startup process: Note that references to $SCRIPT_DIR refer to the directory where Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. -1.1 Zebra Search Server +5.2.1 Zebra Search Server $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install) @@ -253,7 +253,7 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start -1.2 Zebra Indexer +5.2.2 Zebra Indexer Add an entry in Koha user crontab to scheduled added/updated/deleted records indexing by Zebra with this command: @@ -263,6 +263,8 @@ indexing by Zebra with this command: See check misc/cronjobs/crontab.example for usage examples. NOTE: This job should be setup under the kohauser (the default is 'koha'). +You can also indexing in background, see: http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra + 6. Run the Web Installer, populate the database, initial configuration of settings Point your browser to http://:8080/ @@ -296,6 +298,8 @@ NOTE: This job should be setup under the kohauser (the default is 'koha'). You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above. NOTE: This job should be setup under the kohauser (the default is 'koha'). + + You can also indexing in background, see 5.2.2 above 7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and change the options to listen on a TCP port; then restart the zebra daemon. -- 1.7.5.4