Browse Source

Bug 7759, update of install files to use background indexing (and some whitespace tidy)

Signed-off-by: Mason James <mtj @ kohaaloha.com>
Signed-off-by: Paul Poulain <paul.poulain@biblibre.com>
3.8.x
tajoli@cilea.it 12 years ago
committed by Paul Poulain
parent
commit
dad005a8a1
  1. 8
      INSTALL
  2. 8
      INSTALL.debian
  3. 5
      INSTALL.fedora7
  4. 21
      INSTALL.opensuse
  5. 14
      INSTALL.ubuntu
  6. 14
      INSTALL.ubuntu.lucid

8
INSTALL

@ -122,17 +122,15 @@ WHAT NEXT?
3. Fast Index:
$ misc/migration_tools/rebuild_zebra.pl -b -w
Once the indexing has completed, you will be able to search for records in your
system. NOTE: if you don't run the Fast Index utility, and you have the index
updates scheduled as per 7.3 the indexing process will happen in the background,
Once the indexing has completed, you will be able to search for records in your
system. NOTE: if you don't run the Fast Index utility, and you have the index
updates scheduled as per 7.3 the indexing process will happen in the background,
but it will be orders of magnitude slower.
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
run rebuild_zebra.pl -b -a -z as a regular cron job, check the 'misc/cronjobs/crontab.example' file for usage examples
You can also configure zebra-indexing as an background daemon, 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 <listen> options to listen on a TCP port; then restart the zebra daemon.

8
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,7 @@ 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 configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
7. What next?
@ -306,11 +307,14 @@ 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 with cron ,or configure zebra indexing as a background daemon
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 <listen> options to listen on a TCP port; then restart the zebra daemon.

5
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
=============================

21
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,22 @@ 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. <script_dir>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 <kohauser> 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 configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra

14
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
=============================
@ -281,7 +281,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.
@ -294,7 +294,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
@ -308,7 +308,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)
@ -317,7 +317,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:
@ -327,6 +327,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 configure zebra-indexing as an background daemon, 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://<servername>:8080/
@ -361,6 +363,8 @@ NOTE: This job should be setup under the kohauser (the default is 'koha').
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 <listen> options to listen on a TCP port; then restart the zebra daemon.

14
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 configure zebra-indexing as an background daemon, 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://<servername>:8080/
@ -297,6 +299,8 @@ NOTE: This job should be setup under the kohauser (the default is 'koha').
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 <listen> options to listen on a TCP port; then restart the zebra daemon.

Loading…
Cancel
Save