From 11e9319eceaa3cf909781535f3669962544faccc Mon Sep 17 00:00:00 2001 From: Joshua Ferraro Date: Sat, 9 Aug 2008 07:03:37 -0500 Subject: [PATCH] Updates to the installation instructions In particular, removing references to the zebraqueue daemon and replacing with mention of the -z option with rebuild_zebra.pl --- INSTALL | 39 ++++++++++++++++++++++++++++++++++++++- INSTALL.debian | 22 ++++++++++++++-------- 2 files changed, 52 insertions(+), 9 deletions(-) diff --git a/INSTALL b/INSTALL index 604c22f2c9..df0990c85e 100644 --- a/INSTALL +++ b/INSTALL @@ -29,7 +29,7 @@ PostgreSQL 8.2.5: Create a database called 'koha,' owned by 'kohaadmin' user, with a password set. Note: kohaadmin must be a superuser. You must also add plpgsql to the koha database. NOTE: PostgreSQL support in Koha is experimental and should not be attempted for production systems -without a heavy investment in testing +without a heavy investment in testing. Default installation instructions: @@ -83,6 +83,43 @@ use the following: make test sudo make upgrade +WHAT NEXT? + +1. Running the Web Installer allows you to install sample data for libraries, patrons, etc. + but you may want to install additional data such as bibliographic and authorities. + + Once the installer has completed, you can import and index MARC records from the + command line thusly (Note: you can also use the 'Stage MARC records for import' from + the Tools area of Koha's Staff Client to import a batch of MARC records): + + $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml + (note: use the correct path to your koha-conf.xml) + +2. Import: + Bibliographic data in MARC21 format + $ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709 + Authority data in MARC21 format + $ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709 + +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 + +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. + + IF YOU HAVE PROBLEMS ==================== diff --git a/INSTALL.debian b/INSTALL.debian index 40d64fcc67..ea25e1f831 100644 --- a/INSTALL.debian +++ b/INSTALL.debian @@ -350,18 +350,25 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. (note: use the correct path to your koha-conf.xml) 7.1 Import: + Bibliographic data in MARC21 format $ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709 + Authority data in MARC21 format + $ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709 7.2 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 zebraqueue - daemon running, the indexin process will happen in the background, but it will be - orders of magnitude slower. + 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. - To enable the 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. +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 + +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. UPGRADE ======= @@ -381,11 +388,9 @@ Uninstall Instructions $ sudo apache2ctl restart $ sudo update-rc.d koha-zebra-daemon remove - $ sudo update-rc.d koha-zebraqueue-daemon remove $ sudo rm /etc/init.d/koha-zebra-daemon - $ sudo rm /etc/init.d/koha-zebraqueue-daemon -2) Remove Koha Databases +2) Remove Database and Indexes # MySQL $ mysql -u -p @@ -396,6 +401,7 @@ Uninstall Instructions $ zebraidx -c /etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init 3) Remove Koha Install Directories and Configuration Files + Don't forget about any crontab entries Tested on the following operating environments ============================================== -- 2.20.1