Skip to content

Commit 11e9319

Browse files
author
Joshua Ferraro
committed
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
1 parent 569f54a commit 11e9319

File tree

2 files changed

+52
-9
lines changed

2 files changed

+52
-9
lines changed

INSTALL

+38-1
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ PostgreSQL 8.2.5: Create a database called 'koha,' owned by 'kohaadmin'
2929
user, with a password set. Note: kohaadmin must be a superuser. You
3030
must also add plpgsql to the koha database. NOTE: PostgreSQL support in
3131
Koha is experimental and should not be attempted for production systems
32-
without a heavy investment in testing
32+
without a heavy investment in testing.
3333

3434
Default installation instructions:
3535

@@ -83,6 +83,43 @@ use the following:
8383
make test
8484
sudo make upgrade
8585

86+
WHAT NEXT?
87+
88+
1. Running the Web Installer allows you to install sample data for libraries, patrons, etc.
89+
but you may want to install additional data such as bibliographic and authorities.
90+
91+
Once the installer has completed, you can import and index MARC records from the
92+
command line thusly (Note: you can also use the 'Stage MARC records for import' from
93+
the Tools area of Koha's Staff Client to import a batch of MARC records):
94+
95+
$ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
96+
(note: use the correct path to your koha-conf.xml)
97+
98+
2. Import:
99+
Bibliographic data in MARC21 format
100+
$ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
101+
Authority data in MARC21 format
102+
$ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709
103+
104+
3. Fast Index:
105+
$ misc/migration-tools/rebuild_zebra.pl -b -w
106+
107+
Once the indexing has completed, you will be able to search for records in your
108+
system. NOTE: if you don't run the Fast Index utility, and you have the index
109+
updates scheduled as per 7.3 the indexing process will happen in the background,
110+
Once the indexing has completed, you will be able to search for records in your
111+
system. NOTE: if you don't run the Fast Index utility, and you have the index
112+
updates scheduled as per 7.3 the indexing process will happen in the background,
113+
but it will be orders of magnitude slower.
114+
115+
4. Schedule regular index updates
116+
run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example
117+
for usage examples
118+
119+
5. To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
120+
change the <listen> options to listen on a TCP port; then restart the zebra daemon.
121+
122+
86123
IF YOU HAVE PROBLEMS
87124
====================
88125

INSTALL.debian

+14-8
Original file line numberDiff line numberDiff line change
@@ -350,18 +350,25 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
350350
(note: use the correct path to your koha-conf.xml)
351351

352352
7.1 Import:
353+
Bibliographic data in MARC21 format
353354
$ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
355+
Authority data in MARC21 format
356+
$ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709
354357

355358
7.2 Fast Index:
356359
$ misc/migration-tools/rebuild_zebra.pl -b -w
357360

358361
Once the indexing has completed, you will be able to search for records in your
359-
system. NOTE: if you don't run the Fast Index utility, and you have the zebraqueue
360-
daemon running, the indexin process will happen in the background, but it will be
361-
orders of magnitude slower.
362+
system. NOTE: if you don't run the Fast Index utility, and you have the index
363+
updates scheduled as per 7.3 the indexing process will happen in the background,
364+
but it will be orders of magnitude slower.
362365

363-
To enable the SRU servers, you'll need to edit your koha-conf.xml and change the
364-
<listen> options to listen on a TCP port; then restart the zebra daemon.
366+
7.3 Schedule regular index updates
367+
run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example
368+
for usage examples
369+
370+
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
371+
change the <listen> options to listen on a TCP port; then restart the zebra daemon.
365372

366373
UPGRADE
367374
=======
@@ -381,11 +388,9 @@ Uninstall Instructions
381388
$ sudo apache2ctl restart
382389

383390
$ sudo update-rc.d koha-zebra-daemon remove
384-
$ sudo update-rc.d koha-zebraqueue-daemon remove
385391
$ sudo rm /etc/init.d/koha-zebra-daemon
386-
$ sudo rm /etc/init.d/koha-zebraqueue-daemon
387392

388-
2) Remove Koha Databases
393+
2) Remove Database and Indexes
389394

390395
# MySQL
391396
$ mysql -u<kohauser> -p<kohapassword>
@@ -396,6 +401,7 @@ Uninstall Instructions
396401
$ zebraidx -c <prefix>/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
397402

398403
3) Remove Koha Install Directories and Configuration Files
404+
Don't forget about any crontab entries
399405

400406
Tested on the following operating environments
401407
==============================================

0 commit comments

Comments
 (0)