Koha Installation in Ubuntu 16.04 Desktop/Server

Installation of Koha on Ubuntu 16.04

Koha can install on Ubuntu/Xubuntu/Kubuntu/Lubuntu. Use the following steps for the installation of Koha on Ubuntu 16.04 LTS

Step 1: Install Ubuntu 16.04 LTS
Open Terminal by: Applications -> Accessories -> Terminal

   

Step 2: Update the system (Ubuntu 16.04 LTS) using following commands:

(i)  sudo su (Enter Sudo Password)
(ii) apt-get update
(iii)apt-get upgrade

Step 3: Add Koha community repository and Add Koha software channel into Ubuntu.

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

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

(iii)apt-get update

Step 4: Install Koha

Use the following command for the installation of latest release of Koha.

sudo apt-get install koha-common

The command will start to download Koha and required packages.

On the way, the process will ask to enter mail of system. Accept the default values.

Step 5: Server configuration

Now you need to edit the network information like domain name and port numbers. Use the following command

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

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

INTRAPORT="8000"

Step 6: Install MySQL/MariaDB server
Apply following command to install MySQL server.

sudo apt-get install mariadb-server 

OR,

sudo apt-get install mysql-server (If installed this, then follow Step 9 to make it useful)

Give a new password for root user while installation.

Step 7: Koha instance creation

 
Apply following commands to create Apache configuration files.

(i)   sudo a2enmod rewrite
(ii)  sudo a2enmod cgi
(iii) sudo service apache2 restart

Step 8: Create a Koha instance with the name library.

sudo koha-create --create-db library

Step 9: Change MySQL Configuration file (*If you installed MySQL server):

Insert the following lines of code in your /etc/mysql/mysql.conf.d/mysqld.cnf in the [mysqld] section: 

(i) Use following command to open the file:

sudo gedit /etc/mysql/mysql.conf.d/mysqld.cnf

(ii) Add the following line of code in the [mysqld] section:

sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,

NO_ENGINE_SUBSTITUTION

Then save and close the file.

(iv)Restart MySQL Server by using the following command in terminal:

/etc/init.d/mysql restart

Step 10: Adding ports
I have assigned 8000 port for Koha staff client and 80 for OPAC.
Open following file and add new port.

(i) sudo gedit /etc/apache2/ports.conf

(ii) Then copy & paste following line below Listen 80

Listen 8000

(iii) Restart Apache server by using following command

sudo service apache2 restart

Step 11: Enable modules and sites by using following commands

(i)  sudo a2dissite 000-default
(ii) sudo a2enmod deflate
(iii)sudo a2ensite library
(iv) sudo service apache2 restart

Step 12: Change Koha default master password. Please follow two sub-steps.
 

Sub-step 1: First change the password of koha_library database.

(i) sudo su
          [enter the Linux Root password]

(ii) mysql -uroot -p  
           [enter the MySQL Root password]

(iii) use mysql;
(iv)  SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123');
(v) flush privileges;
(vi) quit;

Sub-step 2: Then put new password in /etc/koha/sites/library/koha-conf.xml file. To open the said file, use the command given below.

(i) sudo gedit /etc/koha/sites/library/koha-conf.xml 

(ii)  Then find the line using ctrl+f and  see by replacing default password with koha123. Please see: " <pass>koha123</pass>"

Step 13: Now start Koha by opening the following links in browser
Start the Apache server by using the following command:
sudo service apache2 restart
 
Then Open browser and use the following URL:
http://localhost:8000 (Staff client). Then complete web installer steps.
http://localhost:80 (Online Public Access Catalogue)

References:
1. https://wiki.koha-community.org/wiki/Debian
2. http://kohageek.blogspot.in/