In this tutorial we will discuss how to install Koha, a library management online

software, on Ubuntu 9.04. 

Koha is the first open-source Integrated Library System (ILS) in use worldwide, its

development is steered by a growing community of libraries collaborating to achieve their

technology goals. Koha's impressive feature set continues to evolve and expand to meet the

needs of its user base.

Some of the features of Koha are Full-featured ILS, Dual Database Design, Library

Standards Compliant, Web-based Interfaces, Free / Open Source, No Vendor Lock-

in, etc.

1 Prepare System , Install Dependencies, Update System

$ sudo apt-get update

$ sudo apt-get install zip unzip

$ sudo adduser koha 

2 Install LAMP (Apache2,MySql & PHP5)

sudo apt-get install lamp-server^ 

  

3 Install the Yaz and Zebra packages

$ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc 

4 Get Koha

$ wget http://download.koha.org/koha-3.00.04_fixed.tar.gz

$ sudo tar -xvf [koha].tar.gz 

(Note: use the latest stable version)

[koha] in tutorial refer to your version of koha like --> koha-3.00.04_fixed

5 Install additional Ubuntu dependencies

$ cd [koha]

$ sudo dpkg --set-selections<install_misc/ubuntu.packages

$ sudo apt-get install dselect

$ sudo dselect 

Now start dselect 

Choose [I]nstall and accept packages to be installed (hit return)

Choose [C]onfigure, 

[R]emove and [Q]uit until dselect has completed.

6 Install Perl dependencies that aren't packaged into Ubuntu

Jaunty sources

 (You can choose the appropriate default or yes option, until you are an expert)

$ sudo cpan MARC::Crosswalk::DublinCore GD  \

  GD::Barcode::UPCE HTML::Scrubber\

  Algorithm::CheckDigits::M43_001Biblio::EndnoteStyle\

  Email::Date YAML PDF::Reuse PDF::Reuse::Barcode 

$ sudo cpan

  cpan> force install HTTP:OAI IPC::Cmd JSON XML::Writer      

XML::SAX::Writer 

7 Create the database and user with associated privileges:

 
 

$ mysqladmin -u root -p <password> create <kohadatabasename>

$ mysql -uroot -p<password>

   mysql> grant all on kohadb.* to 'root'@'localhost' identified    by

'passwd';

   mysql> flush privileges;

   mysql> quit 

  

8 Test your SAX Parser and correct where necessary

$ cd [koha]

$ misc/sax_parser_print.pl 

if it report bad then edit

 $ vi /etc/perl/XML/SAX/ParserDetails.ini

Move these two line to end of the file

[XML::LibXML::SAX::Parser]

http://xml.org/sax/features/namespaces = 1

It will ---->Looks good.

 9 Install DBD::mysql Perl module 

 #########Option 1 #########

 Install without test suite

$ sudo cpan

 cpan> force install DBD::mysql 

#########Option 2 #########
 Create test database in order to install DBD::mysql

$ mysql -u root -p <password>

mysql> grant all on test.* to 'test'@'localhost' identified by 'test';

mysql> flush privileges;

mysql> quit 

Next install DBD::mysql:

$ sudo cpan

  cpan> o conf makepl_arg

 cpan> o conf makepl_arg "--testdb=test --testuser=test --testpass=test"

 cpan> install DBD::mysql

 cpan> o conf makepl_arg ''

Finally, remove the test database:

$ mysql -u root -p <password>

  mysql> drop database test;

   mysql> exit 

10 Run the Koha installer

    $ perl Makefile.PL

    ( answer questions suitably, choose standard mode until not sure)

    $ make

    $ make test

    $ sudo make install

 

11 Configure and start Apache

    $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha

    (note that the path to koha-httpd.conf may be different depending on

your installation choices)

Add the following lines to /etc/apache2/ports.conf:

    Listen 80

    Listen 8080

If not running named virtual hosts (The default koha installation does not use

named virtual hosts.), comment out the following line:

    NameVirtualHost *:80

Run the following commands:

$ sudo a2enmod rewrite

$ sudo a2ensite koha

$ sudo apache2ctl restart

12 Configure and start Zebra

 #########Option 1 #########

run the Zebra processes from the command line: (Suitable for test sites only)

    Zebra Server:

$ sudo -u koha zebrasrv -f /etc/koha/koha-conf.xml

   (note that the path to koha-conf.xml may be different depending on your

    installation choices)

    Zebraqueue Daemon:

$ sudo -u koha misc/bin/zebraqueue_daemon.pl

#########Option 2 #########

run the Zebra processes as daemons, and add to startup process:

Note that references to $SCRIPT_DIR refer to the directory where

Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.

    Zebra Server:

    (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)

$ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-

daemon

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

$ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start

    Zebraqueue Daemon:

 $ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh  /etc/init.d/koha-

zebraqueue-daemon

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

$ sudo ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start

###############PLAY TIME########## 

 Run koha admin and install koha: 

 http://127.0.1.1:8080 {ADMIN PAGE}

http://127.0.1.1 {Client}
{Refrence: Original author: Joshua Ferraro (jmf AT liblime DOT com)

Feedback/bug reports: Koha Developer's List:

http://lists.koha.org/mailman/listinfo/koha-devel}