X-Git-Url: http://koha-dev.rot13.org:8081/gitweb/?a=blobdiff_plain;f=INSTALL;h=ffe69aeabc5524a8007d236f4b9755b5becbce68;hb=5d6c092921919526ade501facb1220f8a108a08f;hp=02b86775940710ed4f6b5e18d4c42f5b328c0f0f;hpb=7289c2ead3c6082ff4ca3291240d5bd2813db56b;p=koha_fer diff --git a/INSTALL b/INSTALL index 02b8677594..ffe69aeabc 100644 --- a/INSTALL +++ b/INSTALL @@ -5,18 +5,12 @@ Koha is the first open-source Integrated Library System. Developed initially in New Zealand by Katipo Communications, Ltd and first deployed in January of 2000 for the Horowhenua Library Trust, it is currently maintained by a team of software providers and library technology staff from around the globe. Learn -more about the Koha project at http://koha.org. +more about the Koha project at http://koha-community.org. INSTALLATION ============ -Koha 3 comes with a new installer, based on MakeMaker, the tool that -is usually used to install CPAN modules. This means that if you know -how to customise CPAN-installed modules, the same things should work -for you with Koha. If not, don't worry. If you want to customise the -installation more than described below, run "man ExtUtils::MakeMaker" - -You need to have a server running Perl 5.8, MySQL 5 or PostgreSQL 8.2.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. @@ -25,32 +19,29 @@ user, with a password set. Note: kohaadmin must have at least the following privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, and LOCK TABLES. -PostgreSQL 8.2.5: Create a database called 'koha,' owned by 'kohaadmin' -user, with a password set. Note: kohaadmin must be a superuser. You -must also add plpgsql to the koha database. NOTE: PostgreSQL support in -Koha is experimental and should not be attempted for production systems -without a heavy investment in testing. - Default installation instructions: 1. perl Makefile.PL (you will be prompted to answer a number of questions and you will need to install some Perl dependencies) WARNING: - 1.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.2 recent versions of CGI::Session have caused some issues for users; + 1.1 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.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 installation choices) -6. sudo a2enmod rewrite +6. sudo a2enmod rewrite deflate 7. sudo a2ensite koha && /etc/init.d/apache2 reload 8. sudo zebrasrv -f /etc/koha/koha-conf.xml (note that you will want to run Zebra in daemon mode for a production @@ -73,17 +64,43 @@ For full instructions on how to override the default settings, run $ perldoc rewrite-config.PL - 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.0 and greater uses Template::Toolkit, this must be installed +before the webinstaller can run + +On debian/ubuntu + sudo apt-get install libtemplate-perl + +Other Linux/Unix platforms +Use the packaged version or install from CPAN + cpan Template + perl Makefile.PL --prev-install-log /path/to/koha-install-log make make test sudo make upgrade +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 + WHAT NEXT? 1. Running the Web Installer allows you to install sample data for libraries, patrons, etc. @@ -108,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. @@ -125,14 +140,14 @@ IF YOU HAVE PROBLEMS ==================== IF THIS IS A PRE-RELEASE TREE: please contact developers by email via -http://lists.nongnu.org/mailman/listinfo/koha-devel +http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel or 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.00.01, +Released versions usually have three-digit numbers, like 3.06.00, while other version number styles are usually snapshots or previews.