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
This commit is contained in:
Joshua Ferraro 2008-08-09 07:03:37 -05:00
parent 569f54a9e2
commit 11e9319ece
2 changed files with 52 additions and 9 deletions

39
INSTALL
View File

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

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