=============================

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 <URL found on download.koha-community.org>

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<password> create <kohadatabasename>

    $ mysql -uroot -p<password>

    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 <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';

    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://<servername>:8080/

Note: <servername> 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 <kohauser> 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

    <kohauser> 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 <kohauser> 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 <script_dir> 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 <script_dir>/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon

    (Note: <script_dir> is /usr/share/koha/bin/ by default in a standard install)

    $ sudo update-rc.d koha-zebra-daemon defaults

    $ sudo <script_dir>/koha-zebra-ctl.sh start

    (Note: <script_dir> 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. <script_dir>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 <kohauser> 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 <listen> 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<kohauser> -p<kohapassword>

   > drop database koha;

   # Zebra Indexes

   $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init

   $ zebraidx -c <prefix>/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

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 </usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql;

Explanation:

mysql è launches client mysql

-- user = kohaadmin è behalf of the user base

-- password = kohakoha è password for this user

koha è the name of the database

<È means setting the result of a script (here, the base koha)

/usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql è address sql script to execute

Do not forget the sign at the end of the investigation.

To check if the base is well rebuilt: mysql-u-p kohaadmin

Enter password: kohakoha

******************************************************************

Screenshot

Welcome to the MySQL monitor. Commands end with; or \g.

Your MySQL connection id is 51

Server version: 5.0.45 Source distribution

Type 'help,' or '\h' for help. Type '\c' to clear the buffer.

MySQL> 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

= 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 <Alt>+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):