How to install Koha – A Library Software on Ubuntu

Step 1:
Execute the script by giving the following command:

#!/bin/bash

#export HTTP_PROXY_HOST=10.3.100.207
#export HTTP_PROXY_PORT=8080

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add –
echo deb http://debian.koha-community.org/koha stable main | sudo tee /etc/apt/sources.list.d/koha.list

sudo apt-get update
sudo apt-get install libgd-perl
sudo apt-get upgrade
sudo apt-get install koha-common

Koha installation gives error related with apache2-mpm-itk issue.
The initial configuration makes necessary enable / disable of the modules and does the initial configurations.

Step 2:
Execute the script by giving the following command:
############### Initial Configuration ####################

sudo a2dismod mpm_event
sudo a2enmod mpm_prefork
sudo service apache2 restart
sudo apt-get install -f

Step 3:
Koha Server configuration
In this step, we need to edit network information like domain name and port numbers.

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

Here we have to change port number of Koha staff client to 8080.
Find following line in the file and make changes.

INTRAPORT=”8080″

Step 4:
Adding ports

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

sudo gedit /etc/apache2/ports.conf

Copy paste following line below Listen 80

Listen 8080

Restart Apache,

sudo service apache2 restart

Step 5:
Apache module enable is done her executing the script

sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart

Step 6:
Install MySQL server and create the koha database. Here we have named the database as Koha2018.
Keep the default settings for MySQL server and when it asks for password give it as Koha2018. When the process asks to change the root password press ‘n’ then keep on pressing ‘enter’ for default values.

sudo apt-get install mysql-server
sudo koha-create –create-db Koha2018
sudo mysql_secure_installation

Step 7:
Most of the versions of Koha (3.x, 16.05 to 17.11) are not compatible with this default MYSQL configuration.
To bypasss the problem you can edit the configuration file (certainly /etc/mysql/my.cnf or /etc/mysql/mysql.conf.d/mysqld.cnf) and force the SQL modes Koha supports:

[mysqld]
sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION

After save the changes and restart mysql.

Step 8:
Finally enable the koha site by executing the script
sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite Koha2018
sudo service apache2 restart

Step 9:
KOHA Web Installation URL – Open the Koha staff using the link:
http://localhost:8080
This will show the login user name and the pass word

For credentials execute the script:

echo “Admin user name : koha_osslm”;
sudo xmlstarlet sel -t -v ‘yazgfs/config/pass’ /etc/koha/sites/Koha2018/koha-conf.xml
echo ” “;

Enjoy:
Browse to http://localhost:8080 – for admin login
Browse to http://localhost:80 – for OPAC login