X-Git-Url: http://koha-dev.rot13.org:8081/gitweb/?a=blobdiff_plain;f=INSTALL;h=9498fc52da984a275c2bca722d036e6cb4afb76b;hb=d866282bb941fb141e45164152c8cdf3c45db294;hp=6605d1bd2d8d6299ec576479d017a7b728779c11;hpb=eedb94442ee85c048fb15414941ee7c092cc36c8;p=koha_fer diff --git a/INSTALL b/INSTALL index 6605d1bd2d..9498fc52da 100644 --- a/INSTALL +++ b/INSTALL @@ -1,38 +1,35 @@ -Koha 3 - the next-generation release of the award-winning Koha open-source +Koha 3.2 - 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 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 MySQL 5 or PostgreSQL 8.2.5, Zebra +You need to have a server running Perl 5.8.8 or later, MySQL 5, Zebra 2.0.22 or greater and a webserver (preferably Apache2) before installing Koha. - + MySQL 5: Create a database called 'koha,' owned by 'kohaadmin' 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. - Default installation instructions: 1. perl Makefile.PL - (you will be prompted to answer a number of questions) + (you will be prompted to answer a number of questions and you will + need to install some Perl dependencies) + WARNING: + + 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 + 2. make 3.(optional) make test 4. sudo make install @@ -45,6 +42,7 @@ Default installation instructions: (note that you will want to run Zebra in daemon mode for a production system) 9. Browse to http://servername:8080/ and answer the questions +10. Optionally add a robots.txt file. See README.robots for details OR if you want to install all dependencies from CPAN and are root, you can replace steps 1-3 with "perl install-CPAN.pl" but this is non-standard and @@ -61,19 +59,66 @@ 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.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 + +WHAT NEXT? + +1. Running the Web Installer allows you to install sample data for libraries, patrons, etc. + but you may want to install additional data such as bibliographic and authorities. + + Once the installer has completed, you can import and index MARC records from the + command line thusly (Note: you can also use the 'Stage MARC records for import' from + the Tools area of Koha's Staff Client to import a batch of MARC records): + + $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml + (note: use the correct path to your koha-conf.xml) + +2. Import: + Bibliographic data in MARC21 format + $ misc/migration_tools/bulkmarcimport.pl -file /path/to/marc.iso2709 + Authority data in MARC21 format + $ misc/migration_tools/bulkauthimport.pl -file /path/to/auth.iso2709 + +3. Fast Index: + $ misc/migration_tools/rebuild_zebra.pl -b -w + + 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 + +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. + 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.org/ +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.02.00, while other version number styles are usually snapshots or previews.