Background indexing with Zebra

From Koha Wiki
Jump to navigation Jump to search

NOTE: These instructions are incredibly old and talk about an unsupported version of Koha..

Note: This instructions apply to source install of Koha 3.12 onwards. If you want to use it in a previous version, please refer to the download instructions on the bottom of this page. If you need/want to use this feature in koha-common packages installs take a look at bug 8773 and help us testing and signing.

Install Tamil's indexer

In order to have background indexing in your Koha setup you need to use an indexer daemon written by Frédéric Demians which is included in the Koha::Contrib::Tamil perl package (outside Koha).

Install Tamil's package. For Debian-based operating systems (Debian, Ubuntu, etc.) use the Koha repository (squeeze-dev):

sudo apt-get install libkoha-contrib-tamil-perl

Otherwise, use cpan:

sudo cpan Koha::Contrib::Tamil

Setup the startup service

After that you need to set the daemon to run on startup:

sudo ln -s /usr/share/koha/bin/koha-index-daemon-ctl.sh /etc/init.d/koha-index-daemon
sudo update-rc.d koha-index-daemon defaults
sudo service koha-index-daemon start

Handy tools included

After you installed Koha::Contrib::Tamil you will have a few new commands you can use:

  • koha-index
  • koha-index-daemon


You can access their respective man pages:

man koha-index
man koha-index-daemon

koha-index will help you reindex your zebra DB anytime you need it like this (standard env variable being set):

koha-index --verbose
koha-index --source authority --verbose


Pre-3.12 users

As the needed script is not included in previous versions you need to download it from here and place it on the /usr/share/koha/bin dir (change if not standard setup).

After dowloading please fix the scripts variables like this

USER=koha
GROUP=koha
DBNAME=your_kohas_db_name
NAME=koha-index-daemon-ctl-$DBNAME
LOGDIR=/var/log/koha
PERL5LIB=/usr/share/koha/lib
KOHA_CONF=/etc/koha/koha-conf.xml
ERRLOG=$LOGDIR/koha-index-daemon.err
STDOUT=$LOGDIR/koha-index-daemon.log
OUTPUT=$LOGDIR/koha-index-daemon-output.log