From 118b444af4beff71cfb1673f5918478f81727c22 Mon Sep 17 00:00:00 2001 From: Jonathan Druart Date: Tue, 15 Nov 2016 08:55:04 +0000 Subject: [PATCH] [SIGNED OFF] Bug 17626: Remove existing install instructions and link to the wiki pages instead Since we are pretty bad to maintain INSTALL files, I'd suggest to point to the wiki. Signed-off-by: Katrin Fischer --- INSTALL | 161 +++------------------------------------------------------------- 1 file changed, 6 insertions(+), 155 deletions(-) diff --git a/INSTALL b/INSTALL index ffe69ae..0366342 100644 --- a/INSTALL +++ b/INSTALL @@ -1,157 +1,8 @@ -Koha 3 - the next-generation release of the award-winning Koha open-source -integrated library system. +For instructions on how to install Koha on Ubuntu from packages, please +consult http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages -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-community.org. +For instructions on how to install Koha on Debian from packages, please +consult https://wiki.koha-community.org/wiki/Debian -INSTALLATION -============ - -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. - -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. - -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 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 -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 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 - 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 -may not be safe. Nevertheless, it's pretty cool when it works. - -The defaults will install Koha to places that follow relevant standards, -such as the File Hierarchy Standard. If you want to install Koha to a -different directory like /opt/koha, then replace step 1 with (for example): - -1. perl Makefile.PL INTRANET_CGI_DIR=/www/cgi-bin - -You can change most of the defaults in a similar way, such as DB_HOST. -For full instructions on how to override the default settings, run - -$ perldoc rewrite-config.PL - -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. -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. - 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, - 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 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. - - -IF YOU HAVE PROBLEMS -==================== - -IF THIS IS A PRE-RELEASE TREE: please contact developers by email via -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.06.00, -while other version number styles are usually snapshots or previews. - - -DEVELOPER NOTES -=============== - -For instructions on how to package releases, run perldoc Makefile.PL +If you are a developer, you should take a look at KohaDevBox +https://github.com/digibib/kohadevbox -- 2.1.4