Bug 8656 Calendar needs to load both exception and nonexception dates
[koha.git] / INSTALL.ubuntu.lucid
index 4d77227..0003e16 100644 (file)
@@ -11,7 +11,7 @@ Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu)
 Feedback/bug reports: Koha Developer's List:
 http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
 
-This document last modified: 11 Sep 2010
+This document last modified: 20 Marchp 2012
 
 Installation Instructions
 =============================
@@ -97,7 +97,8 @@ sources
 Run the following command:
 
     $ sudo cpan HTTP::OAI Locale::Currency::Format Memoize::Memcached \
-                PDF::API2::Simple Storable Text::CSV::Encoded
+                PDF::API2::Simple Storable Text::CSV::Encoded CHI \
+                CHI::Driver::Memcached
 
 Note: you may need to run CPAN initialization if you've not run cpan
 before:
@@ -191,7 +192,7 @@ named virtual hosts.), comment out the following line:
 
 Run the following commands:
 
-    $ sudo a2enmod rewrite
+    $ sudo a2enmod rewrite deflate
     $ sudo a2ensite koha
     $ sudo apache2ctl restart
 
@@ -217,7 +218,7 @@ To add a user do:
 
 Option 1: run the Zebra processes from the command line:
 
-1.1 Zebra Search Server
+5.1.1 Zebra Search Server
 
 This process send responses to search requests sent by Koha or
 Z39.50/SRU/SRW clients.
@@ -230,7 +231,7 @@ Note: the user you run Zebra as will be the only user with write permission
       on the Zebra index; in development mode, you may wish to use your
       system user.
 
-1.2 Zebra Indexer
+5.1.2 Zebra Indexer
 
 Added/updated/deleted records in Koha MySQL database must be indexed
 into Zebra. A specific script must be launched each time a bibliographic
@@ -244,7 +245,7 @@ Option 2: run the Zebra process as a daemon, and add to startup process:
 Note that references to $SCRIPT_DIR refer to the directory where
 Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
 
-1.1 Zebra Search Server
+5.2.1 Zebra Search Server
 
     $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
     (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
@@ -253,7 +254,7 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
 
     $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
 
-1.2 Zebra Indexer
+5.2.2 Zebra Indexer
 
 Add an entry in Koha user crontab to scheduled added/updated/deleted records
 indexing by Zebra with this command:
@@ -263,6 +264,8 @@ indexing by Zebra with this command:
 See check misc/cronjobs/crontab.example for usage examples.
 NOTE: This job should be setup under the kohauser (the default is 'koha').
 
+You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
+
 6. Run the Web Installer, populate the database, initial configuration of settings
 
     Point your browser to http://<servername>:8080/
@@ -297,19 +300,37 @@ NOTE: This job should be setup under the kohauser (the default is 'koha').
     and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
     NOTE: This job should be setup under the kohauser (the default is 'koha').
 
+    You can also indexing in background, see 5.2.2 above
+
 7.4 To enable public Z39.50/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
+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
- perl Makefile.PL --prev-install-log /path/to/koha-install-log
- make
- make test
- sudo make upgrade
+
+Install any missing modules
+IMPORTANT: Koha 3.6.x uses Template::Toolkit, this must be installed
+before the webinstaller can run
+
+ sudo apt-get install libtemplate-perl
+
+Koha 3.4.x or later no longer stores items in biblio records so
+if you are upgrading from an older version 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
 =============================