From a89ea482f5e7e369958461d2e37e4d10bbfb3e65 Mon Sep 17 00:00:00 2001 From: Jonathan Druart Date: Tue, 15 Nov 2016 08:54:45 +0000 Subject: [PATCH] Bug 17626: Remove INSTALL.distri files --- INSTALL.debian | 396 ---------------- INSTALL.fedora7 | 1267 ------------------------------------------------- INSTALL.opensuse | 1375 ------------------------------------------------------ INSTALL.ubuntu | 699 --------------------------- 4 files changed, 3737 deletions(-) delete mode 100644 INSTALL.debian delete mode 100644 INSTALL.fedora7 delete mode 100644 INSTALL.opensuse delete mode 100644 INSTALL.ubuntu diff --git a/INSTALL.debian b/INSTALL.debian deleted file mode 100644 index 4547974..0000000 --- a/INSTALL.debian +++ /dev/null @@ -1,396 +0,0 @@ -============================= -Installation Guide for Installing Koha on Debian -============================= - -Some parts copyright 2010 Chris Nighswonger -Some parts copyright 2011 MJ Ray and software.coop - -Feedback/bug reports: Koha Developer's List: -http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel - -This document last modified: 2012-March-20 - -Installation Instructions -============================= - -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 - -1.1 Install Debian via Business Card CD - - See http://www.debian.org/CD/netinst/ - -1.2 Set up Indexdata apt sources for Yaz and Zebra packages - -See the instructions from indexdata at -http://ftp.indexdata.com/pub/debian/README - -At the time of writing, you need to create -/etc/apt/sources.list.d/indexdata.list containing the following: - - # Index Data - deb http://ftp.indexdata.dk/debian squeeze main - deb-src http://ftp.indexdata.dk/debian squeeze main - -and add their archive signing key to your system: - - $ wget -O- http://ftp.indexdata.dk/debian/indexdata.asc | sudo apt-key add - - -Finally, update your apt sources: - $ sudo apt-get update - -1.3 Get Koha -Choose one of these options: - -1.3.1 Option A: Download Koha via Git (optional) - - $ sudo apt-get install git-core git-email - $ git clone git://git.koha-community.org/koha.git koha - $ cd koha - $ git checkout -b myinstall origin - -Note: for more information about Git, please see the Koha Git Usage Guide: - - http://wiki.koha-community.org/wiki/Version_Control_Using_Git - -1.3.2 Option B: Download Koha from http://download.koha-community.org - -Find the latest Koha stable version on http://download.koha-community.org -and download it to your server with something like: - - $ wget - -1.4 Install additional Debian dependencies - -IMPORTANT: You should only use CPAN for Perl dependencies which are NOT - available from the package maintainer. You have been warned! - -Installing all necessary Debian packages, MySQL Server, -Zebra and all Debian packaged Perl module required by Koha: - - $ sudo dpkg --set-selections < install_misc/debian.packages - $ sudo apt-get dselect-upgrade - -1.5 Install Perl dependencies that aren't packaged into Debian - -Run the following command: - - $ perl koha_perl_deps.pl -m -u - -This will list whether any Perl dependencies are missing or need a -later version and whether they are required. You can then install -them another way. There may be packages on -http://debian.koha-community.org or maybe you can build packages -yourself or maybe you will need to install them locally with a command -similar to - - $ sudo cpan Graphics::Magick CHI CHI::Driver::Memcached - -Note: you may need to run CPAN initialization if you've not run cpan -before. See http://search.cpan.org/~andk/CPAN/lib/CPAN.pm#CONFIGURATION - -When the configuration is completed CPAN will install the Perl modules. - -2. Configuration of dependencies - -2.1 Create the Koha database - - Create the database and user with associated privileges (information inside <> brackets is - data you assign specifically to your installation. Do not include the <>'s when entering the commands): - - $ mysqladmin -uroot -p create - $ mysql -uroot -p - - Welcome to the MySQL monitor. Commands end with ; or \g. - Your MySQL connection id is 22 - Server version: 5.0.51a-24 (Debian) - - Type 'help;' or '\h' for help. Type '\c' to clear the buffer. - - mysql> grant all on .* to ''@'localhost' identified by ''; - Query OK, 0 rows affected (0.00 sec) - - mysql> flush privileges; - Query OK, 0 rows affected (0.00 sec) - - mysql> quit - -You may want to document the database name, the database username, and the database password you just set. -Step 3 will require them. - -2.2 Test your SAX Parser and correct where necessary - -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: - - $ cd koha - $ misc/sax_parser_print.pl - -You should see something like: - - XML::LibXML::SAX::Parser=HASH(0x81fe220) - -If you are configured to use PurePerl or Expat, the script will say you have a problem and -you'll need to edit your ini file to correct it. - -The file is typically located at: - - /etc/perl/XML/SAX/ParserDetails.ini - -The correct parser entry will need to be moved to the bottom of the file. -The following is the entry you are looking for: - - [XML::LibXML::SAX::Parser] - http://xml.org/sax/features/namespaces = 1 - -2.3 Create your Koha system user (if you haven't created one already) - - $ sudo adduser koha - -You can substitute any username for "koha," just be sure to write it down, you will need to know what it is in step 3. - -3. Run the Koha installer - - $ perl Makefile.PL - ( answer questions ) - $ make - $ make test - $ sudo make install - -3.1 Export the environment variables -Make install will tell you what the proper path for these environment variables is. -In case you missed it at the end of make install, here are some examples: - -Example (for standard install): - $ export KOHA_CONF=/etc/koha/koha-conf.xml - $ export PERL5LIB=/usr/share/koha/lib - -Example (for dev install. These paths are set during Makefile.PL.): - $ export KOHA_CONF=/path/to/your/koha-conf.xml - $ export PERL5LIB=/path/to/koha/lib - -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 if you chose a dev install) - -Add the following lines to /etc/apache2/ports.conf: - - Listen 80 - Listen 8080 - -Run the following commands: - - $ sudo a2enmod rewrite deflate - $ sudo a2ensite koha - $ sudo apache2ctl restart - -Note: you may still see the usual Apache default site if your VirtualHost - configuration isn't correct. If Koha is the only web application running on the server, - the command "sudo a2dissite default" may be a quick fix. For servers running other sites - alongside Koha, see the Apache HTTPD manual section on virtual hosts for full - instructions (http://httpd.apache.org/docs/2.2/vhosts/). - -5. Run the Web Installer, populate the database, initial configuration of settings - -Point your browser to http://:8080/ - -Note: is (usually) the IP of your server, or localhost (if you are connecting - from the same machine Koha is installed on. You can verify the location by checking - the VirtualHost settings for both the opac and intranet virtual hosts in koha-httpd.conf - -Koha will redirect you to the Web Installer where you can continue the setup. You will be prompted to enter in your DATABASE username and password. It is through this interface -that -you can install the sample data for libraries, patrons, and much more. - -Be aware that removing sample data at a later time (when you may want to take the -server into production) may not be easy, and if your intent is to take this -install from testing to production, go with minimal sample data (no patrons or bibliographic records). - -6. Configure and start Zebra - -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 one of the options below (or roll your own). - -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. - -Option 1: run the Zebra processes from the command line (manual indexing): - -6.1.1 Zebra Search Server - -This process send responses to search requests sent by Koha or -Z39.50/SRU/SRW clients. - - $ sudo -u zebrasrv -f /etc/koha/koha-conf.xml - (note that the path to koha-conf.xml may be different if you chose a dev install, and that - refers to the user you set up in step 2.3) - -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. - - -6.1.2 Zebra Indexer - -Added/updated/deleted records in Koha MySQL database must be indexed -into Zebra. A specific script must be launched each time a bibliographic -or an authority record is edited. - - $ sudo -u misc/migration_tools/rebuild_zebra.pl -z -b -a - -Note: This script should be run as the kohauser (the default is 'koha', but -this is the user you set up in step 2.3). - -Option 2: run the Zebra process as a daemon (automatic indexing): - -Note: References to refer to the directory where - Koha's command-line scripts are installed, the path - is /usr/share/koha/bin/ by default in a standard install. - -6.2.1 Zebra Search Server - - $ sudo ln -s /koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon - (Note: is /usr/share/koha/bin/ by default in a standard install) - $ sudo update-rc.d koha-zebra-daemon defaults - - $ sudo /koha-zebra-ctl.sh start - (Note: is /usr/share/koha/bin/ by default in a standard install) - - -6.2.2 Zebra Indexer - -Add an entry in Koha user crontab to process scheduled added/updated/deleted records -indexing by Zebra. cronjobs/crontab.example contains examples for these cron jobs (and many more). - -NOTE: The cronjobs should be setup under the kohauser (the default is 'koha', but -this is the user you set up in step 2.3). - -Edit the crontab for the koha user by running - $ sudo -u crontab -e - -For Zebra indexing, you are looking for the example that begins with - - # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day - # for both authorities and bibs - -It may be easiest to copy/paste the example into your own crontab and modify as necessary. - -You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra - -7. What next? - - 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) - -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/bulkmarcimport.pl -a -file /path/to/auth.iso2709 - -7.2 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: This script should be run as the kohauser (the default is 'koha', this is the user we set up in step 2.3). - -7.3 Schedule regular index updates with cron ,or configure zebra indexing as a background daemon - - You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs - and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above. - NOTE: This job should be setup under the kohauser (the default is 'koha', this is the user we set up in step 2.3). - - To setup indexing in background see 6.2.2 - -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. - -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.6.x uses Template::Toolkit, this must be installed -before the webinstaller can run - - sudo apt-get install libtemplate-perl - - 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 so -if you upgrading from an old version 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 - - misc/maintenance/remove_items_from_biblioitems.pl --run - misc/migration_tools/rebuild_zebra.pl -b -r - -Uninstall Instructions -============================= -1) Stop Services: - $ sudo a2dissite koha - $ sudo rm /etc/apache2/sites-available/koha - $ sudo apache2ctl restart - - $ sudo update-rc.d koha-zebra-daemon remove - $ sudo rm /etc/init.d/koha-zebra-daemon - -2) Remove Database and Indexes - - # MySQL - $ mysql -u -p - > drop database koha; - - # 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 - -3) Remove Koha Install Directories and Configuration Files - Don't forget about any crontab entries - -Tested on the following operating environments -============================================== -- Debian Lenny 5.0 -- Debian Squeeze 6.0 - -Other Notes -===================== -This file is part of Koha - -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. - -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 - diff --git a/INSTALL.fedora7 b/INSTALL.fedora7 deleted file mode 100644 index ac354a4..0000000 --- a/INSTALL.fedora7 +++ /dev/null @@ -1,1267 +0,0 @@ -THIS FILE IS TOO OLD AND NOT UPDATED. -CHECK KOHA WIKI:http://wiki.koha-community.org -CHECK OTHERS INSTALL FILES -ASK IN KOHA MAILING LIST - -============================= -Installation Guide for Installing Koha on Fedora Core 7 -============================= - -Copyright (C) 2008, Department of Computer and Information -Science, Library of the University Lyon 2, France - -Translated by: Google with help from Joshua Ferraro -(jmf AT liblime DOT com) - -Feedback/bug reports: Koha Developer's List: -http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel - -This document last modified: 30 April 2008 - -Installation Instructions -============================= -This document was prepared in order to help you discover (or -test) Koha (Integrated Library System). - -The installation of Linux system described below is a basic, -it is not designed for a production server (e.g., security, -load balancing .. are not described). - -This document describes the different stages of installing -the software to version 3.00 koha beta on a Fedora 7 Linux. -Your mileage may vary with different RedHat distributions. - -1. LINUX SYSTEM INSTALLATION - -System: Linux Fedora 7 (May 2007) Linux Redhat -The Linux distribution Fedora 7 is downloadable from the -Fedora website: - -http://fedoraproject.org/ - -The Fedora website also offers additional content such as -documentation, FAQ, etc. - -Using the entire disk (removal of existing partitions and -therefore permanent loss of data stored on the disk) is -the easiest method; This is not the best practice for a -production system, but is useful for testing purposes. - -Check that the computer is able to boot from a CD or DVD, -perhaps by changing the boot order in the bios. - -Place the CD or DVD in the drive and restart the machine. - -Settings when installing Linux (French specific, may not apply) - -Language: French (French) -Choice of keyboard: French (Latin9) recognized by default. -Removal of existing Linux partitions -Host Name: NomMachine.NomDomaine.fr -Time zone: Europe/Paris. Click on the map or select from the -list and check system clock to UTC. -Informing the root password, which is the administrator account. - -The installation of the system will automatically start and may -take between 15 to 30 minutes to complete. - -Click Restart. - -Enter the default options. -For Firewall, check www http server (configuration of the firewall). -Create a user koha with the password kohakoha (eg) -The koha is therefore created and the group koha which this user belongs. - -Setting the homepage -Enter root, then the password root. - -With Fedora, GNOME is the default environment. - -To use KDE default (as we at Lyon 2 have done), close the session, -having recovered the KDE packages on Add/Remove software. For the -french interface, go through the package manager and seek, then -install kde-french. - -On the login prompt, go to Options è Select Session and choose KDE. A -the next connection, the system will ask if you want to use KDE or -GNOME by default. Also on the login prompt, go to Languages and -choose the French. - -The installation of Linux system is complete. - -1.2 Verification of system settings - -You must be logged in as administrator of the system (root). - --- Make sure the environment is KDE. The taskbar is at the -bottom of the screen and left of this bar is the menu K. - --- Check that the system is in french and click on K. - --- Create a few shortcuts in making a drag and drop the following -items in the taskbar: - -Menu K è è Internet Firefox Web Browser -Menu K è è Terminal System -Menu K è è Services System Management Services - --- Check that the koha and the group koha are created: -Menu K è è System Users and Groups - --- Check that web servers Apache and MySQL are installed. -Menu K è è Services System Management Services - -The lines httpd (demon Apache) and mysqld (demon MySQL) must be -included in the line of services. You must configure these two -services so that they are lançés automatically at boot. Check th -e box to the left of the service, click the Start button at the -top of the list, if the two services start without any problem, -validate the change of manager services by clicking on Save or -File menu è save changes - -Close the services manager. - -If one or both services are absent, it is necessary to install Apache -and/or MySQL. To do so, go in the Package Manager, choose and -select Apache server and/or MySQL. In the case of MySQL, we must -not forget MySQL-devel (available in packages optional). Finally, -start the installation. - -1.3 Installation of additional software - -The software installation Koha requires adding additional programs -to your system linux based on a standard installation. This list may -be slightly different depending on the version and support (Live -CD or DVD). - -List of software to add -Libxml2-devel -Libxslt-devel -TCL -Bzip2-devel -GCC -Perl-CPAN -Perl-ExtUtils-AutoInstall -Ncftp -Wget -Gdbm-devel -Expat-devel -Tcp_wrappers-devel -Libicu (see below) -git-1.5.3.7-1.fc8 [is not necessary for the installation of koha, but - useful if one participates in the development of koha.] -PhPMyAdmin -Libicu -Libicu-devel - -To add software Linux Fedora, you have two tools - -A graphical tool -Menu K è è System Add/Remove software - -Click on the Search tab -Enter the name of the software in the zone entry and click the -Search button; - -The software that match your search are listed. -Make sure the check box is checked if the tick and click Apply to -add software to your system. - -A tool mode Terminal YUM -The YUM documentation is available on the Fedora site - -Open a terminal window (K Menu è è Terminal System) - -Examples of using YUM: -Is the web browser Firefox installed? -Type the command: yum list firefox -This command will launch the software yum, and asked it to list -the information on the Firefox. -Yum visit the various deposits of software for Fedora (fedora, -updates, etc.). And said that the firefox software is installed -on this machine (version 2.0.0.3-4.fc7) and there is a -downloadable version newer ( version 2.0.0.10-2.fc7) - -************************************************** **************** -Screenshot -[root @ nomduserveur ~] # yum list firefox -Loading "installonlyn" plugin -fedora 100% |=========================| 2.1 kB 00:00 -updates 100% |=========================| 2.3 kB 00:00 -Installed Packages -firefox.i386 2.0.0.3-4.fc7 installed -Packages Available -firefox.i386 2.0.0.10-2.fc7 updates -************************************************** **************** - -Updated software firefox by the command yum update firefox. -YUM inspect the system to check whether it is necessary to update -other software used by firefox. -confirm your request y - -Installation of new software by the command yum install firefox. - - -Verification -Check whether these programs are installed using the command rpm -with option-q followed by the name of the software, possibly separated -by a space. -Example: -rpm-q libxml2-devel libxslt-devel tcl bzip2-devel gcc mysql-devel-perl CPAN perl-ExtUtils-AutoInstall ncftp wget gdbm devel-expat-devel tcp_wrappers-devel - -NB: The tool rpm (Redhat Package Manager) allows facilities -management software under the Linux distribution Fedora. - -Special case: the library libicu under Fedora 8 -Under Fedora 8: -The library libicu, is standard in the distribution Fedora. -Version 3.8 of this library installed with Fedora 8 is too recent -and poses a problem when installing software and ZEBRA YAZ, the -company Indexdata who compiled these two programs with version 3.6 -of the library, it is therefore necessary to remove the libicu 3.8 -library and replace it with version 3.6. - -Uninstall the library libicu - 3.8-1.fc8 - -With the web browser, download the library libicu-3.6-18.fc7.i386.rpm -(old version, choose the version Fedora 7 for i386) here: - - HYPERLINK "http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36" http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36 - -Download the package rpm -Open a terminal window, a menu K> System> Terminal -find the file libicu-3.6-18.fc7.i386.rpm -Desktop CD -ls-l - -decompress the archive with the command: rpm-ivh libicu-3.6-18.fc7.i386.rpm - -Setting 1.4 for the use of unicode - -VERY IMPORTANT -UNICODE must be set up correctly before installing Koha. - -1.4.1 The Linux system is it configured to use UNICODE? - -For more information: - HYPERLINK "http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha" http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha - -To check, open a terminal window and type the locale. -You must obtain: -LANG = en_GB.UTF-8 -... - -1.4.2 The web server Apache 2 is it configured to use UNICODE? - -To verify, using a text editor, open the httpd.conf file located -in /etc/httpd/conf and look if it contains the directive: - -AddDefaultCharset UTF-8 - -1.4.3 The MySQL server is it configured to use UNICODE? - -NB: mysqld service must be started. -In a Terminal window, type the command mysql, then an SQL -to display variables content server configuration. -Text of query: - -show where variable_name variables like 'char%'; - -****************************************************************** -Screenshot -mysql> show where variable_name variables like 'char%'; -+--------------------------+----------------------------+ -| Variable_name | Value | -+--------------------------+----------------------------+ -| Character_set_client | latin1 | -| Character_set_connection | latin1 | -| Character_set_database | latin1 | -| Character_set_filesystem | Binary | -| Character_set_results | latin1 | -| Character_set_server | latin1 | -| Character_set_system | utf8 | -| Character_sets_dir | /usr/share/mysql/charsets/ | -+--------------------------+----------------------------+ -8 rows in set (0.00 sec) -****************************************************************** - -Some variables are not properly configured (latin1), so we have to -change the configuration file server MySQL. -Leaving the mysql client by the command quit. - -Using a text editor, open the file my.cnf located in the directory / -etc and add these 3 lines in the section [mysqld]: - -default-character-set = utf8 -character-set-server = utf8 -skip-character-set-client-handshake - -To ensure that this change is taken into account, restart the server -Mysql using the following command in a terminal window: -mysqld restart service - -Check that changing the parameters was taken into account by reconnecting -the MySQL server with the command mysql, then typing the query: - -show where variable_name variables like 'char%'; -The variables contain well utf8 / -Quit MySQL by the command quit - -****************************************************************** -Screenshot - MySQL -Welcome to the MySQL monitor. Commands end with; or \g. -Your MySQL connection id is 2 -Server version: 5.0.45 Source distribution - -Type 'help,' or '\h' for help. Type '\c' to clear the buffer. - -mysql> show where variable_name variables like 'char%'; -+--------------------------+----------------------------+ -| Variable_name | Value | -+--------------------------+----------------------------+ -| Character_set_client | utf8 | -| Character_set_connection | utf8 | -| Character_set_database | utf8 | -| Character_set_filesystem | Binary | -| Character_set_results | utf8 | -| Character_set_server | utf8 | -| Character_set_system | utf8 | -| Character_sets_dir | /usr/share/mysql/charsets/ | -+--------------------------+----------------------------+ -8 rows in set (0.00 sec) - -MySQL> quit -Bye -****************************************************************** - -Some information for the use of MySQL here: HYPERLINK "http://doc.ubuntu-fr.org/mysql" http://doc.ubuntu-fr.org/mysql - -2 INSTALLATION OF ZEBRA SERVER INDEXING - -For libraries that must manage several tens of thousands of bib records -it is recommended that you install the server indexing ZEBRA. Otherwise -(far fewer records to manage), it is not necessary to install ZEBRA. - -The software installation ZEBRA requires prior installation of software -modules YAZ client and server Z3950. - -The installation is as administrator (root). - -NB: the creation of files yaz and zebra is only necessary if you use -the graphical - -Website for downloads: HYPERLINK "http://www.indexdata.dk/software/" http://www.indexdata.dk/software/ - - -2.1 Installation of the software YAZ - -Creating a file needed for the installation of Yaz -Create files redhat in the directory /usr/src -SOURCES Create a folder in the directory /usr/src/redhat -NB: redhat lowercase and uppercase SOURCES. - -Installing Yaz by the command: -rpm-ivh ftp://ftp.indexdata.dk/pub/yaz/redhat/fc6/ *- 3.0.24 *.*. rpm -Check the final published version and replace -3.0.24 by the number -of the current version. - -Check the installation by the command: -rpm-q libyaz3 libyaz3-devel yaz yaz-debuginfo yaz-icu-yaz illclient yaz-3.0.24-1.src - - -2.2 Installation of the software ZEBRA - -To install packages from the version 2.0.26-1: -rpm-ivh ftp://ftp.indexdata.dk/pub/zebra/redhat/fc6/ *- 2.0.26-1 .*. rpm -Check dernère published version and replace -2.0.26-1 by the -number of the current version. - -Check the installation by the command: -rpm-q libidzebra-2.0-2.0-libidzebra modules idzebra-2.0 idzebra-2.0-debuginfo libidzebra-2.0-devel idzebra-2.0 - -3 INSTALLATION OF KOHA 3.0 - -Important Reminder: -Make sure, BEFORE you install koha, that the system Linux, the MySQL -server and the Apache server are configured to use the Unicode -format (cf. 1.4). - - -Download koha here: HYPERLINK "http://download.koha-community.org/koha-3.00.00-beta2.tar.gz" http://download.koha-community.org/koha-3.00.00-beta2.tar.gz - -3.1 Decompression of the archive koha 3.0 - -Save the file in the directory /usr/share. -Opening a window Terminal, and placing himself in the directory /usr/share by the command: -cd /usr/share -verify the presence of compressed file koha by the command: -ls-l * Koha -Unzip the file with the command tar: -tar-xvf koha-3.00.00-beta2.tar.gz -You get a folder koha-3.00.00-beta2, which contains folders and files needed for the installation of software koha. - -NB: the installation procedure is described in the text files "INSTALL" -and "INSTALL debian", the second is more complete. - - -3.2 Protect access to the database server MySQL - -Update the password root server MySQL (by default, unprotected access to databases) -In a Terminal window: -sudo password mysqladmin Koha - -3.3 Creation of a database MySQL test - -The basic test is immediately under Fedora. We must remove the existing basic -test and then create a basic test MySQL provisional, which will be deleted -after installing koha. - -mysql-u root-p -Enter password: kohakoha (eg) - -mysql> drop test database; -Query OK, 0 rows affected (0.06 sec) - -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) - -MySQL> flush privileges; -Query OK, 0 rows affected (0.00 sec) - -MySQL> quit -Bye - - -3.4 Creation of the MySQL database koha - -Creation of the database, a user kohaadmin with password and defining its -privileges. - -In a Terminal window: -mysql-u root-p -Enter password: type kohakoha (eg a password for root) -Create Database Koha; -grant all on koha .* to 'kohaadmin' @ 'localhost' identified by 'kohakoha'; -flush privileges; -quit; - -3.5 Configuration CPAN - -The koha software is written in Perl. You have access to deposits modules -written in perl (CPAN) to download some libraries on your system. The Perl -language of origin is installed on most Linux distributions, but some modules -must be installed. -During the first use of cpan, you must configure. - -Open a terminal window and type the command cpan - -During the installation of modules, validate the additions of modules when -necessary. Indicate the continent and the country. Select 3 or 4 CPAN deposits -in the proposed list. - -It is possible to force the installation of a module. In this case, in a -Terminal window, type: - -cpan -then force install NomDuModule -then quit - -****************************************************************** -Screenshot: -/usr/lib/perl5/5.8.8/CPAN/Config.pm initialized. - - -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. - -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.) - -Are you ready for manual configuration? [yes] - - -The following questions are intended to help you with the -configuration. The CPAN module needs a directory of its own to cache -important index files and maybe keep a temporary mirror of CPAN files. -This may be a site-wide directory or a personal directory. - - - -First of all, I'd like to create this directory. Where? - -CPAN build and cache directory? [/ root/.cpan] - - -If you want, I can keep the source files after a build in the cpan -Home directory. If you choose so then future builds will take the -files from there. If you do not want to keep them, answer to the 0 -Next question. - - - -How big should the disk cache be for keeping the build directories -with all the intermediate files? - -Cache size for build directory (in MB)? [10] - - -By default, each time the CPAN module is started, scanning cache -is performed to keep the cache size in sync. To prevent from this, -disable the cache scanning with 'never'. - -Perform cache scanning (atstart or never)? [atstart] - - -To considerably speed up the initial CPAN shell startup, it is -Storable possible to use to create a cache of metadata. If Storable -is not available, the normal index mechanism will be used. - -Cache metadata (yes/no)? [yes] - - -The next option deals with the charset your terminal supports. In -general CPAN is English speaking territory, thus the charset does not -matter much, but some of the aliens out there who upload their -software to CPAN bear names that are outside the ASCII range. If your -terminal supports UTF-8, you say no to the next question, if it -supports ISO-8859-1 (also known as LATIN1) then you say yes, and if it -neither supports nor, your answer does not matter, you will not be -able to read the names of some authors anyway. If you answer no, names -will be output in UTF-8. -Your terminal expects iso-8859-1 (yes/no) [yes] - -If you have one of the readline packages (Term: ReadLine: Perl, -Term: ReadLine: Gnu, possibly others) installed, the interactive CPAN -Shell will have history support. The next two questions deal with the -filename of the history file and with its size. If you do not want to -set this variable, please hit SPACE RETURN to the following question. - -File to save your history? [/root/.cpan/histfile] -Number of lines to save? [100] - - -The CPAN module can detect when a module that which you are trying to -build depends on prerequisites. If this happens, it can build the -prerequisites for you automatically ('follow'), ask you for -confirmation ('ask'), or just ignore them ('ignore'). Please set your -policy to one of the three values. - -Policy on building prerequisites (follow, ask or ignore)? [ask] - - -The CPAN module will need a few external programs to work properly. -Please correct me, if I guess the wrong path for a program. Do not -panic if you do not have some of them, just press ENTER for those. To -disable the use of a download program, you can type a space followed -by ENTER. - - -Where is your gzip program? [/bin/gzip] -Where is your tar program? [/bin/tar] -Where is your unzip program? [/usr/bin/unzip] -Where is your make program? [/usr/bin/make] -Where is your links program? [/usr/bin/links] -Where is your wget program? [/usr/bin/wget] -Where is your ncftpget program? [/usr/bin/ncftpget] -Where is your ftp program? [/usr/bin/ftp] -Where is your gpg program? [/usr/bin/gpg] -What is your favorite pager program? [/usr/bin/less] -What is your favorite shell? [/bin/bash] - - -Every Makefile.PL is run by perl in a separate process. Likewise we -run 'make' and 'make install' in processes. If you have any -parameters (eg PREFIX, LIB, UNINST or the like) you want to pass -to the calls, please specify them here. - -If you do not understand this question, just press ENTER. - -Parameters for the 'perl Makefile.PL' command? -Typical frequently used settings: - - PREFIX = ~/perl non-root users (please see manual for more hints) - - -Every Makefile.PL is run by perl in a separate process. Likewise we -run 'make' and 'make install' in processes. If you have any -parameters (eg PREFIX, LIB, UNINST or the like) you want to pass -to the calls, please specify them here. - -If you do not understand this question, just press ENTER. - -Parameters for the 'perl Makefile.PL' command? -Typical frequently used settings: - - PREFIX = ~/perl non-root users (please see manual for more hints) - -Your choice: [] -Parameters for the 'make' command? -Typical frequently used setting: - - J3 dual-processor system - -Your choice: [] -Parameters for the 'make install' command? -Typical frequently used setting: - - UNINST = 1 to always uninstall potentially conflicting files - -Your choice: [] - - -Sometimes you may wish to leave the processes run by CPAN alone -without caring about them. As sometimes contains the Makefile.PL -question you're expected to answer, you can set a timer that will -kill a 'perl Makefile.PL' process after the specified time in seconds. - -If you set this value to 0, these processes will wait forever. This is -the default and recommended setting. - - -Timeout for inactivity during Makefile.PL? [0] - - -If you're accessing the net via proxies, you can specify them in the -CPAN configuration or via environment variables. The variable in -the $ CPAN:: Config takes precedence. - -Your ftp_proxy? -Your http_proxy? -Your no_proxy? -You have no/root/.cpan/sources/MIRRORED.BY - I'm trying to fetch one -CPAN: LWP:: UserAgent loaded ok -Fetching with LWP: - ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY -Fetching with LWP: - ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY.gz -Fetching with Net: FTP: - ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY - - -Now we need to know where your favorite CPAN sites are located. Push -a few sites onto the array (just in case the first on the array will not -work). If you are mirroring CPAN to your local workstation, specify a -file: URL. - -First, pick a nearby continent and country (you can pick several of -each, separated by spaces, or none if you just want to keep your -existing selections). Then, you will be presented with a list of URLs -CPAN of mirrors in the countries you selected, along with previously -selected URLs. Select some of those URLs, or just keep the old list. -Finally, you will be prompted for any extra URLs - file:, ftp:, or -http:-- that host a CPAN mirror. - -(1) Africa -(2) Asia -(3) Central America -(4) Europe -(5) North America -(6) Oceania -(7) South America -Select your continent (or several nearby continents) [] 4 -Sorry! since you do not have any existing picks, you must make a -Geographic selection. - -(1) Austria -(2) Belgium -(3) Bosnia and Herzegovina -(4) Bulgaria -(5) Croatia -(6) Czech Republic -(7) Denmark -(8) Finland -(9) France -(10) Germany -(11) Greece -(12) Hungary -(13) Iceland -(14) Ireland -(15) Italy -(16) Latvia -15 more items, hit SPACE RETURN to show them -Select your country (or several nearby countries) [] 9 -Sorry! since you do not have any existing picks, you must make a -Geographic selection. - -(1) ftp://cpan.cict.fr/pub/CPAN/ -(2) ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/ -(3) ftp://distrib-coffee.ipsl.jussieu.fr/pub/mirrors/cpan/ -(4) ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/ -(5) ftp://ftp.erasme.org/pub/CPAN/ -(6) ftp://ftp.inria.fr/pub/CPAN/ -(7) ftp://ftp.oleane.net/pub/CPAN/ -(8) ftp://ftp.pasteur.fr/pub/computing/CPAN/ -(9) ftp://ftp.u-strasbg.fr/CPAN -(10) ftp://mir1.ovh.net/ftp.cpan.org -(11) ftp://miroir-francais.fr/pub/cpan/ -(12) http://cpan.ebsd.net/ -(13) http://cpan.enstimac.fr/ -(14) http://cpan.univ-paris.com -Select URLs as many as you like (by number), -put them on one line, separated by blanks, e.g. '1 4 5 [] 1 2 4 10 - -Enter another URL or RETURN to quit: [] -New set of picks: - ftp://cpan.cict.fr/pub/CPAN/ - ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/ - ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/ - ftp://mir1.ovh.net/ftp.cpan.org - - -commit: wrote /usr/lib/perl5/5.8.8/CPAN/Config.pm -Terminal does not support AddHistory. - -cpan shell - CPAN exploration and modules installation (v1.7602) -ReadLine support available (try 'install Bundle: CPAN') - -cpan> quit -************************************************** **************** - -Type quit to break cpan - - - -3.6 Installation of additional modules from CPAN - -3.6.1 modules installation - -Install Command: cpan NomDuModule to install and validate the default -choice for each question. - -List of modules required to koha need to install: -Class::Accessor -XML::SAX -XML::RSS -XML::LibXML::SAX -MARC::Record -MARC::Charset -MARC::Charset::Constants -MARC::File::XML -Net::Z3950::ZOOM -Net::LDAP::Filter -HTML::Template::Pro -Data::ICal -DateTime -DateTime::Format::ICal -GD::Barcode::UPCE -Algorithm::CheckDigits::M43_001 -Biblio::EndnoteStyle -Schedule::At -Barcode::Code128 -CGI::Session -Class::Factory::Util -Date::Manip -Lingua::Stem -List::MoreUtils -PDF::Reuse -PDF::Reuse::Barcode -PDF::API2 -PDF::API2::Util -Text::CSV -Text::CSV_XS -XML::Dumper -XML::LibXSLT -XML::Simple -YAML::Syck -Unix::Syslog -Date::Calc -CHI -CHI::Driver::Memcached - - -3.6.2 Installation of modules - Cases difficult - -In some cases, we must force the installation of modules. The two -modules (and sometimes others) need to force the installation. -Type the command cpan, then: - -force install Mail: Sendmail ======= force install ok For this unit -should be Ctrl + C, when he attempted to send an e-mail. -force install Net:: LDAP ======= force install ok - - - -3.6.3 Installing module access MySQL DBMS - -Installation of the connector DBD::mysql for perl - -We will have to rebuild this module because koha requires the latest version. - -In a window Terminal: -cpan -cpan> o conf makepl_arg - (search parameters for the CPAN) - -cpan> o conf makepl_arg "- testdb = test - testuser = test - testpass = test" - -cpan> install DBD:: mysql - -cpan> o conf makepl_arg'' - (clean to avoid interference with future installations modules). - -cpan> quit - - -Destruction of the basis of test MySQL - -In a terminal window -mysql-u root-p -Enter password: kohakoha -Database drop test; -quit - - -3.7 Test SAX Parser - -In a Terminal window, go to the installation directory koha. -CD /usr/share/koha-3.00.00-alpha/misc -launch the script sax_parser_print.pl -./sax_parser_print.pl -which returns: XML::LibXML::SAX = HASH (0x895a3fc) - -The file /usr/lib/perl5/site_perl/5.8.8/XML/SAX/ParserDetails.ini should be amended to -contain the final (save the other lines to comment or delete): -[XML::LibXML::SAX::Parser] -Http://xml.org/sax/features/namespaces = 1 - - -3.8 Installation of Koha - -Opening a window Terminal and placed in the directory koha -CD /usr/share/koha-3.00.00-alpha -launch the script Makefile.PL -perl Makefile.PL - -Most options are to be validated by default. The data to information are -password based koha, format Marc (Marc21 or Unimarc), language indexing -Zebra (or en). It should be noted that the three ports will be open: -3306, 9998, 9999. - -************************************************** **************** -Screenshot -By default, Koha can be installed in one of three ways: - -Standard: Install files in conformance with the Filesystem - Hierarchy Standard (FHS). This is the default mode - and should be used when installing a production - Koha system. On Unix systems, root access is - needed to complete a standard installation. - -single: Install files under a single directory. This option - is useful for installing Koha without root access, eg, - on a web host that allows CGI scripts and MySQL databases - but requires the user to keep all files under the user's - HOME directory. - -dev: Create a set of symbolic links and configuration files to - Koha allow to run directly from the source distribution. - This mode is useful for developers who want to run - Koha from a git clone. - -Installation mode (dev, single, standard) [standard] - -Please specify the directory under which most Koha files -will be installed. - -Note that if you are planning in installing more than -one instance of Koha, you may want to modify the last -component of the directory path, which will be used -as the package name in the FHS layout. - -Base installation directory [/usr/share/koha] - -Since you are using the 'standard' install -mode, you should run 'make install' as root. -However, it is recommended that a non-root -user (on Unix and Linux platforms) have -ownership of Koha's files, including the -Zebra indexes if applicable. - -Please specify a user account. This -user account does not need to exist -right now, but it needs to exist -before you run 'make install'. Please -note that for security reasons, this -user should not be the same as the user -account Apache runs under. - -User account [koha] - -Please specify the group that should own -Koha's files. As above, this group need -not exist right now, but should be created -before you run 'make install'. - -Group [koha] - -Please specify which database engine you will use -to store data in Koha. The choices are MySQL and -PostgreSQL; please note that at the moment -PostgreSQL support is highly experimental. - -DBMS to use (Pg, mysql) [mysql] - -Please specify the name or address of your -database server. Note that the database -does not have to exist at this point, it -can be created after running 'make install' -and before you try using Koha for the first time. - -Database server [localhost] - -Please specify the port used to connect to the -DMBS [3306] - -Please specify the name of the database to be -used by Koha [koha] - -Please specify the user that owns the database to be -used by Koha [kohaadmin] - -Please specify the password of the user that owns the -database to be used by Koha [katikoan] kohakoha - -Koha can use the Zebra search engine for high-performance -searching of bibliographic and authority records. If you -have installed the Zebra software and would like to use it, -please answer 'yes' to the following question. Otherwise, -Koha will default to using its internal search engine. - -Please note that if you choose *NOT* to install Zebra, -koha-conf.xml will still contain some references to Zebra -settings. Those references will be ignored by Koha. - - -Install the Zebra configuration files? (no, yes) [yes] - -Since you've chosen to use Zebra with Koha, -you must specify the primary MARC format of the -records to be indexed by Zebra. - -Koha provides Zebra configuration files for MARC 21 -and UNIMARC. - -MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc - -Koha supplies Zebra configuration files tuned for -searching either English (en) or French (fr) MARC -records. - - -Primary language for Zebra indexing (en, fr) [en] fr - -Please specify Zebra database user [kohauser] - -Please specify the Zebra database password [zebrastripes] - -Since you've chosen to use Zebra, you can enable the SRU/ -Z39.50 Server if you so choose, but you must specify a -few configuration options for it. - -Please note that if you choose *NOT* to configure SRU, -koha-conf.xml will still contain some references to SRU -settings. Those references will be ignored by Koha. - - -Install the SRU configuration files? (no, yes) [yes] - -SRU Database host? [localhost] - -SRU port for bibliographic data? [9998] - -SRU port for authority data? [9999] - - - - -Koha will be installed with the following configuration parameters: - -DB_HOST localhost -DB_NAME koha -DB_PASS koha -DB_PORT 3306 -DB_TYPE mysql -DB_USER kohaadmin -INSTALL_BASE /usr/share/koha -INSTALL_MODE standard -INSTALL_SRU yes -INSTALL_ZEBRA yes -KOHA_GROUP koha -KOHA_USER koha -ZEBRA_LANGUAGE fr -ZEBRA_MARC_FORMAT unimarc -ZEBRA_PASS zebrastripes -ZEBRA_SRU_AUTHORITIES_POR9999 -ZEBRA_SRU_BIBLIOS_PORT 9998 -ZEBRA_SRU_HOST localhost -ZEBRA_USER kohauser - -and in the following directories: - -DOC_DIR /usr/share/koha/doc -INTRANET_CGI_DIR /usr/share/koha/intranet/cgi-bin -INTRANET_TMPL_DIR /usr/share/koha/intranet/htdocs/intranet-tmpl -INTRANET_WWW_DIR /usr/share/koha/intranet/htdocs -KOHA_CONF_DIR /etc/koha -LOG_DIR /var/log/koha -MAN_DIR /usr/share/koha/man -MISC_DIR /usr/share/koha/misc -OPAC_CGI_DIR /usr/share/koha/opac/cgi-bin -OPAC_TMPL_DIR /usr/share/koha/opac/htdocs/opac-tmpl -OPAC_WWW_DIR /usr/share/koha/opac/htdocs -PERL_MODULE_DIR /usr/share/koha/lib -SCRIPT_DIR /usr/share/koha/bin -ZEBRA_CONF_DIR /etc/koha/zebradb -ZEBRA_DATA_DIR /var/lib/koha/zebradb -ZEBRA_LOCK_DIR /var/lock/koha/zebradb -ZEBRA_RUN_DIR /var/run/koha/zebradb - - -To change any configuration setting, please run -perl Makefile.PL again. To override one of the target -directories, you can do so on the command line like this: - -perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8 - -You can also set different default values for parameters -or override directory locations by using environment variables. - -For example: - -export DB_USER=my_koha -perl Makefile.PL - -or - -DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL - -Checking if your kit is complete... -Looks good -Writing Makefile for koha -************************************************** **************** - -Taper la commande make - -Taper la commande make test (ne pas tenir compte des erreurs listées) - -Taper la commande make install - - - -4 CONFIGURATION POST INSTALLATION - -.1 Saving environment variables - -As indicated at the end of the installation (see screen shot), we must add two environment variables: - -Entering the two lines below a window in Terminal: -export KOHA_CONF=/etc/koha/koha-conf.xml -export PERL5LIB=/usr/share/koha/lib - -Seizures of this event, both variables are recorded on a temporary basis. If these variables are definitely enr -egistrées we must add these two lines in the file. bash_profile or. bashrc users root and koha. - - -4.2 Creation of the database -The base is not created. It is a bug, we must launch a script to recreate it. In a Terminal window, type: -mysql -user=kohaadmin -password=kohakoha koha use Koha; -Reading table information for completion of table and column names -You can turn off this feature to get a quicker startup with A - - -Database changed -MySQL> show tables; -+----------------------------+ -| Tables_in_koha | -+----------------------------+ -| accountlines | -| accountoffsets | -| action_logs | -| alert | -| aqbasket | -| aqbookfund | -| aqbooksellers | -| aqbudget | -| aqorderbreakdown | -| aqorderdelivery | -| aqorders | -| auth_header | -| auth_subfield_structure | -| auth_tag_structure | -| auth_types | -| authorised_values | -| biblio | -| biblio_framework | -| biblioitems | -| borrowers | -| branchcategories | -| branches | -| branchrelations | -| branchtransfers | -| browser | -| categories | -| cities | -| class_sort_rules | -| class_sources | -| currency | -| deletedbiblio | -| deletedbiblioitems | -| deletedborrowers | -| deleteditems | -| ethnicity | -| import_batches | -| import_biblios | -| import_items | -| import_record_matches | -| import_records | -| issues | -| issuingrules | -| items | -| itemtypes | -| labels | -| labels_conf | -| labels_templates | -| language_descriptions | -| language_rfc4646_to_iso639 | -| language_script_bidi | -| language_script_mapping | -| language_subtag_registry | -| letter | -| marc_matchers | -| marc_subfield_structure | -| marc_tag_structure | -| matchchecks | -| matcher_matchpoints | -| matchpoint_component_norms | -| matchpoint_components | -| matchpoints | -| notifys | -| opac_news | -| overduerules | -| printers | -| repeatable_holidays | -| reports_dictionary | -| reserves | -| reviews | -| roadtype | -| saved_reports | -| saved_sql | -| serial | -| services_throttle | -| sessions | -| special_holidays | -| statistics | -| subscription | -| subscriptionhistory | -| subscriptionroutinglist | -| suggestions | -| systempreferences | -| tags | -| userflags | -| virtualshelfcontents | -| virtualshelves | -| z3950servers | -| zebraqueue | -+----------------------------+ -93 rows in set (0.00 sec) - -mysql> quit -****************************************************************** - -4.3 Changing the configuration of the Apache server - -Create a link koha in the directory /etc/httpd/conf.d/ pointing to the configuration file of koha for apache. -Open /etc/koha/koha-httpd.conf and paste the contents of this file at the end of /etc/httpd/conf/httpd.conf - -Editing httpd.conf located in the directory /etc/httpd/conf, so the Apache web server is reachable on port 8 -0 (standard) and also on port 8080. -Find string Listen 80 and add a new line below with the string Listen 8080 -Restarting the service httpd. On a Terminal window, type service httpd restart. - -Lancer Zebra Server -zebrasrv east /usr/bin -with the name zebrasrv-2.0 -go to the directory /usr/bin -cd /usr/bin -koha become user by typing the command su: -su Koha -zebra start the server by the command: -./zebrasrv-2.0-f /etc/koha/koha-conf.xml - -Starting the daemon Zebraqueue -zebraqueue_daemon.pl is in /usr/share/koha/bin -go in /usr/share/koha/bin -cd /usr/share/koha/bin -and launch the script zebraqueue_daemon.pl -. /zebraqueue_daemon.pl - - -4.4 loading data for tests - -This step helps to have some input in Koha for testing purposes (table cataloguing default, etc.). - -Disable temporarily SElinux -SE-LINUX blocking access to KOHA. -Menu K Hotel è è SElinux -Then turn off Selinux and relaunch the service iptables - -Unlocking ports -It must grant access to ports 3306, 9998 and 9999 -Menu K Hotel è è Firewall and SElinux -Other ports and click Add button. -When the 3 ports are added, click Apply, then click the button. - -Using the Web installer -We must move the fr located in /usr/share/koha/intranet/cgi-bin/data/mysql en-US (installer points to the directory -en-ing and not en). - -Connect to Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080 and use the Web installer french (en-US). - --- Validate Step 1 (dependencies); --- Step 2 (settings of the database on two screens); --- A Phase 3, click on Install the basic settings (screen 1), select the declination Marc (Unimarc_complet in our -Where Unimarc_lecture_pub; screen 2), select default settings and then click on Import (only settings obligat -oires are checked by default; screen 3); --- The screen 4 summarizes what has been imported; --- Finally, the screen 5 indicates the end of the installation; then you just have to click Finish. - -Complements -Connect to PhPMyadmin: HYPERLINK "http://localhost/phpmyadmin" http://localhost/phpmyadmin -Connect to interface professional Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080 -Connect to online catalogue Koha: HYPERLINK "http://localhost:80/" http://localhost:80 - -Zebra is in /etc/koha -The files perl Koha professional can be found in /usr/share/koha/intranet/cgi-bin (then a large repertoire by fonctionnal -ities of SIGB) -The files perl Koha public are in /usr/share/koha/koha/cgi-bin diff --git a/INSTALL.opensuse b/INSTALL.opensuse deleted file mode 100644 index 7784d6e..0000000 --- a/INSTALL.opensuse +++ /dev/null @@ -1,1375 +0,0 @@ -= Installation Guide for Installing Koha 3.0.0 on openSUSE 11.3 = - -Original version for openSUSE 11.0 created by Ricardo Dias Marques - koha@ricmarques.net -Version for openSUSE 11.3 adapted by Freek de Kruijf - freek -at- opensuse -dot- org - -No liability for the contents of this document can be accepted. - -Feedback/bug reports: Koha Developer's List: - -http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel - -This document last modified: 20 Mar 2012 - -== Installation Instructions == - -This document was prepared in order to help you discover (or test) Koha (Integrated Library System). - -The installation of Linux system described below is a basic, it is not designed for a production server (e.g., security, load balancing ... are not described). - -This document describes the different stages of installing the software Koha 3 on the openSUSE 11.3 Linux distribution in a "new" computer, the author uses a VirtualBox virtual machine, that is, a virtual computer that will have its virtual hard disk contents COMPLETELY ERASED to install openSUSE and Koha! - -In this example, the virtual machine uses a bridged network connection, which mimics a separate computer in the local network, it's assumed that your server gets an IP address by DHCP that later will be changed to 192.168.1.16. - -You'll have to change this to the real IP address that your machine should get (or use DHCP, if that's the case). - -This tutorial assumes a Koha installation that does NOT use Zebra ("Zebra is a high-performance, general-purpose structured text indexing and retrieval engine" - http://www.indexdata.dk/zebra/). Additional steps would be required to set up Zebra for Koha, however it will be installed. - -=== LINUX System Installation === - -Download openSUSE 11.3 DVD from [http://software.opensuse.org/ here]. - -Place the DVD in the drive and restart the machine. In the case of a virtualmachine the iso image is still on the disc and you connect it as a DVD to the virtual machine. - -After the "Welcome" screen, you'll get a First menu, with the following options: - ----- -Boot from Hard Disk - -Installation - -Repair Installed System - -Rescue System - -Firmware Test - -Memory Test ----- - -You may want to change the screen size to 1024 x 768 by pressing F3. -Choose "Installation" (second command) - -==== "Initializing" screen ==== - -(Dialog box appears saying "Probing Mouse") - -==== "Welcome" screen ==== - -You'll see two Dropdown Lists: "Language" and "Keyboard Layout" - -This depends of your place and preference, naturally. -I live in The Netherlands, and we use the English (US) Keyboard Layout but I prefer an Operating System in English. -So I leave the default option selected for "Language" and "Keyboard Layout" to (English (US)). - -Check the "I Agree to the License Terms" checkbox (under the "License Agreement" textbox). - -Click the "Next" button. - -==== "System Probing" screen ==== - -[just watch it...] - -==== "Installation Mode" screen ==== - -Leave "New Installation" radio button checked - -I prefer not to have the "Automatic Configuration" so this option is unchecked. -It gives you the possibility to specify the name of the system and the network setup. - -Click the "Next" button - -==== "Initializing" screen ==== - -[just watch it...] - -==== "Clock and Time Zone" screen ==== - -I do this work in Yemen, so I select the following options: - -"Region" listbox: click on "Asia" - -"Time Zone" listbox: click on "Aden" - -I leave the "Hardware Clock Set To UTC" checkbox checked. - -Click the "Next" button - -==== "Desktop Selection" screen ==== - -You should see three radio buttons: "GNOME Desktop", "KDE Desktop" and "Other". - -Click on the "Other" radio button. - -Four radio buttons should become visible then: - -"XFCE Desktop" - -"LXDE Desktop" - -"Minimal X Window" - -"Minimal Server Selection (Text Mode)" - -click on this last "Minimal Server Selection (Text Mode)" radio button. - -Click the "Next" button - -==== "Suggested Partitioning" screen ==== - -Partitioning choices are really up to you. In this example, I started with a 8 GB virtual disc and I will create a 1000 MB swap partition and the rest is the root "/" partition. - -So, to do this I click on the "Create Partition Setup..." button. - -===== "Preparing Hard Disk: Step 1" screen ===== - -I click on the first radio button: -"1: 1.IDE 8.0 GB,/dev/sda" - -I click the "Next" button - -===== "Preparing Hard Disk: Step 2" screen ===== - -I uncheck the "Propose separate Home Partition" checkbox. - -I click the "Next" button. - -This takes me back to the Suggested Partitioning screen. - -===== "Suggested Partitioning" screen ===== - -In my case, I now have this: - -- Create swap volume /dev/sda1 (1004.06 MB) - -- Create root volume /dev/sda2 (7.02 GB) with ext4 - -I click the "Next" button. - -==== "Create New User" screen ==== - -I use this screen to create a regular user. - -User's full name: Your Full name (e.g: John Smith) - -Username: Your preferred username (e.g.: jsmith) - -Password: - -Confirm Password: - -I uncheck the "Use this password for System Administrator" checkbox. - -I check the "Receive System Mail" - -I uncheck the "Automatic Login" checkbox. - -I click the "Next" button (you may be "nagged" with a dialog box by the YAST2 installer warning that you selected a password that it considers to be too simple. Click "Yes" to keep the password you chose, or "No" to change it). - -==== Password for the System Administrator "root" screen ==== - -Enter your password (in the "Password for root User" text box) and repeat it (in the "Confirm Password" text box). - -Click the "Next" button to proceed to the "Installation Settings" screen. - -==== "Installation Settings" screen ==== - -Click on the "Software" link - -==== "Software Selection and System Tasks" screen ==== - -Scroll down the listbox (that begins with the "Base Technologies" group) until you find the "Server Functions" group. - -In that "Server Functions" group click on the "Web and LAMP Server" checkbox (to check it) - -Click on the "OK" button to return to "Installation Settings" - -==== "Installation Settings" screen ==== - -Click on the "Install" button (placed in the same place where usually appear the "Accept" or "Next" button). - -You should see a "Confirm Installation" dialog box. Click on the "Install" button of that dialog box. - -==== "Preparing Your Hard Disk" screen ==== - -[just watch it...] - -==== "Deploying Installation Images" screen ==== - -[just watch it... ] - -==== "Package Installation" screen ==== - -[just watch it... or click on the "Details" tab if you want to see what packages are being installed.] - -==== "Finishing Basic Installation" screen ==== - -[just watch it... ] - -After some time you'll see a dialog box warning that the system will reboot in 10 seconds. - -==== After reboot ==== - -Leave "Boot from Hard Disk" selected and press ENTER - -You'll have to wait a while (or press ESC to see what the operating system is "doing"). After some moments, you'll be taken to the "Yast2 - installation @ Linux" screen (a text installer). - -On the screen you will see Hostname and Domain Name with a textbox below. -The cursor is in the textbox below Hostname. -Press the Backspace to delete the name there and insert the name of your system, e.g. koha-server. -Pres Tab and Backspace to delete "site" and enter the domain name, e.g. "univ.org". -Press Tab go to Change Hostname via DHCP en press Space to remove the "x". -Leave the "x" in Assign Hostname to Loopback IP. -Press +N to activate "Next". Now you enter: - -==== Network Configuration ==== - -Press ALT+C to Change Network Settings. Use the Arrow Keys to Highlight "Firewall" and press RETURN. -Proceed to Firewall and press RETURN. Go to "Allowed Services" and press RETURN. Press TAB several times to highlight "HTTP Server". -Press ALT+A to add HTTP Server to the list. Press ALT+S to choose the next Service to Allow. -Press the Down Arrow and a drop down box will appear and press the Down Arrow several times to select Secure Shell Server and press RETURN. -Press ALT+A to Add. -We also need port 8080 for the management of Koha to be open, so press ALT+D to activate (Advanced...). -Press ALT+T to go to TCP Ports and enter 8080 in the textbox. -Pressing Alt+O for OK, brings you back to the Firewall Configuration. -Pressing Alt+O for OK, brings you back to Network Configuration, but now you see the SSH port is open, the 8080 port is not shown. -Press Alt+N for Next, which brings you to: Saving Network Configuration and finally to: - -==== Test Internet Connection ==== - -Press RETURN to activate Next and do the test. -If all is well you should see "Test Result: Success". -Press RETURN to activate Next. -Now the meta data of some repositories will be downloaded and the next screen will appear: - -==== Online Update ==== - -Here you can choose to do an online update or not. -Press RETURN to activate Next and the update will be done. -In my case the update even replaced the kernel. Press ALT+A to Accept the update. -After that you press RETURN to activate Next. -A warning may appear saying that the system will reboot. - -You will see the first screen of booting of the DVD again, but again you choose Boot from Hard Disk, which will also happen when you do not do anything. - -After that you will see the normal system boot screen and you do not need to do anything, but you may press RETURN to speed up the start of booting from the disc. -In my case, after booting, the installtion went on and showed a screen of the YaST2 Package Manager showing the Release Notes. -Press RETURN to continue. -Now a screen asking about Hardware Configuration appeared. Press RETURN to continue. - -Next a screen appears showing Installation Completed. -Press RETURN to continue and you will see the startup log messages and at the end the following: - -|-------------------- -Welcome to openSUSE 11.3 "Teal" - Kernel 2.6.34.7-0.3-desktop (tty1) - -koha-server login: -|-------------------- - -You may now login with your "root" user. - -==== Changing the Hostname and Domain Name ==== - - -Maybe you want to change the hostname, domain name and switch from DHCP to a Static IP address. -Changing the hostname and domain name will not be shown here, because we assume that was done according to your whishes during installation. - -This is how you can do it. You give the command yast (the setup tool) on the command prompt: -|-------------------- -koha-server:~ # yast -|-------------------- - -Yast should appear. - -On the listbox of the left hand side select "Network Devices" (press TAB to turn focus on that listbox, and press the down arrow key several times to reach it). -Then, on the listbox of the right hand side, select "Network Settings" (you'll have again to press TAB to turn focus on that listbox, and press the down arrow key several times to reach it). - -Press the ENTER key. - -==== "Initializing Network Configuration" screen ==== - -[just watch it...] - -==== "Network Settings" screen ==== - -I want to disable IPv6, so I first go to the "Global Options" section (by pushing the key combination ALT+G to press the "G" letter in Global Options that is highlighted). -In the next screen, I push ALT+E to uncheck the "Enable IPv6" checkbox. -I'll get a dialog box with a Warning saying that "To apply this change a reboot is needed.". -I just press ENTER on that dialog box, but I do NOT reboot (at least not yet). - -Then I press Alt+V to go to the "Overview" (still in "Network Settings"). -Then I press ALT+I to "Edit" the information for this Network Card. - -==== "Network Card Setup" screen ==== - -I check the "Statically assigned IP Address" checkbox, and enter the following info for "IP Address", "Subnet Mask" and "Hostname" (you should use the values defined by your network administrator): - -IP Address: 192.168.1.16 -Subnet Mask: 255.255.255.0 -Hostname: koha-server.univ.org - -Then I press ALT+N to click the "Next" button. After a few seconds, I will be taken again to the "Network Settings" screen. - -==== "Network Settings" screen ==== - -I press ALT+S to go to the "Hostname/DNS" screen. - -Press ALT+I and the Arrow Key to choose "Only Custom Policy" by pressing Enter, press Tab to choose "Custom Policy Rule" and select "STATIC". -Enter the IP Address of the Domain Name Server in the "Name Server 1" text box: - -Name Server 1: 192.168.1.254 - -Then I press ALT+U to go to the "Routing" configuration. - -==== "Routing" screen ==== - -In the "Default Gateway" text box, I enter the IP Address of my Default Gateway: - -Default Gateway: 192.168.1.254 - -Then I press ALT+O for OK to Finish - -==== "Saving Network Configuration" screen ==== - -[just watch it...] - -After a few seconds, you should be taken back to the "YaST2 Control Center" screen. -Press ALT+Q to Quit YaST2. - -==== Making the ssh-daemon to start at system start ==== - -We need a ssh-daemon that does not accept Environment parameters from the remote user. -So we have to disable accepting these. -For this you use vim to change the config file of sshd. - -|-------------------- -# cp /etc/ssh/sshd_config /etc/ssh/sshd_config.ORIG -# vi /etc/ssh/sshd_config -|-------------------- - -Find the lines starting with AcceptEnv and insert a # in front of these, There are three lines. -Afterwards these lines will look like: -|-------------------- -#AcceptEnv LANG LC_CTYPE LC_NUMERIC LC_TIME LC_COLLATE LC_MONETARY LC_MESSAGES -#AcceptEnv LC_PAPER LC_NAME LC_ADDRESS LC_TELEPHONE LC_MEASUREMENT -#AcceptEnv LC_IDENTIFICATION LC_ALL -|-------------------- - -In order to make the ssh-daemon start at system boot, you have to enable this by giving: -|-------------------- -# chkconfig sshd on -|-------------------- - -You can check the status with the command "chkconfig -l sshd". -The output should look like this: -|-------------------- -# sshd 0:off 1:off 2:off 3:on 4:off 5:on 6:off -|-------------------- - -Also you need to start the sshd service in order to generate the security keypair for sshd. -|-------------------- -# service sshd start -|-------------------- - -This time seems to be a good time to reboot your server: -|-------------------- -# reboot -|-------------------- -After rebooting the machine, if you wish, you may go to another machine and connect to your newly created server using a SSH (Secure Shell) client. In Windows, I like to use putty to do ssh sessions to my Linux servers. - -=== Configure Software Repositories === - -After the system has rebooted, log in as root. - -Later on, you will need to add some software packages from the openSUSE 11 Distribution. -Some of those packages are NOT available in the openSUSE 11.3 DVD (libyaz-devel is one of those packages). -However we already added these repositories to the system after configuring the network. -In case you did not have a network setup at that time, it is now time to setup these repositories, but you can skip this if this has been done already. - -First, run the yast command in the Linux command line (shell): - -|-------------------- -# yast -|-------------------- - -Inside yast, select Software -> Software Repositories - -==== "Configured Software Repositories" screen ==== - -When on this screen, you already see a table that has: - -* as configured repositories (in the "Name" column) -** "Updates for openSUSE 11.3 11.3-1.82" -** "openSUSE-11.3 11.3-1.82" -** "openSUSE-11.3-Debug" -** "openSUSE-11.3-Non-Oss" "openSUSE-11.3-Oss" ... -* at least the following repositories have an "x" in the "Enabled" column -** "Updates for openSUSE 11.3 11.3-1.82" -** "openSUSE-11.3-Oss" -* you still have to add the folowing repositiory to this list -** "openSUSE BuildService - devel:languages:perl" -Press ALT+A to Add Repositories. - -==== "Media type" screen ==== - -Select Community Repositories by pressing ALT+I and apply Next (press ALT+X). - -You will see a message that data will be downloaded. -After that you will get a list of Repositories and the above mentioned, but not yet available, will be in this list. -Select the one you need by using the Arrow Keys and press Space to select (an x will appear in front of the Repository). -After that apply OK. You may see some activity and you may get asked to import GnuPG keys, just do so. - -You may see the following screen. - -==== "License Agreement" screen ==== - -Check the "Yes, I Agree to the License Agreement" radio button. - -Click on the "Next" button to return to the "Configured Software Repositories" screen. - -==== "Configured Software Repositories" screen ==== - -You should see now the "openSUSE 11.3-Oss" listed as an entry. -You can Disable "openSUSE-11.3-Source" and its Autorefresh, if present. - -Click on the "OK" button. - -When you get sent back to the "Yast Control Center" click on the "Quit" button (to return to the shell). - -=== Install some useful / necessary programs === - -By this time, you have to install some of the programs which are regularly used, by using zypper (the command line mode packet manager): - -To install locate, ncftp (command-line ftp client), make and gcc you give the following command: -|-------------------- -# zypper install findutils-locate ncftp make gcc -|-------------------- -Zypper reports that it will install 18 packages; confirm with RETURN. - -== Download Koha == - -|-------------------- -# wget http://download.koha-community.org/koha-3.00.00.tar.gz -|-------------------- -You will receive 49,266,888 bytes. - -== Extract Koha == - -|-------------------- -# tar -xzvf koha-3.00.00.tar.gz -|-------------------- - -== Set up Locale for root user == - -If you run the locale command, you'll probably get this output: -|-------------------- -# locale -LANG=POSIX -LC_CTYPE=en_US.UTF-8 -LC_NUMERIC="POSIX" -LC_TIME="POSIX" -LC_COLLATE="POSIX" -LC_MONETARY="POSIX" -LC_MESSAGES="POSIX" -LC_PAPER="POSIX" -LC_NAME="POSIX" -LC_ADDRESS="POSIX" -LC_TELEPHONE="POSIX" -LC_MEASUREMENT="POSIX" -LC_IDENTIFICATION="POSIX" -LC_ALL= -|-------------------- - -We want to have en_US.UTF-8 in all LC_* variables. So, we'll do the following: -|-------------------- -# yast -|-------------------- -System -> Language - -The "Languages" screen should appear. - -In the first section (Primary Language Settings): - -Leave "English (US)" selected as the option for Primary Language - -Click on the "Details..." link - -Change the Locale Settings for user root from the default option ("ctype Only") to "Yes" - -Make sure the "Use UTF-8 Encoding" checkbox is checked (it should already be). - -Leave the "Detailed Locale Setting" en_US selected - -Click on the OK button to return to the "Languages" screen - -Click on the "OK" button. - -When you get back to the "Yast2 Control Center" screen, click on the "Quit" button - -== Putty configuration to use Unicode (UTF-8 encoding) == - -If you use Putty, set up Putty to use UTF-8 encoding. -To do this, click on the upper left corner of the PuTTy window, to expand the menu. -Scrol down until you find the "Change Settings..." command and click on it. - -This should open the "PuTTy Reconfiguration" screen. Here expand the "Window" category and click on "Translation" - -When you do this, you'll see that the "Received data assumed to be in which character set" dropdown list probably reads: - -"ISO-8859-1:1998 (Latin-1, West Europe) - -change it to: "UTF-8" - -Click on the "Apply" button - -Now, it's a good time to SAVE this PuTTy session. -To do this, click again on the upper left corner of the PuTTy window, to expand the menu, and click on the "Change Settings..." command like you did before. - -This should open the "PuTTy Reconfiguration" screen. Go to the right hand side of that screen and type a name in the "Saved Sessions" textbox (e.g: koha). -Then click on the "Save" button and, after doing that, click on the "Apply" button. - -IMPORTANT!!! Now it's the time to EXIT the login shell, by typing the exit command: -|-------------------- -# exit -|-------------------- - -Now you'll reopen PuTTy, but when you do that, open the Saved Session that you have created in order to use the "UTF-8" configuration you have done. - -You may not need to do the above after the change, made earlier, in /etc/ssh/sshd_config. Check it and if so you can modify this wiki page. - -After logging in again with the root user, type the locale command again. Now it should read like the following: - -|-------------------- -# locale -LANG=en_US.UTF-8 -LC_CTYPE="en_US.UTF-8" -LC_NUMERIC="en_US.UTF-8" -LC_TIME="en_US.UTF-8" -LC_COLLATE="en_US.UTF-8" -LC_MONETARY="en_US.UTF-8" -LC_MESSAGES="en_US.UTF-8" -LC_PAPER="en_US.UTF-8" -LC_NAME="en_US.UTF-8" -LC_ADDRESS="en_US.UTF-8" -LC_TELEPHONE="en_US.UTF-8" -LC_MEASUREMENT="en_US.UTF-8" -LC_IDENTIFICATION="en_US.UTF-8" -LC_ALL= -|-------------------- - -== Apache configuration (for UTF-8) == - -Create a file called /etc/apache2/httpd.conf.local with vim (or your preferred text editor): -|-------------------- -myhost:~ # vim /etc/apache2/httpd.conf.local -|-------------------- -Add this line: -|-------------------- -AddDefaultCharset UTF-8 -|-------------------- - -== Configure Apache to start at boot time and start the service == -|-------------------- -# chkconfig apache2 on - -# service apache2 start -Starting httpd2 (prefork) done -|-------------------- - -Go to a browser and type: - -http://192.168.1.16 - -You should see a page that reads: - -"It works!" - -== MySQL configuration == - -1 - Configure MySQL to start at boot time and start the service: -|-------------------- -# chkconfig mysql on - -# service mysql start -|-------------------- -The system will issue a warning that '--skip-locking' is deprecated, but for now we accept that. - -2 - Change the password for the "root" user of MySQL: -|-------------------- -# /usr/bin/mysqladmin -u root password 'chosenpassword' -|-------------------- -After starting MySQL also it is recommended to give the command: - # /usr/bin/mysqladmin -u root -h koha-server.univ.org password 'chosenpassword' -However this gives an error message. This is left for the more advanced MySQL administrator. - -3 - Check the encoding variables of MySQL - -To check the encoding variables of MySQL, will type the show variables like 'char%'; command in a mysql prompt: -|-------------------- -# mysql -p -Enter password: -Welcome to the MySQL monitor. Commands end with ; or \g. -Your MySQL connection id is 7 -Server version: 5.1.46-log SUSE MySQL RPM - -Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved. -This software comes with ABSOLUTELY NO WARRANTY. This is free software, -and you are welcome to modify and redistribute it under the GPL v2 license - -Type 'help;' or '\h' for help. Type '\c' to clear the buffer. - -mysql> show variables like 'char%'; -+--------------------------+----------------------------+ -| Variable_name | Value | -+--------------------------+----------------------------+ -| character_set_client | utf8 | -| character_set_connection | utf8 | -| character_set_database | utf8 | -| character_set_filesystem | binary | -| character_set_results | utf8 | -| character_set_server | utf8 | -| character_set_system | utf8 | -| character_sets_dir | /usr/share/mysql/charsets/ | -+--------------------------+----------------------------+ -8 rows in set (0.00 sec) - -mysql> quit -Bye -|-------------------- - -The above looks OK, so we can skip 1 and 2 and continue with 2a, but if not you can follow the following procedure. - -We want to have utf8 in the above character_set_* variables above (and NOT latin1)! - -In order to do this: - -1 - Create a backup of the MySQL configuration file (my.cnf): -|-------------------- -# cd /etc -myhost:/etc # cp my.cnf my.cnf.ORIG -|-------------------- - -2 - Use vim to add these 3 lines in the section [mysqld] of the my.cnf file: -|-------------------- -default-character-set = utf8 -character-set-server = utf8 -skip-character-set-client-handshake -|-------------------- -In openSUSE 11.3 and the provided mysql packet only the default-character-set can be set, the other 2 should not be added. - -2a - If you are unfamilar with SQL you should remove the #-character in front of safe-updates in that same section. - -3 - Restart MySQL: -|-------------------- -myhost:/etc # service mysql restart -Restarting service MySQL -Shutting down service MySQL done -Starting service MySQL done -|-------------------- - -Now, let's type again the show variables like 'char%' mysql command to see if -the character_set_variables have changed from latin1 to utf8 (character_set_filesystem -will still read "binary" but I think that's OK: -|-------------------- -myhost:/etc # mysql -p -Enter password: -Welcome to the MySQL monitor. Commands end with ; or \g. -Your MySQL connection id is 1 -Server version: 5.1.46-log SUSE MySQL RPM - -Type 'help;' or '\h' for help. Type '\c' to clear the buffer. - -mysql> show variables like 'char%'; -+--------------------------+----------------------------+ -| Variable_name | Value | -+--------------------------+----------------------------+ -| character_set_client | utf8 | -| character_set_connection | utf8 | -| character_set_database | utf8 | -| character_set_filesystem | binary | -| character_set_results | utf8 | -| character_set_server | utf8 | -| character_set_system | utf8 | -| character_sets_dir | /usr/share/mysql/charsets/ | -+--------------------------+----------------------------+ -8 rows in set (0.01 sec) - -mysql> quit -Bye -|-------------------- - -== Create the Koha database == - -=== Create the koha database and user with associated privileges === -|-------------------- -# mysqladmin -uroot create koha -p -|-------------------- -(you may name the koha database something different from koha) - -=== Grant privileges to a MySQL user to the koha database === - -Assuming that you want to have a MySQL user called "kohaadmin" to administer a database called "koha" with the password "kohapassword", you'd enter this: -|-------------------- -myhost:~ # mysql -p -Enter password: -Welcome to the MySQL monitor. Commands end with ; or \g. -Your MySQL connection id is 3 -Server version: 5.1.46-log SUSE MySQL RPM - -Type 'help;' or '\h' for help. Type '\c' to clear the buffer. - -mysql> grant all on koha.* to 'kohaadmin'@'localhost' identified by 'kohapassword'; -Query OK, 0 rows affected (0.00 sec) - -mysql> flush privileges; -Query OK, 0 rows affected (0.08 sec) - -mysql> quit -Bye -|-------------------- - -== Test your SAX Parser and correct where necessary == - - * Install the XML::SAX and XML::LibXML perl Modules: - -|-------------------- -# zypper install perl-XML-SAX perl-XML-LibXML -Loading repository data... -Reading installed packages... -'perl-XML-SAX' is already installed. -There is an update candidate for 'perl-XML-SAX', but it is from different vendor. Use 'zypper install perl-XML-SAX-0.96-13.1.x86_64' to install this candidate. -'perl-XML-LibXML' is already installed. -There is an update candidate for 'perl-XML-LibXML', but it is from different vendor. Use 'zypper install perl-XML-LibXML-1.70-6.1.x86_64' to install this candidate. -Resolving package dependencies... - -Nothing to do. -|-------------------- - -In the above you see that these two packets have been installed during system installation. -You also installed a repository for the language perl. -The message about a different vendor is about this repository. -You have to use "zypper dup" to install the newer versions from this repository, but this outside this tutorial. - -You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding bugs (in 2008) with pre-composed characters. You can test your SAX parser by running: -|-------------------- -# cd /root/koha-3.00.00/ - -myhost:~/koha-3.00.00 # misc/sax_parser_print.pl -|-------------------- - -You will probably see this: -|-------------------- -XML::SAX::PurePerl=HASH(0x8356a4c) -|-------------------- - -If you're using PurePerl (you probably are) or Expat, you'll need to edit your ParserDetails.ini file to use the LibXML Parser. -To find the ParserDetails.ini file, you may use locate. -To do this, first update the locate database by running the updatedb command: -|-------------------- -# updatedb -|-------------------- - -Then find ParserDetails.ini using locate: -|-------------------- -# locate ParserDetails.ini -/usr/lib/perl5/vendor_perl/5.12.1/XML/SAX/ParserDetails.ini -|-------------------- - -OK. So, let's first do a backup of this ini file: -|-------------------- -# cd /usr/lib/perl5/vendor_perl/5.12.1/XML/SAX/ - -myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cp ParserDetails.ini ParserDetails.ini.ORIG -|-------------------- - -Edit this ParserDetails.ini file (with vim or other editor) - -See if the first line contains this: -|-------------------- -[XML::SAX::PurePerl] -|-------------------- -If it does, replace this first line by the following: -|-------------------- -[XML::LibXML::SAX::Parser] -|-------------------- - -Run the /root/koha-3.00.00/misc/sax_parser_print.pl command again. -This time, you should get the following output: -|-------------------- -XML::LibXML::SAX::Parser=HASH(0x8356e0c) -|-------------------- - -== Install the Zebra package == - -Zebra is already in the standard repository of openSUSE 11.3, so it seems better to install it. -In the next chapter a question will be asked whether it is installed, so you better install it; no harm done. -Because you may need the documentation, that will also be installed. -Note that the package name is idzebra. - -|-------------------- -# zypper install idzebra idzebra-doc -|-------------------- -You will notice that a few dependencies need to be resolved, so a few other packages are also installed. - -== Run Koha's perl installer == -|-------------------- -myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cd /root/koha-3.00.00 -|-------------------- -After installation of a number of CPAN/perl packages we will run perl Makefile.PL to run the Koha installer. - - -=== Using zypper to install CPAN modules === - -The author of the openSUSE 11.0 version of this page did a trial run with the Makefile.PL module, which showed a lot of unstalled perl modules and other software packages. -He used the names of these packages and installed the missing ones. -I collected all the missing packets and put them in the list below to install these packages before running Makefile.PL. -Doing the way he did provides more inside in the process, however it is tedious and I want to avoid that. -You still can go [[Koha_3.0.0_on_openSUSE_11.0#Run_Koha's_perl_installer|there]] and learn from that experience. - -The commands show below need to be given one by one, because zypper will always ask for confirmation. However you can als also put more than one module name after the "zypper install" command. -|-------------------- -# zypper install perl-Algorithm-CheckDigits -# zypper install perl-Biblio-EndnoteStyle -# zypper install perl-CGI-Session-Serialize-yaml -# zypper install perl-CGI-Session -# zypper install perl-Class-Accessor -# zypper install perl-Class-Factory-Util -# zypper install perl-DBD-mysql -# zypper install perl-Data-ICal -# zypper install perl-Date-Calc -# zypper install perl-Date-ICal -# zypper install perl-Date-Manip -# zypper install perl-DublinCore-Record -# zypper install perl-Email-Date -# zypper install perl-GD -# zypper install perl-GD-Barcode -# zypper install perl-HTML-Scrubber -# zypper install perl-HTML-Template-Pro -# zypper install perl-Lingua-Stem -# zypper install perl-MARC-Charset -# zypper install perl-MARC-Crosswalk-DublinCore -# zypper install perl-MARC-File-XML -# zypper install perl-MARC-Record -# zypper install perl-MIME-Lite -# zypper install perl-Mail-Sendmail -# zypper install perl-Net-LDAP -# zypper install perl-Net-Z3950-ZOOM -# zypper install perl-PDF-API2 -# zypper install perl-PDF-Reuse -# zypper install perl-PDF-Reuse-Barcode -# zypper install perl-32bit -# zypper install perl-SMS-Send -# zypper install perl-Schedule-At -# zypper install perl-Text-CSV -# zypper install perl-Text-Iconv -# zypper install perl-XML-Dumper -# zypper install perl-XML-LibXSLT -# zypper install perl-XML-RSS -# zypper install perl-Text-CSV_XS -# zypper install perl-PerlMagick -# zypper install perl-Carp-Assert -# zypper install gd gd-devel -# zypper install xorg-x11-libXpm-devel -# zypper install libjpeg-devel -# zypper install fontconfig-devel -# zypper install libpng-devel -# zypper install libyaz-devel -|-------------------- - -== Running the Makefile.PL module to configure Koha == - -My installation is a UNIMARC installation, so I'm answering unimarc to the "MARC format for Zebra indexing (marc21, unimarc) [marc21]" question below. -If your Library uses the MARC21 format instead of UNIMARC, you should press ENTER to accept the default (which is marc21). - -Because my bibliographic catalog will have mainly records in English and Arabic, I'm answering "en" (English) to the "Primary language for Zebra indexing (en, fr) [en]" question below. - -Although I'm NOT using Zebra, I'm answering "yes" (the default choice) to the "Install the Zebra configuration files? (no, yes) [yes]" so I can set up Zebra later, if I decide to. - -Also note that Zebra has been installed in this case. - -Below is the result of running the "perl Makefile.PL" command (including my answers to the several questions): -|-------------------- -myhost:~/koha-3.00.00 # perl Makefile.PL - -By default, Koha can be installed in one of three ways: - -standard: Install files in conformance with the Filesystem - Hierarchy Standard (FHS). This is the default mode - and should be used when installing a production - Koha system. On Unix systems, root access is - needed to complete a standard installation. - -single: Install files under a single directory. This option - is useful for installing Koha without root access, e.g., - on a web host that allows CGI scripts and MySQL databases - but requires the user to keep all files under the user's - HOME directory. - -dev: Create a set of symbolic links and configuration files to - allow Koha to run directly from the source distribution. - This mode is useful for developers who want to run - Koha from a git clone. - -Installation mode (dev, single, standard) [standard] - -Please specify the directory under which most Koha files -will be installed. - -Note that if you are planning in installing more than -one instance of Koha, you may want to modify the last -component of the directory path, which will be used -as the package name in the FHS layout. - -Base installation directory [/usr/share/koha] - -Since you are using the 'standard' install -mode, you should run 'make install' as root. -However, it is recommended that a non-root -user (on Unix and Linux platforms) have -ownership of Koha's files, including the -Zebra indexes if applicable. - -Please specify a user account. This -user account does not need to exist -right now, but it needs to exist -before you run 'make install'. Please -note that for security reasons, this -user should not be the same as the user -account Apache runs under. - -User account [koha] - -Please specify the group that should own -Koha's files. As above, this group need -not exist right now, but should be created -before you run 'make install'. - -Group [koha] - -Please specify which database engine you will use -to store data in Koha. The choices are MySQL and -PostgreSQL; please note that at the moment -PostgreSQL support is highly experimental. - -DBMS to use (Pg, mysql) [mysql] - -Please specify the name or address of your -database server. Note that the database -does not have to exist at this point, it -can be created after running 'make install' -and before you try using Koha for the first time. - -Database server [localhost] - -Please specify the port used to connect to the -DMBS [3306] - -Please specify the name of the database to be -used by Koha [koha] - -Please specify the user that owns the database to be -used by Koha [kohaadmin] - -Please specify the password of the user that owns the -database to be used by Koha [katikoan] kohapassword - -Koha can use the Zebra search engine for high-performance -searching of bibliographic and authority records. If you -have installed the Zebra software and would like to use it, -please answer 'yes' to the following question. Otherwise, -Koha will default to using its internal search engine. - -Please note that if you choose *NOT* to install Zebra, -koha-conf.xml will still contain some references to Zebra -settings. Those references will be ignored by Koha. - -Install the Zebra configuration files? (no, yes) [yes] - -Unable to find the Zebra programs 'zebrasrv' and 'zebraidx' -in your PATH or in some of the usual places. If you haven't -installed Zebra yet, please do so and run Makefile.PL again. - -Since you've chosen to use Zebra with Koha, -you must specify the primary MARC format of the -records to be indexed by Zebra. - -Koha provides Zebra configuration files for MARC 21 -and UNIMARC. - -MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc - -Koha supplies Zebra configuration files tuned for -searching either English (en) or French (fr) MARC -records. - -Primary language for Zebra indexing (en, fr) [en] fr - -Koha can use one of two different indexing modes -for the MARC authorities records: - -grs1 - uses the Zebra GRS-1 filter, available - for legacy support -dom - uses the DOM XML filter; offers improved - functionality. - -Authorities indexing mode (dom, grs1) [grs1] dom - -Please specify Zebra database user [kohauser] - -Please specify the Zebra database password [zebrastripes] zebrapassword - -Since you've chosen to use Zebra, you can enable the SRU/ -Z39.50 Server if you so choose, but you must specify a -few configuration options for it. - -Please note that if you choose *NOT* to configure SRU, -koha-conf.xml will still contain some references to SRU -settings. Those references will be ignored by Koha. - -Install the SRU configuration files? (no, yes) [yes] no - -Since you've chosen to use Zebra, you can also choose to -install PazPar2, which is a metasearch tool. With PazPar2, -Koha can perform on-the-fly merging of bibliographic -records during searching, allowing for FRBRization of -the results list. - -Install the PazPar2 configuration files? [no] no - -Would you like to run the database-dependent test suite? (no, yes) [no] - -Koha will be installed with the following configuration parameters: - -AUTH_INDEX_MODE dom -DB_HOST localhost -DB_NAME koha -DB_PASS kohapassword -DB_PORT 3306 -DB_TYPE mysql -DB_USER kohaadmin -INSTALL_BASE /usr/share/koha -INSTALL_MODE standard -INSTALL_PAZPAR2 no -INSTALL_SRU no -INSTALL_ZEBRA yes -KOHA_GROUP koha -KOHA_INSTALLED_VERSION 3.00.00.096 -KOHA_USER koha -RUN_DATABASE_TESTS no -ZEBRA_LANGUAGE fr -ZEBRA_MARC_FORMAT unimarc -ZEBRA_PASS zebrapassword -ZEBRA_USER kohauser - -and in the following directories: - -DOC_DIR /usr/share/koha/doc -INTRANET_CGI_DIR /usr/share/koha/intranet/cgi-bin -INTRANET_TMPL_DIR /usr/share/koha/intranet/htdocs/intranet-tmpl -INTRANET_WWW_DIR /usr/share/koha/intranet/htdocs -KOHA_CONF_DIR /etc/koha -LOG_DIR /var/log/koha -MAN_DIR /usr/share/koha/man -MISC_DIR /usr/share/koha/misc -OPAC_CGI_DIR /usr/share/koha/opac/cgi-bin -OPAC_TMPL_DIR /usr/share/koha/opac/htdocs/opac-tmpl -OPAC_WWW_DIR /usr/share/koha/opac/htdocs -PAZPAR2_CONF_DIR /etc/koha/pazpar2 -PERL_MODULE_DIR /usr/share/koha/lib -SCRIPT_DIR /usr/share/koha/bin -SCRIPT_NONDEV_DIR /usr/share/koha/bin -ZEBRA_CONF_DIR /etc/koha/zebradb -ZEBRA_DATA_DIR /var/lib/koha/zebradb -ZEBRA_LOCK_DIR /var/lock/koha/zebradb -ZEBRA_RUN_DIR /var/run/koha/zebradb - -To change any configuration setting, please run -perl Makefile.PL again. To override one of the target -directories, you can do so on the command line like this: - -perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8 - -You can also set different default values for parameters -or override directory locations by using environment variables. - -For example: - -export DB_USER=my_koha -perl Makefile.PL - -or - -DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL - -If installing on a Win32 platform, be sure to use: -'dmake -x MAXLINELENGTH=300000' - -Checking if your kit is complete... -Looks good -Writing Makefile for koha - -myhost:~/koha-3.00.00 # -|-------------------- - -== Create the Koha User and Group == - -|-------------------- -# useradd koha - -# passwd koha -Changing password for koha. -New Password: -Reenter New Password: -Password changed. - -# groupadd koha -|-------------------- - -== Run make test == -|-------------------- -myhost:~/Koha # make test -cp koha-tmpl/opac-tmpl/prog/famfamfam/silk/error_go.png blib/OPAC_TMPL_DIR/prog/famfamfam/silk/error_go.png -cp opac/opac-changelanguage.pl blib/OPAC_CGI_DIR/opac/opac-changelanguage.pl -cp koha-tmpl/intranet-tmpl/prog/img/itemtypeimg/liblime-kids/card.gif blib/INTRANET_TMPL_DIR/prog/img/itemtypeimg/liblime-kids/card.gif -cp koha-tmpl/opac-tmpl/prog/famfamfam/mini/note.gif blib/OPAC_TMPL_DIR/prog/famfamfam/mini/note.gif - -[many more lines beginning with "cp" should appear...] - -t/Amazon.t .................. ok -t/Barcodes_PrinterConfig.t .. ok -t/Bookfund.t ................ ok -t/Bookseller.t .............. ok -t/Boolean.t ................. ok -t/Branch.t .................. ok -t/Calendar.t ................ ok -t/Charset.t ................. ok -t/Debug.t ................... # BEFORE use: $debug is not defined -# BEFORE use: $cgi_debug is not defined -t/Debug.t ................... 1/3 # AFTER use: $debug is 0 -# AFTER use: $cgi_debug is 0 -# Done. -t/Debug.t ................... ok -t/dummy.t ................... ok -t/Input.t ................... ok -t/Koha.t .................... ok -t/Languages.t ............... ok -t/Maintainance.t ............ ok -t/Output.t .................. ok -t/Record.t .................. ok -t/Review.t .................. ok -t/Scrubber.t ................ 1/10 # Note: scrubber test output will have whitespace collapsed for readability -# done. -t/Scrubber.t ................ ok -t/Stats.t ................... ok -All tests successful. -Files=19, Tests=47, 3 wallclock secs ( 0.06 usr 0.08 sys + 2.12 cusr 0.25 csys = 2.51 CPU) -Result: PASS -|-------------------- -So here it shows all is OK. I don't expect any problems to appear, otherwise you may need to read the document on installing Koha on openSUSE 11.0. - -== Run "make install" == - -Now, we will run make install: - -|-------------------- -myhost:~/Koha # make install -|-------------------- -[Several lines starting with "Manifying" and many lines starting with "Installing" will scroll by...] -|-------------------- -Installing /usr/share/koha/man/man3/serials::serial-issues.3pm -Installing /usr/share/koha/man/man3/C4::Context.3pm -Installing /usr/share/koha/man/man3/cataloguing::value_builder::unimarc_field_123f.3pm -Installing /usr/share/koha/man/man3/cataloguing::addbiblio.3pm -Installing /usr/share/koha/man/man3/cataloguing::value_builder::unimarc_field_128c.3pm -Installing /usr/share/koha/man/man3/tools::viewlog.3pm -Installing /usr/share/koha/man/man3/admin::branches.3pm - -Koha's files have now been installed. - -In order to use Koha's command-line batch jobs, -you should set the following environment variables: - -export KOHA_CONF=/etc/koha/koha-conf.xml -export PERL5LIB=/usr/share/koha/lib - -For other post-installation tasks, please consult the README. - -# cd /etc -myhost:/etc # -|-------------------- - -== Create /etc/bash.bashrc.local == -Create a file called bash.bashrc.local in the /etc directory: -|-------------------- -myhost:/etc # vim /etc/bash.bashrc.local -|-------------------- -Add these 2 lines in the file: -|-------------------- -export KOHA_CONF=/etc/koha/koha-conf.xml -export PERL5LIB=/usr/share/koha/lib -|-------------------- - -Exit the shell and log back in. -|-------------------- -myhost:/etc # exit -|-------------------- -After logging back in, type the following commands to check if -the KOHA_CONF and PERL5LIB environment variables have been correctly set: -|-------------------- -myhost:~ # env | grep KOHA -KOHA_CONF=/etc/koha/koha-conf.xml - -myhost:~ # env | grep PERL5LIB -PERL5LIB=/usr/share/koha/lib -|-------------------- - -== Koha's Web Installer == - -Access Koha's web installer at: - -http://192.168.1.16:8080/ - -Your browser will probably say that: -|-------------------- -" The server at 192.168.1.16 is taking too long to respond." -|-------------------- -OK... It seems that we have still have to do something. - -== Create a symbolic link to /etc/koha/koha-httpd.conf == - -Let's create a symbolic link to the /etc/koha/koha-httpd.conf file in the /etc/apache2/vhosts.d directory -: -|-------------------- -myhost:~ # cd /etc/apache2/vhosts.d/ - -myhost:/etc/apache2/vhosts.d # ln -s /etc/koha/koha-httpd.conf koha-httpd.conf -|-------------------- - - * Restart Apache -|-------------------- -myhost:/etc/apache2/conf.d # service apache2 restart -Syntax error on line 28 of /etc/apache2/conf.d/koha-httpd.conf: -Invalid command 'RewriteEngine', perhaps misspelled or defined by a module -not included in the server configuration -|-------------------- - -== Enable the mod_rewrite Apache module == - -OK... It seems that we need to enable the mod_rewrite Apache module: -|-------------------- -myhost:/etc/sysconfig # a2enmod rewrite -|-------------------- -If the above command seems NOT to work, for some reason, do this - edit /etc/sysconfig/apache2 and add the word "rewrite" (without the quotes) at the end of the APACHE_MODULES line, right before the right quote -|-------------------- -myhost:/etc/sysconfig # service apache2 restart -Syntax OK -Shutting down httpd2 (waiting for all children to terminate) done -Starting httpd2 (prefork) done -|-------------------- - -== Change koha-httpd.conf == - -If you browsed again to http://192.168.1.16:8080 you would still get no answer. This is because we still have to do some changes to the koha-httpd.conf file. Unless you did not follow this tutorial and port 8080 is not open. Look back in this page to find out how. - -First, let's create a backup of this file: -|-------------------- -myhost:/etc/apache2/vhosts.d # cp koha-httpd.conf koha-httpd.conf.ORIG - -myhost:/etc/koha # vim koha-httpd.conf -|-------------------- - -At the beginning of the koha-httpd.conf file, under the commented NameVirtualHost line, add the following line: -|-------------------- -Listen 8080 -|-------------------- -In that file, you should find two VirtualHost sections: one for the OPAC area of Koha and the other one for the Intranet. -If the two virtualHost directives - the lines that start with - in that file are set for the IP Address 127.0.0.2, replace them by the correct IP address of your server. - -That file will have 2 ServerName directives (one for each of the 2 VirtualHosts). -In those directives, you should have the IP of your server -or- the FQDN of your server (example: ServerName koha-server.univ.org). - -Now, restart again Apache: -|-------------------- -myhost:/etc/koha # service apache2 restart -Syntax OK -Shutting down httpd2 (waiting for all children to terminate) done -Starting httpd2 (prefork) done -|-------------------- - -Try to access the web page: - -http://192.168.1.16/ - -If you get again the "It Works!" web page, you'll probably have to Refresh/Reload the page in your browser (press the F5 key). - -After reloading the page, you should get the following error: -|-------------------- -Forbidden - -You don't have permission to access / on this server. - -Additionally, a 403 Forbidden error was encountered while trying to use an -ErrorDocument to handle the request. -Apache/2.2.4 (Linux/SUSE) Server at 192.168.1.16 Port 8080 -|-------------------- - -OK. Let's add then the following directive at the end of the koha-httpd.conf file: -|-------------------- - - Order allow,deny - Allow from all - -|-------------------- - -Restart Apache: -|-------------------- -myhost:/etc/apache2/vhosts.d # service apache2 restart -Syntax OK -Shutting down httpd2 (waiting for all children to terminate) done -Starting httpd2 (prefork) done -|-------------------- - -OK. Load again the following page in your web browser: - -http://192.168.1.16 - - -After some seconds you should be redirected to: - -http://192.168.0.2/cgi-bin/koha/maintenance.pl - -and see a Koha page with the following text: -"System Maintenance... we'll be back soon! If you have any questions, please contact the Site Administrator" - -This is actually GOOD NEWS! :) It's now time to set up Koha in the Intranet interface. - -To do that, browse to: - -http://192.168.0.2:8080 - -You should see a page with the title "Welcome to the Koha Web Installer", and with a "Username" and a "Password" textboxes. - -If not you may have forgotten to open the 8080 port. - - -You may now login with your koha administrator username and password and reply to the several questions you will be asked. - -== Add Zebra Indexer == - -Add an entry in Koha user crontab to process scheduled added/updated/deleted records -indexing by Zebra. cronjobs/crontab.example contains examples for these cron jobs (and many more). - -NOTE: The cronjobs should be setup under the kohauser (the default is 'koha', but -this is the user you set up in section 'Create the Koha User and Group'). - -Edit the crontab for the koha user by running - $ sudo -u crontab -e - -For Zebra indexing, you are looking for the example that begins with - - # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day - # for both authorities and bibs - -It may be easiest to copy/paste the example into your own crontab and modify as necessary. - -You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra diff --git a/INSTALL.ubuntu b/INSTALL.ubuntu deleted file mode 100644 index 60f5ed4..0000000 --- a/INSTALL.ubuntu +++ /dev/null @@ -1,699 +0,0 @@ -================================================================= -Instructions for Installing Koha from Source -================================================================= - -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 - -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 - -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 - -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. - -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 - - - -UPDATE UBUNTU -================================================================= - -This process, particularly the upgrade step, may take a while. - - sudo apt-get update - - sudo apt-get upgrade - - sudo apt-get clean - - -DOWNLOAD THE LATEST KOHA RELEASE -================================================================= - -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. - -IF YOU ARE DOING A STANDARD INSTALLATION: -Downloading Source Via Tarball -================================================================= - - wget http://download.koha-community.org/koha-latest.tar.gz - tar xvf koha-latest.tar.gz - ls - -NOTE: You need to cd into the Koha directory, but since the -version changes, you'll know by the ls command what it is. - -IF YOU ARE DOING A DEV INSTALLATION: -Downloading Source Via Git -================================================================= - -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 - - -INSTALL DEPENDENCIES -================================================================= - -Dependencies from Repository -================================================================= - -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 - -Check For Missing Dependencies -================================================================= - -Check everything was installed, by running the test script to -identifty missing libraries: - ./koha_perl_deps.pl -m -u - -Install any required libraries that are missing. It is a good -idea to install optional ones that are easily found as well. - - -CREATE MYSQL DATABASE AND GRANT PRIVILEGES -================================================================= - -Create MySQL Database -================================================================= - -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 - - mysql -u root -p - - CREATE DATABASE kohadata; - -The Koha database has now been created with the name kohadata. - -Create User and Grant Permissions -================================================================= - -Continue entering MySQL commands. SUBSTITUTE A PASSWORD OF YOUR -CHOICE FOR THE {PASSWORD}'S IN THE FOLLOWING COMMANDS: - - CREATE user 'koha'@'localhost' IDENTIFIED by '{PASSWORD}'; - GRANT ALL ON kohadata.* TO 'koha'@'localhost' IDENTIFIED BY '{PASSWORD}'; - FLUSH PRIVILEGES; - QUIT - -The Koha administrative user has now been created with the name -'koha' and the password of your choosing. - - -CONFIGURE KOHA -================================================================= - -User/Group Environment Variables -================================================================= - -IF YOU ARE DOING A STANDARD INSTALLATION, then create a -separate 'koha' system user: - sudo adduser koha - -There is no need to set the following environment variables, -because 'koha' is the default account to use. - -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 - -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. - - -Configure Your Koha Install -================================================================= - - perl Makefile.PL - -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. - -Answering the resulting questions requires thinking. Here are -some hints. - -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. - -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. - -Use the same username and password for the Zebra questions. - -Don't worry about warnings generated by optional components. - - -Build And Test Koha -================================================================= - -Having configured Koha, build it using the following command: - make - -Once this has successfully run, test Koha using the following -command: - make test - -Don't worry about the large number of scary warning scrolling -by. All that matters is "PASS" or "FAIL". - -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. - - -Install Koha -================================================================= - -Once the make test has successfully run, install Koha. - -IF YOU ARE DOING A STANDARD INSTALLATION, using the -following command (follow any on screen prompts): - sudo make install - -Once this has successfully run, Koha is almost installed. There -are only a few more steps left. - -IF YOU ARE DOING A DEV INSTALLATION, using the -following command (follow any on screen prompts): - make install - -No sudo is required as you have access to the directories -listed above. - -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. - - -PRE-WEB INSTALL SETUP -================================================================= - -Ubuntu MySQL Security Tweak -================================================================= - -There is a security risk in Ubuntu's MySQL default setup. Type -the following commands: - mysql -u root -p - - USE mysql; - DELETE FROM user WHERE user=''; - FLUSH PRIVILEGES; - QUIT - -The anonymous connections are now removed. - - -Configure System Wide Environment Variables -================================================================= - -Running scripts and cron jobs requires environment variables set. -Use the following commands: - sudo nano /etc/environment - -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! - -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 -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - - logout - -You need to logout and back in in order to get the environment -variables values to be recognized. - - -CONFIGURE AND START APACHE -================================================================= - -Place Koha Site File -================================================================= - -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 - -IF YOU ARE DOING A STANDARD INSTALLATION, use the following -command: - sudo ln -s /etc/koha/koha-httpd.conf \ - /etc/apache2/sites-available/koha - -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 - -/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 -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -/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 -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -Setup Default Ports -================================================================= - - sudo nano /etc/apache2/ports.conf - -/etc/apache2/ports.conf must have two lines exactly like -the following. Do not add them if they are already there. - -FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -Listen 80 -Listen 8080 -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -/etc/apache2/ports.conf does not require NameVirtualHost. -Do not add it if it is missing or already there. Just -prepend # accordingly. - -FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -#NameVirtualHost *:80 -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -Disable Default Site -================================================================= - -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 - -Enable Modules and Site -================================================================= - -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 - - -SETUP ZEBRA -================================================================= - -The Zebra process send responses to search requests sent by Koha -or Z39.50/SRU/SRW clients. - -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. - -Start Zebra Server on Boot -================================================================= - -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 - -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 - -Configuring Zebra Indexing -================================================================= - -IF YOU ARE DOING A STANDARD INSTALLATION, use this command: - sudo nano /etc/cron.d/koha - -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 -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -IF YOU ARE DOING A DEV INSTALLATION, use this command: - crontab -e - -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 -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - - -SETUP ADDITIONAL LANGUAGES -================================================================= - -To use multi-lingual sample data, please install languages -which may be useful for use in the Koha system. - -Information on this can be found: -http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client - - -WEB INSTALLATION -================================================================= - -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. - -The password will be what you set in the 'Create User and -Grant Permissions' section above. - -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. - - sudo apt-get install lynx - - lynx http://127.0.1.1:8080/ - - -SET UP YOUR LIBRARY IN KOHA -================================================================= - -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. - -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/ - - -USEFUL REFERENCE LINKS -================================================================= - -Documentation: -http://koha-community.org/documentation/ - -Additional Languages: -http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client - -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 - -Frequently Asked Questions: -http://koha-community.org/documentation/faq - -Bug Reports: -http://bugs.koha-community.org/ - -Public Z39.50/SRU server: -http://wiki.koha-community.org/wiki/Troubleshooting_Koha_as_a_Z39.50_server - -Alternate Indexing Method: -http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra - - -UPGRADING -================================================================= - -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. - -First, ensure the most recent dependencies are installed: - sudo apt-get update - sudo apt-get install koha-deps koha-perldeps - -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 . -- 2.1.4