How to Install Koha 22.11 on Ubuntu 22.04 (Jammy Jellyfsh)!

 

 

 

 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


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)