Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu)
Feedback/bug reports: Koha Developer's List:
-https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
+http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
This document last modified: 19 May 2010
This step is VERY IMPORTANT for a UNICODE compliant system. Please
read over the following document carefully:
-http://wiki.koha.org/doku.php?id=encodingscratchpad
+http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha
You can verify your system locale by typing the following command:
1.4.1 Option A: Download Koha via Git (optional)
$ sudo apt-get install git-core git-email
- $ git clone git://git.koha-community.org/pub/scm/koha.git kohaclone
+ $ git clone git://git.koha-community.org/koha.git kohaclone
$ cd kohaclone
$ git checkout -b myinstall origin
Note: for more information about Git, please see the Koha Git Usage Guide:
- http://wiki.koha.org/doku.php?id=en:development:git_usage
+ http://wiki.koha-community.org/wiki/Version_Control_Using_Git
1.4.2 Option B: Download Koha from http://download.koha-community.org
/etc/perl/XML/SAX/ParserDetails.ini
+ You will need to move the entire section for '[XML::LibXML::SAX::Parser]' to the bottom of the ini file.
+
2.4 Install DBD::mysql Perl module
In order to handle UTF-8 correctly, Koha requires at least version 4.004
Run the following commands:
- $ sudo a2enmod rewrite
+ $ sudo a2enmod rewrite deflate
$ sudo a2ensite koha
$ sudo apache2ctl restart
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
+
+ sudo apt-get install libtemplate-perl
+
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
+
Uninstall Instructions
=============================
1) Stop Services: