Horizontal Navigation

Tuesday, 4 September 2018

Installation of Koha 18.05 on Ubuntu 16.04 Server

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: 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 10: 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 11: Locate Koha default master password using following command (one time use).
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.
Step 12: 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)

1 comment: