Updates to the installation instructions
authorJoshua Ferraro <jmf@liblime.com>
Sat, 9 Aug 2008 12:03:37 +0000 (07:03 -0500)
committerJoshua Ferraro <jmf@liblime.com>
Sat, 9 Aug 2008 12:03:37 +0000 (07:03 -0500)
In particular, removing references to the zebraqueue daemon
and replacing with mention of the -z option with rebuild_zebra.pl

INSTALL
INSTALL.debian

diff --git a/INSTALL b/INSTALL
index 604c22f..df0990c 100644 (file)
--- 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 <listen> options to listen on a TCP port; then restart the zebra daemon.
+
+
 IF YOU HAVE PROBLEMS
 ====================
 
index 40d64fc..ea25e1f 100644 (file)
@@ -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
-    <listen> 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 <listen> 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<kohauser> -p<kohapassword>
@@ -396,6 +401,7 @@ Uninstall Instructions
    $ zebraidx -c <prefix>/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
 ==============================================