-Koha 3 - the next-generation release of the award-winning Koha open-source
+Koha 3.2 - 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.
+more about the Koha project at http://koha-community.org.
INSTALLATION
============
-Koha 3 comes with a new installer, based on MakeMaker, the tool that
-is usually used to install CPAN modules. This means that if you know
-how to customise CPAN-installed modules, the same things should work
-for you with Koha. If not, don't worry. If you want to customise the
-installation more than described below, run "man ExtUtils::MakeMaker"
-
-You need to have a server running Perl 5.8, MySQL 5 or PostgreSQL 8.2.5, Zebra
+You need to have a server running Perl 5.8.8 or later, MySQL 5, Zebra
2.0.22 or greater and a webserver (preferably Apache2) before installing
Koha.
following privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,
ALTER, and LOCK TABLES.
-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.
-
Default installation instructions:
1. perl Makefile.PL
(you will be prompted to answer a number of questions and you will
need to install some Perl dependencies)
WARNING:
- 1.1 A Perl library Koha depends on, MARC::File::XML may not work with Perl
- 5.10, see: http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=2309),
- 1.2 recent versions of CGI::Session have caused some issues for users;
+ 1.1 recent versions of CGI::Session have caused some issues for users;
as of this release date, we suggest downloading the CGI::Session::serialize::yaml
tarball direct from CPAN and install it directly rather than using the cpan command
5. sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
(note that the path to koha-httpd.conf may be different depending on your
installation choices)
-6. sudo a2enmod rewrite
+6. sudo a2enmod rewrite deflate
7. sudo a2ensite koha && /etc/init.d/apache2 reload
8. sudo zebrasrv -f /etc/koha/koha-conf.xml
(note that you will want to run Zebra in daemon mode for a production
$ perldoc rewrite-config.PL
-
UPGRADE
=======
-If you are upgrading from a previous installation of Koha 3, you can
+If you are running in another language other than english, please
+switch to english before doing the upgrade, the templating system has
+changed and the templates will need to be regenerated.
+Once you have upgraded, please regenerate your templates in your
+chosen languages.
+
+If you are upgrading from a previous installation of Koha 3.x, you can
use the following:
+ ./koha_perl_deps.pl -u -m # to identify new Perl dependencies
+
+Install any missing modules
+IMPORTANT: Koha 3.4.x uses Template::Toolkit, this must be installed
+before the webinstaller can run
+
+On debian/ubuntu
+ sudo apt-get install libtemplate-perl
+
+Other Linux/Unix platforms
+Use the packaged version or install from CPAN
+ cpan Template
+
perl Makefile.PL --prev-install-log /path/to/koha-install-log
make
make test
sudo make upgrade
+Koha 3.4.x no longer stores items in biblio records so as part of the
+upgrade you will need to do the following two steps, they can take a
+long time (several hours) to complete for large databases
+
+ misc/maintenance/remove_items_from_biblioitems.pl --run
+ misc/migration_tools/rebuild_zebra.pl -b -r
+
WHAT NEXT?
1. Running the Web Installer allows you to install sample data for libraries, patrons, etc.
====================
IF THIS IS A PRE-RELEASE TREE: please contact developers by email via
-https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
+http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
or
http://dir.gmane.org/gmane.education.libraries.koha.devel
IF THIS IS A RELEASED VERSION: please see the support pages at
http://www.koha-community.org/
-Released versions usually have three-digit numbers, like 3.00.01,
+Released versions usually have three-digit numbers, like 3.02.00,
while other version number styles are usually snapshots or previews.