Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 106 lines (79 sloc) 3.756 kb
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
1 LibLime Koha 4 - The next-generation release of the award-winning Koha
2 open-source integrated library system.
61190e9 @mjray New installation instructions and release notes.
mjray authored
3
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
4 Koha is the first open-source Integrated Library System. Developed
5 initially in New Zealand by Katipo Communications, Ltd and first
6 deployed in January of 2000 for the Horowhenua Library Trust, it is
7 currently maintained by a team of software providers and library
8 technology staff from around the globe. Learn more about the Koha
9 project at http://koha.org/.
61190e9 @mjray New installation instructions and release notes.
mjray authored
10
11 INSTALLATION
12 ============
13
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
14 Koha runs on many Un*x-style systems, including a variety of Linux
15 distributions and Mac OS X.
61190e9 @mjray New installation instructions and release notes.
mjray authored
16
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
17 Koha depends on a number of configuration dependencies provided by the
18 system. Most notably, these include MySQL, IndexData's YAZ/Zebra
19 tools for MARC indexing, and Perl to tie all of these
20 together. Recommended versions are:
21
22 MySQL: >= 5.1.59
23 YAZ: >= 4.2.15
24 Zebra: >= 2.0.49
25 Perl: >= 5.10.1
26
27 Lesser versions may suffice in many cases. Higher versions are nearly
28 always better.
29
30 It's advisable to use your system's package maanger to install the
31 MySQL, YAZ, and Zebra. However, it is *not* advisable to fuss about
32 too much--if at all--with the system-installed Perl. Installing the
33 hundreds of packages required by Koha can give rise to oddities in
34 version dependency chains and break system-level tools. Instead, using
35 a tool like Perlbrew enables you to create a whole separate Perl
36 instance and install all the of CPAN modules that Koha needs into
37 there. These instructions will assume a Perlbrew-based Perl
38 installation.
9493e1f adding warnings for CGI::Session
Joshua Ferraro authored
39
e691336 Updated README.txt to include PostgreSQL notes
Chris Nighswonger authored
40 MySQL 5: Create a database called 'koha,' owned by 'kohaadmin'
41 user, with a password set. Note: kohaadmin must have at least the
69340bf installer: updated required MySQL user grants
Galen Charlton authored
42 following privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,
43 ALTER, and LOCK TABLES.
e691336 Updated README.txt to include PostgreSQL notes
Chris Nighswonger authored
44
61190e9 @mjray New installation instructions and release notes.
mjray authored
45 Default installation instructions:
46
47 1. perl Makefile.PL
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
48 (you will be prompted to answer a number of questions)
49 2. (Install any missing dependencies indicated by make.)
50 3. make
51 4. make test
52 5. make install
53 6. KOHA_CONF=~/koha-dev/etc/koha-conf.xml plackup app.psgi
54
55 Finally, browse to http://servername-staff:5000/ and answer the
56 questions to complete the installation.
57
58 The defaults will install Koha to places that follow relevant
59 standards, such as the File Hierarchy Standard. If you want to install
60 Koha to a different directory like /opt/koha, then replace step 1 with
61 (for example):
3d1fb44 nomenclature improvements, updating README.txt
Joshua Ferraro authored
62
54e17e1 installer: starting some changes to README.txt
Galen Charlton authored
63 1. perl Makefile.PL INTRANET_CGI_DIR=/www/cgi-bin
2fa1116 @mjray Update instructions about MySQL and Zebra
mjray authored
64
e691336 Updated README.txt to include PostgreSQL notes
Chris Nighswonger authored
65 You can change most of the defaults in a similar way, such as DB_HOST.
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
66 For full instructions on how to override the default settings, run:
3d1fb44 nomenclature improvements, updating README.txt
Joshua Ferraro authored
67
65c19cc @ctfliblime Moving everything around and ditching kohaversion.pl
ctfliblime authored
68 $ perldoc installer/rewrite-config.PL
61190e9 @mjray New installation instructions and release notes.
mjray authored
69
11e9319 Updates to the installation instructions
Joshua Ferraro authored
70 WHAT NEXT?
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
71 ==========
11e9319 Updates to the installation instructions
Joshua Ferraro authored
72
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
73 1. Running the Web Installer allows you to install sample data for
74 libraries, patrons, etc. You may want to install additional data
75 such as bibliographic and authorities records.
11e9319 Updates to the installation instructions
Joshua Ferraro authored
76
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
77 Note: you can also use the 'Stage MARC records for import' from
78 the Tools area of Koha's Staff Client to import a batch of MARC
79 records.
11e9319 Updates to the installation instructions
Joshua Ferraro authored
80
81 2. Import:
82 Bibliographic data in MARC21 format
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
83 $ ./misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
11e9319 Updates to the installation instructions
Joshua Ferraro authored
84 Authority data in MARC21 format
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
85 $ ./misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709
11e9319 Updates to the installation instructions
Joshua Ferraro authored
86
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
87 3. Zebra Index:
88 $ ./misc/migration-tools/rebuild_zebra.pl -b -w
11e9319 Updates to the installation instructions
Joshua Ferraro authored
89
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
90 Once the indexing has completed, you will be able to search for
91 records in your system.
11e9319 Updates to the installation instructions
Joshua Ferraro authored
92
93 4. Schedule regular index updates
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
94 run "rebuild_zebra.pl -b -a -z" as a regular cron job, check
95 misc/cronjobs/crontab.example for usage examples
11e9319 Updates to the installation instructions
Joshua Ferraro authored
96
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
97 5. To enable public Z39.50/SRU servers, you'll need to edit your
98 koha-conf.xml and change the <listen> options to listen on a TCP
99 port, then restart the zebra daemon.
11e9319 Updates to the installation instructions
Joshua Ferraro authored
100
101
81a5e0f @mjray Update instructions to match latest installer settings.
mjray authored
102 IF YOU HAVE PROBLEMS
103 ====================
104
6646d3e @ctfliblime Update INSTALL and README
ctfliblime authored
105 Please see the support pages at http://koha.org/.
Something went wrong with that request. Please try again.