0% found this document useful (0 votes)
271 views14 pages

Koha Installation On Ubuntu

Koha is an open source integrated library system used worldwide in libraries. It was created in 1999 for a library in New Zealand and is written in Perl. The document provides step-by-step instructions for installing Koha version 22.11 on Ubuntu 22.04, including installing dependencies, configuring the database, and enabling the web interface. The instructions cover tasks such as adding the Koha repository, installing Perl modules, configuring Apache, and completing the web-based configuration.

Uploaded by

battulga Jalair
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
271 views14 pages

Koha Installation On Ubuntu

Koha is an open source integrated library system used worldwide in libraries. It was created in 1999 for a library in New Zealand and is written in Perl. The document provides step-by-step instructions for installing Koha version 22.11 on Ubuntu 22.04, including installing dependencies, configuring the database, and enabling the web interface. The instructions cover tasks such as adding the Koha repository, installing Perl modules, configuring Apache, and completing the web-based configuration.

Uploaded by

battulga Jalair
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 14

Koha is an open source Integrated Library System (ILS) used world wide by different

libraries such as school, college, university special library etc. It was created in 1999 by
Katipo Communications for the Horowhenua Library Trust in New Zealand. It was written in
PERL and released under GNU General Public License V3 or later.

The stable version 22.11 released. To install koha 22.11 completely in Ubuntu 22.04 Jammy
Jellyfish, we have to go through two processes i.e Charater User Interface installation (using
terminal) and Graphical User Interface installation (using a web brower). Here the character
user interface installation process discussed below.

Open Terminal by pressing Ctrl + Alt + T (Press at a time)

Step : 1 - Log in as superuser

sudo su

Enter root password

Step : 2 - Update the system

apt-get update

Step : 3 - Upgrade the system

apt-get upgrade

step : 4 - Install MySQL server

sudo apt-get install mysql-server

Step : 5 - Check MySQL version

mysql --version

Step : 6 - Log in to MySQl

mysql -u root -p
Step : 7 - Set required permission

SET GLOBAL sql_mode='';

Next exit

Exit;

Step : 8 - Update again the system

apt-get update
apt-get upgrade

Sudo apt-get update & apt-get upgrade

Step : 9 - Add Koha community repository

echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee


/etc/apt/sources.list.d/koha.list

wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-


key add -

Step : 10 - Update again the system

apt-get update
apt-get upgrade

Step : 11 - Install PERL dependencies

While installing koha 20.11.05 version on Ubuntu 21.04 Hirsute Hippo, sometimes during
web installation process, Perl Module Missing error occurs. Basically shows, "Locale ::
Language" is module missing. So, if this type of error occurs then we have to install
required perl modules before executing koha-common. After bringing all required PERL
modules we can make error free installation of Koha. Type below command in terminal-

perl -MCPAN -e 'install Bundle::KohaSupport'

Step : 12 - Install Koha

apt-get install koha-common

Step : 13 - Configure koha sites

sudo gedit /etc/koha/koha-sites.conf

Here I change port number of Koha staff client to 8001. Find following line in the file and
make changes.

INTRAPORT="8001"
OPACPORT="8002"

next save and quit.

Step : 14 - Create Apache configuration files.

sudo a2enmod rewrite


sudo a2enmod cgi
sudo service apache2 restart

Step : 15 - Create a Koha instance with the name library

sudo koha-create --create-db library

Step : 16 - Ubuntu MySQL security Tweak


sudo mysql_secure_installation

[Enter the MySQL Root password]

Give the answer n (no) for the first question. Give Y (Yes) for other questions. For detail
instruction click here

If Problem occurs related to password

Then apply below commands one by one in another terminal window

sudo killall -9 mysql_sucure_installation

sudo mysql

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY


'SetRootPasswordHere';

Next run the secure installation command

Step : 17 - Adding ports

We have assigned 8001 port for Koha staff client and 8002 for OPAC.
Open following file and add new port.

sudo gedit /etc/apache2/ports.conf

Copy paste following line below Listen 80

Listen 8001
Listen 8002

next save and close the fie.


Step : 18 - Restart Apache

sudo service apache2 restart

Step : 19 - Enable modules and sites

sudo a2dissite 000-default


sudo a2enmod deflate
sudo a2ensite library
sudo service apache2 restart

Step : 20 - Zebra rebuild command

koha-rebuild-zebra -v -f library

Step : 21 - See the password in koha configuaration file

sudo xmlstarlet sel -t -v 'yazgfs/config/pass'


/etc/koha/sites/library/koha-conf.xml

Step : 22 - Change the password of koha_library database

sudo gedit /etc/koha/sites/library/koha-conf.xml

Step : 23 - Configure MySQL for koha

sudo su

[enter the Linux Root password]

mysql -u root -p

[enter the MySQL Root password]

use mysql;

ALTER USER 'koha_library'@'localhost' IDENTIFIED WITH


mysql_native_password BY 'library';
flush privileges;

quit;

Step : 24 - Restart memcached

sudo service memcached restart

Now, koha has been installed successfully

Step : 25 - Launch a web browser and put the following URL

http://127.0.1.1:8001 (Staff client)


http://127.0.1.1:8002 (Online catalogue)

Step : 26 - Web Installation

For web installtion instructions click here

Information Courtesy : https://en.wikipedia.org/wiki/Koha_(software)

Koha Web Installation Guide!


When someone looking for automated library software Koha is the best choice now a day.
It is free and open source software package. After complete the installation of Koha
through terminal, it is an important job for institutions to set up web installation and
Library rules creation. Here, in this article, we are going to discuss step by step about how
to do web installation of koha. For Koha installation check here

Step - 1 : Log in through ID and Password.

Log in through administrator ID and password given at the koha-conf.xml.


Step - 2 : Choose Language.

Select desired language and click on continue to the next step.

Step - 3 : Check Perl Dependencies

It will automatically check perl dependencies. Click on continue to the next step.

Step - 4 : Database Setup


It will automatically listed previous database settings which was configured at the time of
installation.

Step - 5 : Database Connection Settings

It will automatically connect to database.


Step - 6 : Set Up Database

Step - 7 : Database Table Creation

It will create database tables


Step - 8 : Install Basic Configuaration Settings

Step - 9 : Set Up Marc Format for Record Entry


Step - 10 : Import Files

Import almost all files to the database except sample libraries and sample patrons because
we need to enter our library name and register our patrons for our library.
Step - 11 : Set up Some Koha's basic Requirements

Step - 12 : Installation Complete

Now installation complete and it will automatically redirected to the login page after 10
seconds.

You might also like