fix for bug 2282: Biblio framework subfields...

[koha.git] / INSTALL.debian

diff --git a/INSTALL.debian b/INSTALL.debian
index 17d740b..40d64fc 100644 (file)
--- a/INSTALL.debian
+++ b/INSTALL.debian
@@ -2,11 +2,14 @@
 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
 =============================
@@ -20,6 +23,10 @@ as indicated or by running the command directly as root.
 
 See http://www.debian.org/releases/etch/debian-installer/
 
+WARNING: use Perl 5.8 (a library Koha depends on,
+MARC::File::XML may not work with Perl 5.10, see:
+http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2309),
+
 1.2 Set up your locale
 
 Your locale should be set to UTF-8, as should Apache2 and MySQL 5.
@@ -72,7 +79,7 @@ Note: for more information about Git, please see the Koha Git Usage Guide:
 
 1.4.2 Option B: Download Koha from http://download.koha.org
 
-    $ wget http://download.koha.org/koha-3.00.00-alpha.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
@@ -105,9 +112,17 @@ Run the following command:
                 PDF::Reuse PDF::Reuse::Barcode Data::ICal GD::Barcode::UPCE \
                 XML::RSS Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle POE Schedule::At
 
-There is a known but benign error in the test case for Barcode::Code128, 
-which is required by PDF::Reuse::Barcode.  If this module is not installed, 
-you can do a forced installation of Barcode::Code128.
+  WARNINGS:
+  1.6.1 A Perl library Koha depends on, MARC::File::XML may not work with Perl
+    5.10, see: http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2309),
+
+  1.6.2 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
+
+  1.6.3 There is a known but benign error in the test case for Barcode::Code128, 
+  which is required by PDF::Reuse::Barcode.  If this module is not installed, 
+  you can do a forced installation of Barcode::Code128.
 
 Note: you may need to run CPAN initialization if you've not run cpan
 before:
@@ -138,7 +153,7 @@ When the configuration is completed CPAN will install the Perl modules.
 
     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.
@@ -171,11 +186,26 @@ When the configuration is completed CPAN will install the Perl modules.
 
     /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:
 
@@ -333,6 +363,16 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
     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: