X-Git-Url: http://git.rot13.org/?a=blobdiff_plain;f=INSTALL.ubuntu;h=60f5ed456c30e4cec3acb678ceec713924172c3d;hb=985265c0be182342374f50d95493ec3d50bdd5e0;hp=69e7b6ac3b13a88e2ccdd85e1683794a7cdd9d47;hpb=899cca556219e4c82c1295fbfbec50abaaece5b9;p=koha.git diff --git a/INSTALL.ubuntu b/INSTALL.ubuntu index 69e7b6ac3b..60f5ed456c 100644 --- a/INSTALL.ubuntu +++ b/INSTALL.ubuntu @@ -1,410 +1,699 @@ -============================= -Installation Guide for Installing Koha on Ubuntu Jaunty (9.04) with MySQL 5 -============================= +================================================================= +Instructions for Installing Koha from Source +================================================================= -Copyright (C) 2007, 2008 LibLime (http://liblime.com) +BUG REPORTS AND FEEDBACK +================================================================= + +This document last modified: 18 September 2013 + +Given the nature of documentation to become outdated, or have +problems, please either submit feedback or bug reports. + +Bug reports can be posted at http://bugs.koha-community.org + +Feedback can be posted on the Koha Developer's List: +http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel + + +INTRODUCTION +================================================================= + +These are the instructions for installing Koha from source. They +have been tested using Ubuntu 12.04 LTS. The copyright, +licensing, and other details have been put at the end, so the +installation can be started as soon as possible. + +'nano' is a generic text editor. Please feel free to substitute +your favourite editor (vi, emacs, or etc.). + +To install Koha for production, it is recommended that you use +packages. Installing from packages is not the same as installing +from source. These are not your recommended instructions for +production servers. + +For instructions on how to install Koha on Ubuntu from packages, please +consult http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages + +To help assist with the development and improvement of Koha, +continue with these instructions and read more about version +control using git! See USEFUL REFERENCE LINKS below. + +These instructions are intended for those who are skilled. +They can be used to set up a development system. This install +may not be as easy or smooth as you wish. This is to be expected +when installing from source. + + +NOTATION +================================================================= + +Commands are indented by 4 spaces, and should be relatively obvious +as commands. Commands may have blank lines between them to +indicate that you should not just copy and paste the entire block +of commands. + +File contents will be surrounded by the plus symbols with a +"FILE FULL" or "FILE PARTIAL" and the filename above the plus +symbols surrounding file contents. + +Koha is released monthly, so keeping documentation up to date +is difficult. The convention is to replace the last number with +an x. For example, the current version is part of the 3.14.x +series and the former stable version is the 3.12.x series. + + +INSTALL UBUNTU +================================================================= + +These instructions assume that you have already installed Ubuntu +from the official site: http://www.ubuntu.com/download/server + +There is no need to install extra packages during the Ubuntu +installation. Apache2 and MySQL will be installed in the +instructions later. + +Installing a mail transfer agent before installing Koha will +prevent the installation of nullmailer. Such an installation +and configuration of a mail transfer agent is beyond the +scope of this document. Consult your system administrator, +network administrator, or IT Department for assistance as needed. + +These instructions assume you created a user account with your +login credentials and not one called 'koha'. This is to prevent +the system user 'koha' from having more permissions than it should. + + +ADD A KOHA COMMUNITY REPOSITORY +================================================================= + +These instructions still function even though the latest version +of Debian is wheezy. If the version has changed again, please +confirm these instructions on the mailing list or IRC channel. + +To avoid getting prompted for a password in the middle of a +chain of commands type the following: + sudo ls -Original author: Joshua Ferraro (jmf AT liblime DOT com) -Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu) +IF YOU ARE DOING A STANDARD (tarball) INSTALL use the following +command: + echo deb http://debian.koha-community.org/koha squeeze main \ + | sudo tee /etc/apt/sources.list.d/koha.list -Feedback/bug reports: Koha Developer's List: -http://lists.koha.org/mailman/listinfo/koha-devel +IF YOU ARE DOING A DEV (typically git) INSTALL use the following +command: + echo deb http://debian.koha-community.org/koha squeeze-dev main \ + | sudo tee /etc/apt/sources.list.d/koha.list -This document last modified: 22 June 2009 +To use the older stable release: +echo deb http://debian.koha-community.org/koha oldstable main \ +| sudo tee /etc/apt/sources.list.d/koha.list +Intentionally not indented, as the others are preferred. -Installation Instructions -============================= +FOR EITHER INSTALLATION: +Add the key in gpg.asc to your APT trusted keys to avoid +warning messages on installation: + wget -O- http://debian.koha-community.org/koha/gpg.asc \ + | sudo apt-key add - -All commands can be performed as a system user with sudo privileges, -as indicated or by running the command directly as root. -1. Prepare System and Install Dependencies +UPDATE UBUNTU +================================================================= -1.1 Install Ubuntu Jaunty via CD +This process, particularly the upgrade step, may take a while. -See http://www.ubuntu.com/getubuntu/download + sudo apt-get update -1.2 Set up your locale + sudo apt-get upgrade -Your locale should be set to UTF-8, as should Apache2 and MySQL 5. -This step is VERY IMPORTANT for a UNICODE compliant system. Please -read over the following document carefully: + sudo apt-get clean -http://wiki.koha.org/doku.php?id=encodingscratchpad -You can verify your system locale by typing the following command: +DOWNLOAD THE LATEST KOHA RELEASE +================================================================= - $ locale +There are two ways to grab the source, either by using git +or by downloading the .tar.gz file. Git is recommended for a +development environment. -IMPORTANT: You _MUST_ follow all the steps outlined there for - Apache2, MySQL 5, etc. BEFORE you install Koha. +IF YOU ARE DOING A STANDARD INSTALLATION: +Downloading Source Via Tarball +================================================================= -1.3 Install the Yaz and Zebra packages + wget http://download.koha-community.org/koha-latest.tar.gz + tar xvf koha-latest.tar.gz + ls -Run the following command to update your system: +NOTE: You need to cd into the Koha directory, but since the +version changes, you'll know by the ls command what it is. - $ sudo apt-get update - $ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc +IF YOU ARE DOING A DEV INSTALLATION: +Downloading Source Via Git +================================================================= -1.4 Get Koha +Please see the following wiki page and follow the instructions up +to and including "git checkout -b mywork origin". +http://wiki.koha-community.org/wiki/Version_Control_Using_Git -1.4.1 Option A: Download Koha via Git (optional) - $ sudo apt-get install git-core git-email - $ git clone git://git.koha.org/pub/scm/koha.git kohaclone - $ cd kohaclone - $ git checkout -b myinstall origin +INSTALL DEPENDENCIES +================================================================= -Note: for more information about Git, please see the Koha Git Usage Guide: +Dependencies from Repository +================================================================= - http://wiki.koha.org/doku.php?id=en:development:git_usage +The repository added has koha-deps and koha-perldeps packages +which make it very easy. Type the following: + sudo apt-get install koha-deps koha-perldeps make -1.4.2 Option B: Download Koha from http://download.koha.org +Check For Missing Dependencies +================================================================= - $ wget http://download.koha.org/koha-3.00.02.tar.gz - ( Note: use the latest stable version) +Check everything was installed, by running the test script to +identifty missing libraries: + ./koha_perl_deps.pl -m -u -1.5 Install additional Ubuntu dependencies +Install any required libraries that are missing. It is a good +idea to install optional ones that are easily found as well. -IMPORTANT: You should only use CPAN for Perl dependencies which are NOT - available from the package maintainer. You have been warned! -Using the ubuntu.packages file included in the Koha source tree, -run the following: +CREATE MYSQL DATABASE AND GRANT PRIVILEGES +================================================================= - $ sudo dpkg --set-selections < install_misc/ubuntu.packages +Create MySQL Database +================================================================= -Now start dselect (you may need to 'sudo apt-get install dselect'): +If you have difficulty accessing MySQL's root acount, perhaps +this Ubuntu page on resetting the root password may help. +https://help.ubuntu.com/community/MysqlPasswordReset - $ sudo dselect + mysql -u root -p -Choose [I]nstall and accept packages to be installed (hit return) + CREATE DATABASE kohadata; -(may take a while) +The Koha database has now been created with the name kohadata. -Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed. +Create User and Grant Permissions +================================================================= -1.6 Install Perl dependencies that aren't packaged into Ubuntu Jaunty -sources +Continue entering MySQL commands. SUBSTITUTE A PASSWORD OF YOUR +CHOICE FOR THE {PASSWORD}'S IN THE FOLLOWING COMMANDS: -Run the following command: + CREATE user 'koha'@'localhost' IDENTIFIED by '{PASSWORD}'; + GRANT ALL ON kohadata.* TO 'koha'@'localhost' IDENTIFIED BY '{PASSWORD}'; + FLUSH PRIVILEGES; + QUIT - $ sudo cpan MARC::Crosswalk::DublinCore GD GD::Barcode::UPCE Email::Date \ - HTML::Scrubber Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle +The Koha administrative user has now been created with the name +'koha' and the password of your choosing. -Note: you may need to run CPAN initialization if you've not run cpan -before: - /etc/perl/CPAN/Config.pm initialized. +CONFIGURE KOHA +================================================================= - CPAN is the world-wide archive of perl resources. It consists of about - 100 sites that all replicate the same contents all around the globe. - Many countries have at least one CPAN site already. The resources - found on CPAN are easily accessible with the CPAN.pm module. If you - want to use CPAN.pm, you have to configure it properly. +User/Group Environment Variables +================================================================= - If you do not want to enter a dialog now, you can answer 'no' to this - question and I'll try to autoconfigure. (Note: you can revisit this - dialog anytime later by typing 'o conf init' at the cpan prompt.) +IF YOU ARE DOING A STANDARD INSTALLATION, then create a +separate 'koha' system user: + sudo adduser koha - Are you ready for manual configuration? [yes] +There is no need to set the following environment variables, +because 'koha' is the default account to use. -When the configuration is completed CPAN will install the Perl modules. +IF YOU ARE DOING A DEV INSTALLATION, then create some +environment variables for the process to pick up and use later: + export __KOHA_USER__=$USER + export __KOHA_GROUP__=$USER + echo $USER -2. Configuration of dependencies +The output of the echo command should match your user id, +and since the user id and group id are generally the same for +a freshly created account, this will make sure the indexing +happens as this account. -2.1 Update root MySQL password (if dselect didn't do it for you already) - $ sudo mysqladmin password +Configure Your Koha Install +================================================================= -2.2 Create the Koha database + perl Makefile.PL - Create the database and user with associated privileges: +How you answer the first question will affect where things will +end up being placed. It is recommended that choose 'standard' if +you are doing a tarball install, and 'dev' if you are doing a +git install. - $ mysqladmin -uroot -p create - $ mysql -uroot -p +Answering the resulting questions requires thinking. Here are +some hints. - Welcome to the MySQL monitor. Commands end with ; or \g. - Your MySQL connection id is 22 - Server version: 5.0.32-Debian_7etch3-log Debian etch distribution +Recall that the database created is kohadata set in the Create +MySQL Database step. The username and password were set up in +the Create User and Grant Permissions step. - Type 'help;' or '\h' for help. Type '\c' to clear the buffer. +Give some thought should be given to the MARC format desired +and the method of character normalization (chr or icu), though +the defaults will work as MARC21 just fine. - mysql> grant all on .* to ''@'localhost' identified by ''; - Query OK, 0 rows affected (0.00 sec) +Use the same username and password for the Zebra questions. - mysql> flush privileges; - Query OK, 0 rows affected (0.00 sec) +Don't worry about warnings generated by optional components. - mysql> quit -2.3 Test your SAX Parser and correct where necessary +Build And Test Koha +================================================================= - You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding bugs with pre-composed characters. You can test your SAX parser by running: +Having configured Koha, build it using the following command: + make - $ cd koha - $ misc/sax_parser_print.pl +Once this has successfully run, test Koha using the following +command: + make test - You should see something like:: +Don't worry about the large number of scary warning scrolling +by. All that matters is "PASS" or "FAIL". - XML::LibXML::SAX::Parser=HASH(0x81fe220) +If this fails, it is likely due to a failed dependency. Remember, +a source installation is not always smooth. You can determine the +missing dependency by scrolling back and looking for something +like: Can't locate Cache/Memcached/Fast.pm in @INC +Install it, and try to build and test again. - If you're using PurePerl or Expat, you'll need to edit your - ini file, typically located at: - /etc/perl/XML/SAX/ParserDetails.ini +Install Koha +================================================================= -2.4 Install DBD::mysql Perl module +Once the make test has successfully run, install Koha. -In order to handle UTF-8 correctly, Koha requires at least version 4.004 -of the DBD::mysql Perl module. However, Debian Etch has a stable package -only for version 3.0008, so it is necessary to install the module from CPAN. -DBD::mysql's test suite needs to use a MySQL 'test' DB which doesn't exist -anymore. So there are two options to install DBD::mysql: +IF YOU ARE DOING A STANDARD INSTALLATION, using the +following command (follow any on screen prompts): + sudo make install - (1) install without test suite, - (2) install with test suite requiring a test MySQL DB creation. +Once this has successfully run, Koha is almost installed. There +are only a few more steps left. -2.4.1 Install without test suite +IF YOU ARE DOING A DEV INSTALLATION, using the +following command (follow any on screen prompts): + make install -Force install DBD::mysql: +No sudo is required as you have access to the directories +listed above. - $ sudo cpan - cpan> force install DBD::mysql +FOR EITHER INSTALLATION: +Near the end of this command, the output will have two lines +containing KOHA_CONF and PERL5LIB in them. Take note of the two +export commands as you will need them for a later step. -2.4.2 Create test database in order to install DBD::mysql -Because of DBD::mysql's test suite, it is necessary to temporarily create a -test database and user: +PRE-WEB INSTALL SETUP +================================================================= - $ mysql -uroot -p +Ubuntu MySQL Security Tweak +================================================================= - Create the database and user with associated privileges: +There is a security risk in Ubuntu's MySQL default setup. Type +the following commands: + mysql -u root -p - Welcome to the MySQL monitor. Commands end with ; or \g. - Your MySQL connection id is 22 - Server version: 5.0.32-Debian_7etch3-log Debian etch distribution + USE mysql; + DELETE FROM user WHERE user=''; + FLUSH PRIVILEGES; + QUIT - Type 'help;' or '\h' for help. Type '\c' to clear the buffer. +The anonymous connections are now removed. - mysql> create database test; - Query OK, 1 row affected (0.00 sec) - mysql> grant all on test.* to 'test'@'localhost' identified by 'test'; - Query OK, 0 rows affected (0.00 sec) - (test database, user, and password can be different if need be) +Configure System Wide Environment Variables +================================================================= - mysql> flush privileges; - Query OK, 0 rows affected (0.00 sec) +Running scripts and cron jobs requires environment variables set. +Use the following commands: + sudo nano /etc/environment - mysql> quit +IF YOU ARE DOING A DEV INSTALLATON: +FILE PARTIAL (ADD): /etc/environment ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +KOHA_CONF=/home/{YOUR USER NAME}/koha-dev/etc/koha-conf.xml +KOHA_PATH=/home/{YOUR USER NAME}/kohaclone +PERL5LIB=/home/{YOUR USER NAME}/kohaclone ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +NOTE: CHANGE {YOUR USER NAME} TO YOUR ACTUAL USER NAME! -Next install DBD::mysql: +IF YOU ARE DOING A STANDARD INSTALLATON: +FILE PARTIAL (ADD): /etc/environment ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +KOHA_CONF=/etc/koha/koha-conf.xml +KOHA_PATH=/usr/share/koha +PERL5LIB=/usr/share/koha/lib ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - $ sudo cpan + logout - cpan> o conf makepl_arg - (get current value of this CPAN parameter) +You need to logout and back in in order to get the environment +variables values to be recognized. - cpan> o conf makepl_arg "--testdb=test --testuser=test --testpass=test" - cpan> install DBD::mysql +CONFIGURE AND START APACHE +================================================================= - cpan> o conf makepl_arg '' +Place Koha Site File +================================================================= - OR +IF YOU ARE DOING A DEV INSTALLATION, use the following command: + sudo ln -s ~/koha-dev/etc/koha-httpd.conf \ + /etc/apache2/sites-available/koha - cpan> o conf makepl_arg '' +IF YOU ARE DOING A STANDARD INSTALLATION, use the following +command: + sudo ln -s /etc/koha/koha-httpd.conf \ + /etc/apache2/sites-available/koha - (restore this setting so as to not interfere with future CPAN installs). +Tweak Koha Site File +================================================================= +The default file limits connections to those from 127.0.1.1 +(or 127.0.0.1), which is rather difficult to test/use in a +server environment. Edit the file: + sudo nano /etc/apache2/sites-available/koha -Finally, remove the test database: +/etc/apache2/sites-available/koha will have a line +that should have the IP address changed to a *. +FILE PARTIAL (CHANGE): /etc/apache2/sites-available/koha ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - $ mysql -uroot -p +/etc/apache2/sites-available/koha will have another line +that should have the IP address changed to a * +FILE PARTIAL (CHANGE): /etc/apache2/sites-available/koha ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - mysql> drop database test; - Query OK, 1 row affected (0.00 sec) +Setup Default Ports +================================================================= - mysql> exit - Bye + sudo nano /etc/apache2/ports.conf -3. Run the Koha installer +/etc/apache2/ports.conf must have two lines exactly like +the following. Do not add them if they are already there. - $ perl Makefile.PL - ( answer questions ) - $ make - $ make test - $ sudo make install +FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +Listen 80 +Listen 8080 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -4. Configure and start Apache - $ 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) +/etc/apache2/ports.conf does not require NameVirtualHost. +Do not add it if it is missing or already there. Just +prepend # accordingly. -Add the following lines to /etc/apache2/ports.conf: +FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +#NameVirtualHost *:80 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - Listen 80 - Listen 8080 +Disable Default Site +================================================================= -If not running named virtual hosts (The default koha installation does not use named virtual hosts.), comment out the following line: +These short instructions assume that the default site is +not needed. Talk with your system administrator, network +administrator, or IT Department to CONFIRM THIS BEFORE RUNNING +the following command: + sudo a2dissite 000-default - NameVirtualHost *:80 +Enable Modules and Site +================================================================= -Run the following commands: +Now enable the Apache modules this config needs, enable Koha's +virtual host configuration, and restart Apache. + sudo a2enmod rewrite + sudo a2enmod deflate + sudo a2ensite koha + sudo service apache2 restart - $ sudo a2enmod rewrite - $ sudo a2ensite koha - $ sudo apache2ctl restart -Note: you may still see the usual Apache default site if your VirtualHost -configuration isn't correct. The command "sudo a2dissite default" may be a -quick fix, but may have side-effects. See the Apache HTTPD manual section on -virtual hosts for full instructions. +SETUP ZEBRA +================================================================= -5. Configure and start Zebra +The Zebra process send responses to search requests sent by Koha +or Z39.50/SRU/SRW clients. -Note: it's recommended that you daemonize the Zebra process and add it to your -startup profile. For a non-production test/development installation, running -Zebra from the command line can be useful. Pick from the two available options -below, or roll your own :-) +The user you run Zebra as will be the only user with write +permission on the Zebra index. For a standard installation, this +should be the system user 'koha'. For a dev installation, this +should be your system user. -Note: it's also recommended that you create a Koha system user, which you will -have specified during the install process. Alternatively, Zebra can be -configured to run as the root user. +Start Zebra Server on Boot +================================================================= -To add a user do: +IF YOU ARE DOING A STANDARD INSTALLATION, use this command: + sudo ln -s /usr/share/koha/bin/koha-zebra-ctl.sh \ + /etc/init.d/koha-zebra-daemon - $ sudo adduser koha +IF YOU ARE DOING A DEV INSTALLATION, use this command: + sudo ln -s ~/koha-dev/bin/koha-zebra-ctl.sh \ + /etc/init.d/koha-zebra-daemon +FOR EITHER INSTALLATION: + sudo update-rc.d koha-zebra-daemon defaults + sudo service koha-zebra-daemon start -Option 1: run the Zebra processes from the command line: +Configuring Zebra Indexing +================================================================= - Zebra Server: - $ sudo -u ${KOHA_USER} zebrasrv -f /etc/koha/koha-conf.xml - (note that the path to koha-conf.xml may be different depending on your - installation choices) +IF YOU ARE DOING A STANDARD INSTALLATION, use this command: + sudo nano /etc/cron.d/koha - 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. +FILE FULL: /etc/cron.d/koha ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +# The cronjobs -- $KOHA_PATH is defined in /etc/environment, and +# gets set when this process runs as a user (koha). +*/5 * * * * koha $KOHA_PATH/bin/migration_tools/rebuild_zebra.pl -b -a -z &> /dev/null ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - Zebraqueue Daemon: - $ sudo -u ${KOHA_USER} misc/bin/zebraqueue_daemon.pl +IF YOU ARE DOING A DEV INSTALLATION, use this command: + crontab -e - Note: if you are running in this mode, you may wish to defer starting the - zebraqueue until you've run the web installer (see below). +FILE PARTIAL (ADD): ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +# The cronjobs -- $KOHA_PATH is defined in /etc/environment, and +# gets set when this process runs. +*/5 * * * * $KOHA_PATH/misc/migration_tools/rebuild_zebra.pl -b -a -z &> /dev/null ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -Option 2: run the Zebra processes as daemons, 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. +SETUP ADDITIONAL LANGUAGES +================================================================= - Zebra 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) - $ sudo update-rc.d koha-zebra-daemon defaults - ( Note: see man chkconfig(8) on other distros ) +To use multi-lingual sample data, please install languages +which may be useful for use in the Koha system. - $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start +Information on this can be found: +http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client - Zebraqueue Daemon: - $ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon - $ sudo update-rc.d koha-zebraqueue-daemon defaults - ( Note: see man chkconfig(8) on other distros ) - $ sudo ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start +WEB INSTALLATION +================================================================= -6. Run the Web Installer, populate the database, initial configuration of settings +Now you can visit your staff client website to continue with the +Koha web installer. The user name to log in with will be koha. - Point your browser to http://:8080/ +The password will be what you set in the 'Create User and +Grant Permissions' section above. - It should redirect you to the Web Installer where you can continue the setup. - You can install the sample data for libraries, patrons, etc. via the Web Installer +Lynx navigational keys include: tab to go between fields, enter +(when not on text fields) to toggle or click, space to change +pages (when not on text fields), Q to quit (when not on text +fields). Arrows also work. -7. What next? + sudo apt-get install lynx - 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): + lynx http://127.0.1.1:8080/ - $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml - (note: use the correct path to your koha-conf.xml) -7.1 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 +SET UP YOUR LIBRARY IN KOHA +================================================================= -7.2 Fast Index: - $ misc/migration-tools/rebuild_zebra.pl -b -w +After the web install, you should be redirected to: +http://127.0.1.1:8080 +Follow these steps: +- Login with koha user name and password. +- Click on the More dropdown menu. +- Select and click Administration. +- Click Libraries and groups + under the Basic Parameters heading. +- Click New Library and enter your information into the form. +- Click Submit. +Your library is now set up in Koha. - 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. +Take the time to read the documentation to do other necessary +setup tasks such as creating a patron, and importing or entering +MARC data. The documentation for Koha can be found at: +http://koha-community.org/documentation/ -7.3 Schedule regular index updates - run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example - for usage examples -7.4 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. +USEFUL REFERENCE LINKS +================================================================= -UPGRADE -======= -If you are upgrading from a previous installation of Koha 3, you can -use the following: +Documentation: +http://koha-community.org/documentation/ - perl Makefile.PL --prev-install-log /path/to/koha-install-log - make - make test - sudo make upgrade +Additional Languages: +http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client -Uninstall Instructions -============================= -1) Stop Services: - $ sudo a2dissite koha - $ sudo rm /etc/apache2/sites-available/koha - $ sudo apache2ctl restart +Stage MARC Records for Import: +http://manual.koha-community.org/3.14/en/catalogtools.html#stagemarc +NOTE: The URL has been similar since Koha version 3.8 - $ sudo update-rc.d koha-zebra-daemon remove - $ sudo rm /etc/init.d/koha-zebra-daemon +Frequently Asked Questions: +http://koha-community.org/documentation/faq -2) Remove Database and Indexes +Bug Reports: +http://bugs.koha-community.org/ - # MySQL - $ mysql -u -p - > drop database koha; +Public Z39.50/SRU server: +http://wiki.koha-community.org/wiki/Troubleshooting_Koha_as_a_Z39.50_server - # Zebra Indexes - $ zebraidx -c /etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init - $ zebraidx -c /etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init +Alternate Indexing Method: +http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra -3) Remove Koha Install Directories and Configuration Files - Don't forget about any crontab entries -Tested on the following operating environments -============================================== -- Ubuntu Jaunty Jackalope 9.04 +UPGRADING +================================================================= -Installer Bug reports -===================== -Please log any installer bug reports at http://bugs.koha.org +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. -Other Notes -===================== -This file is part of Koha +Once you have upgraded, please regenerate your templates in +your chosen languages. -Koha is free software; you can redistribute it and/or modify it under the -terms of the GNU General Public License as published by the Free Software -Foundation; either version 2 of the License, or (at your option) any later -version. +First, ensure the most recent dependencies are installed: + sudo apt-get update + sudo apt-get install koha-deps koha-perldeps -Koha is distributed in the hope that it will be useful, but WITHOUT ANY -WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR -A PARTICULAR PURPOSE. See the GNU General Public License for more details. -You should have received a copy of the GNU General Public License along with -Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place, -Suite 330, Boston, MA 02111-1307 USA +IF YOU ARE DOING A STANDARD UPGRADE: +In order to upgrade, find the path to the koha install-log file: + sudo find /usr/share/koha/ -name 'koha-install-log' + +Change directory into the latest koha source directory, and then: + perl Makefile.PL --prev-install-log /path/to/koha-install-log + +NOTE: Make sure to change the /path/to/koha-install-log to the +one that was found. + + make + make test + +And if that passes: + sudo make upgrade + +IF YOU ARE DOING A DEV UPGRADE: +In order to upgrade, find the path to the koha install-log file: + find ~/koha-dev/ -name 'koha-install-log' + + cd ~/kohaclone + perl Makefile.PL --prev-install-log /path/to/koha-install-log + +NOTE: Make sure to change the /path/to/koha-install-log to the +one that was found. + + make + make test + +And if that passes: + make upgrade + +FOR EITHER UPGRADE TYPE: +If you are upgrading from a version of Koha earlier than 3.4.x, +Koha 3.4.x or later no longer stores items in biblio records: +./misc/maintenance/remove_items_from_biblioitems.pl --run +Intentionally not indented, in the hopes that most upgrades are +post 3.4.x. + +Regardless of version you are upgrading from, a full reindex is +always the best option: +IF YOU ARE DOING A STANDARD UPGRADE + sudo su -l koha --command="/usr/bin/perl /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -a -r -v" + +IF YOU ARE DOING A DEV UPGRADE + ./misc/migration_tools/rebuild_zebra.pl -b -a -r -v + + +UNINSTALL INSTRUCTIONS +================================================================= + +Stop Services +================================================================= + sudo a2dissite koha + sudo rm /etc/apache2/sites-available/koha + sudo service apache2 restart + sudo update-rc.d koha-zebra-daemon remove + sudo rm /etc/init.d/koha-zebra-daemon + +Remove Database +================================================================= + mysql -u koha -p + + drop database kohadata; + quit + +Remove Indexes +================================================================= + +IF DOING A STANDARD REMOVAL: + zebraidx -c /etc/koha/zebradb/zebra-biblios.cfg \ + -g iso2709 -d biblios init + zebraidx -c /etc/koha/zebradb/zebra-authorities.cfg \ + -g iso2709 -d authorities init + sudo rm -rf /etc/koha + sudo rm -rf /usr/share/koha + sudo rm /etc/cron.d/koha + +You may wish to follow up with: + sudo find / -t d -name "koha" +to help find any remnants. + +IF DOING A DEV REMOVAL: +The following will work, but is very dangerous! Please copy or +type this correctly. + zebraidx -c ~/koha-dev/etc/zebradb/zebra-biblios.cfg \ + -g iso2709 -d biblios init + zebraidx -c ~/koha-dev/etc/zebradb/zebra-authorities.cfg \ + -g iso2709 -d authorities init + rm -rf ~/koha-dev + rm -rf ~/kohaclone +NOTE: Don't forget to remove the crontab entries! + + +LICENSE +================================================================= + +This file is part of Koha. + +Major re-write by Mark Tompsett +Copyright (C) 2013 + +Based on remnants by: +Copyright (C) 2007, 2008 LibLime (http://liblime.com) + Original author: Joshua Ferraro +Some parts Copyright (C) 2010 Chris Nighswonger (modified for ubuntu) + (cnighswonger AT foundations DOT edu) +Some parts Copyright (C) 2012 Tomas Cohen Arazi + (tomascohen AT gmail DOT com) +Some parts Copyright (C) 2012 Mark Tompsett + (mtompset AT hotmail DOT com) + +Koha is free software; you can redistribute it and/or modify it +under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 3 of the License, or +(at your option) any later version. + +Koha is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with Koha; if not, see .