04/12/2019

Install Koha Software on Ubuntu 16.04 & 18.04 LTS

By Technical Digit

Open Terminal and get ready for Install Koha Software on Ubuntu Machine.

Update Ubuntu OS using following commands

sudo su 

apt-get update

apt-get upgrade

Install Leafpad text editor

apt-get install leafpad

Add Koha community repository

echo deb http://debian.koha-community.org/koha oldstable main | sudo tee /etc/apt/sources.list.d/koha.list

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

Update the software repository

sudo apt update

Install Koha

sudo apt install koha-common

Server Configuration

In this step, need to edit network information like domain name and port numbers. 

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

Here I change the port number of Koha staff client to 8080. Find the following line in the file and make changes.
INTRAPORT=”8080″

 

Install MariaDB server

Here we use MariaDB server instead of MySQL server. Apply the following commands one by one to add MariaDB repository and install the MariaDB Server.

sudo apt-get install software-properties-common

sudo apt-key adv –recv-keys –keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8

sudo add-apt-repository ‘deb [arch=amd64,arm64,ppc64el] http://mirrors.up.pt/pub/mariadb/repo/10.4/ubuntu bionic main’

sudo apt update

sudo apt install mariadb-server

Assign Root password for MariaDB

sudo mysqladmin -u root password ‘newpass’       [Replace ‘newpass‘]

Apply the following commands to create Apache configuration files.

sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart

Create a Koha instance with the name library. 

sudo koha-create –create-db library

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

sudo leafpad /etc/apache2/ports.conf

Copy-paste following line below Listen 80

Listen 8080

Restart Apache,

sudo service apache2 restart

Enable modules and sites

sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library
sudo service apache2 restart

Locate Koha default master password:

Run Following Command:

sudo xmlstarlet sel -t -v ‘yazgfs/config/pass’ /etc/koha/sites/library/koha-conf.xml;echo

Note: Password will display in terminal, please copy and paste in login interface of koha staff client.
Restart memcached: 

sudo service memcached restart

Enable & Start Plack for Koha Performance Improvement: 

sudo koha-plack –enable library
sudo koha-plack –start  library
sudo service apache2 restart

How to start Koha
Open following links,

http://127.0.1.1:8080 (Staff Client)
http://127.0.1.1:80 (Online Catalogue-OPAC)