X-Git-Url: http://koha-dev.rot13.org:8081/gitweb/?a=blobdiff_plain;f=INSTALL;h=ffe69aeabc5524a8007d236f4b9755b5becbce68;hb=5d6c092921919526ade501facb1220f8a108a08f;hp=aadef20eddaacecffe96e2215913eea7e91b6efd;hpb=0fff79d6b464eb9e053ed568234e43695fbec66b;p=koha_fer diff --git a/INSTALL b/INSTALL index aadef20edd..ffe69aeabc 100644 --- a/INSTALL +++ b/INSTALL @@ -1,4 +1,4 @@ -Koha 3.2 - the next-generation release of the award-winning Koha open-source +Koha 3 - 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 @@ -10,7 +10,7 @@ more about the Koha project at http://koha-community.org. INSTALLATION ============ -You need to have a server running Perl 5.8.8 or later, MySQL 5, Zebra +You need to have a server running Perl 5.10 or later, MySQL 5, Zebra 2.0.22 or greater and a webserver (preferably Apache2) before installing Koha. @@ -30,8 +30,13 @@ Default installation instructions: 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.2. Optional foreign language installation: + If you would like more languages and not only English, + cd misc/translator + perl translate install fr-FR # or use your preferred language codes + 2. make -3.(optional) make test +3.(optional) make test 4. sudo make install 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 @@ -63,7 +68,7 @@ UPGRADE ======= 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. +changed and the templates will need to be regenerated. Once you have upgraded, please regenerate your templates in your chosen languages. @@ -73,7 +78,7 @@ 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 +IMPORTANT: Koha 3.4.0 and greater uses Template::Toolkit, this must be installed before the webinstaller can run On debian/ubuntu @@ -88,9 +93,10 @@ Use the packaged version or install from CPAN 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 +Koha 3.4.x or later no longer stores items in biblio records. +If you are upgrading from an older version ou 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 @@ -119,14 +125,12 @@ WHAT NEXT? Once the indexing has completed, you will be able to search for records in your system. NOTE: if you don't run the Fast Index utility, and you have the index updates scheduled as per 7.3 the indexing process will happen in the background, - Once the indexing has completed, you will be able to search for records in your - system. NOTE: if you don't run the Fast Index utility, and you have the index - updates scheduled as per 7.3 the indexing process will happen in the background, but it will be orders of magnitude slower. 4. Schedule regular index updates - run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example - for usage examples + run rebuild_zebra.pl -b -a -z as a regular cron job, check the 'misc/cronjobs/crontab.example' file for usage examples + + You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra 5. To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and change the options to listen on a TCP port; then restart the zebra daemon. @@ -143,7 +147,7 @@ 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.02.00, +Released versions usually have three-digit numbers, like 3.06.00, while other version number styles are usually snapshots or previews.