Installation Guide for Installing Koha on Debian Etch with MySQL 5
=============================
-Copyright (C) 2007, LibLime
+Copyright (C) 2007, 2008 LibLime (http://liblime.com)
Maintainer: Joshua Ferraro (jmf AT liblime DOT com)
-Feedback/bug reports: jmf AT liblime DOT com
-This document last modified: 29 December 2007
+
+Feedback/bug reports: Koha Developer's List:
+http://lists.koha.org/mailman/listinfo/koha-devel
+
+This document last modified: 30 April 2008
Installation Instructions
=============================
1.4.2 Option B: Download Koha from http://download.koha.org
- $ wget http://download.koha.org/koha-3.XX.XX.XX.tar.gz
+ $ wget http://download.koha.org/koha-3.00.00-beta.tar.gz
( Note: use the latest stable version)
1.5 Install additional Debian dependencies
Create the database and user with associated privileges:
- $ mysqladmin -uroot -p<password> create database <kohadatabasename>
+ $ mysqladmin -uroot -p<password> create <kohadatabasename>
$ mysql -uroot -p<password>
Welcome to the MySQL monitor. Commands end with ; or \g.
/etc/perl/XML/SAX/ParserDetails.ini
-2.4 Create test database in order to install DBD::mysql
+2.4 Install DBD::mysql Perl module
In order to handle UTF-8 correctly, Koha requires at least version 4.004
-of the DBD::mysql Perl module. However, Debian Etch has a stable package
+of the DBD::mysql Perl module. However, Debian Etch has a stable package
only for version 3.0008, so it is necessary to install the module from CPAN.
+DBD::mysql's test suite needs to use a MySQL 'test' DB which doesn't exist
+anymore. So there are two options to install DBD::mysql:
+
+ (1) install without test suite,
+ (2) install with test suite requiring a test MySQL DB creation.
+
+2.4.1 Install without test suite
+
+Force install DBD::mysql:
+
+ $ sudo cpan
+ cpan> force install DBD::mysql
+
+2.4.2 Create test database in order to install DBD::mysql
+
Because of DBD::mysql's test suite, it is necessary to temporarily create a
test database and user:
cpan> install DBD::mysql
cpan> o conf makepl_arg ''
- (clear this setting to not interface with future CPAN installs).
+
+ OR
+
+ cpan> o conf makepl_arg '<old setting>'
+
+ (restore this setting so as to not interfere with future CPAN installs).
Finally, remove the test database:
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.
+UPGRADE
+=======
+If you are upgrading from a previous installation of Koha 3, you can
+use the following:
+
+ perl Makefile.PL --prev-install-log /path/to/koha-install-log
+ make
+ make test
+ sudo make upgrade
+
Uninstall Instructions
=============================
1) Stop Services: