-
Notifications
You must be signed in to change notification settings - Fork 54
/
INSTALL
105 lines (79 loc) · 3.67 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
LibLime Koha 4 - The next-generation release of the award-winning Koha
open-source integrated library system.
Koha is the first open-source Integrated Library System. Developed
initially in New Zealand by Katipo Communications, Ltd and first
deployed in January of 2000 for the Horowhenua Library Trust, it is
currently maintained by a team of software providers and library
technology staff from around the globe. Learn more about the Koha
project at http://koha.org/.
INSTALLATION
============
Koha runs on many Un*x-style systems, including a variety of Linux
distributions and Mac OS X.
Koha depends on a number of configuration dependencies provided by the
system. Most notably, these include MySQL, IndexData's YAZ/Zebra
tools for MARC indexing, and Perl to tie all of these
together. Recommended versions are:
MySQL: >= 5.1.59
YAZ: >= 4.2.15
Zebra: >= 2.0.49
Perl: >= 5.10.1
Lesser versions may suffice in many cases. Higher versions are nearly
always better.
It's advisable to use your system's package maanger to install the
MySQL, YAZ, and Zebra. However, it is *not* advisable to fuss about
too much--if at all--with the system-installed Perl. Installing the
hundreds of packages required by Koha can give rise to oddities in
version dependency chains and break system-level tools. Instead, using
a tool like Perlbrew enables you to create a whole separate Perl
instance and install all the of CPAN modules that Koha needs into
there. These instructions will assume a Perlbrew-based Perl
installation.
MySQL 5: Create a database called 'koha,' owned by 'kohaadmin'
user, with a password set. Note: kohaadmin must have at least the
following privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,
ALTER, and LOCK TABLES.
Default installation instructions:
1. perl Makefile.PL
(you will be prompted to answer a number of questions)
2. (Install any missing dependencies indicated by make.)
3. make
4. make test
5. make install
6. KOHA_CONF=~/koha-dev/etc/koha-conf.xml plackup app.psgi
Finally, browse to http://servername-staff:5000/ and answer the
questions to complete the installation.
The defaults will install Koha to places that follow relevant
standards, such as the File Hierarchy Standard. If you want to install
Koha to a different directory like /opt/koha, then replace step 1 with
(for example):
1. perl Makefile.PL INTRANET_CGI_DIR=/www/cgi-bin
You can change most of the defaults in a similar way, such as DB_HOST.
For full instructions on how to override the default settings, run:
$ perldoc installer/rewrite-config.PL
WHAT NEXT?
==========
1. Running the Web Installer allows you to install sample data for
libraries, patrons, etc. You may want to install additional data
such as bibliographic and authorities records.
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.
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. Zebra 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.
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
====================
Please see the support pages at http://koha.org/.