Install Koha on Ubuntu 16.04

Install Ubuntu 16.04 and update
Koha can install on various Ubuntu flavors like Ubuntu MATE/Xubuntu/Lubuntu. Xubuntu and Lubuntu are lightweight (fast performance) Ubuntu flavors. Download Linux iso file from the Ubuntu MATE/Xubuntu/Lubuntu websites. Burn in a DVD or pen drive. Install the Linux operating system. 

Open Terminal and get ready for installation
Open Applications > System Tools > Terminal and execute commands one by one mentioned in this page.

Update Ubuntu
This process will update the Linux operating system latest by downloading new packages.

sudo su
apt-get update
apt-get upgrade

Install Leafpad text editor
Leafpad is a lightweight text editor, which require to open configuration files while the installation process of Koha.

apt-get install leafpad

Add Koha community repository
Add Koha software channel into Ubuntu.

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


apt-get update

Install Koha
Following command will install latest release of Koha.

apt-get 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 port number of Koha staff client to 8080. Find following line in the file and make changes.

INTRAPORT="8080"


Install MySQL server
Apply following command to install MySQL server.

sudo apt-get install mysql-server

Give a new password for root user while installation.

Koha instance creation
Apply 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

Solve MySQL 5.7 compatibility problem

Open following file,

leafpad /etc/mysql/mysql.conf.d/mysqld.cnf

Find the section [mysqld] , add following line below [mysqld]

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

Save the changes and close the file.

Restart MySQL,

sudo /etc/init.d/mysql restart


Add new port
We have assigned 8080 port for the Koha staff client and 80 for OPAC.
Open following file and add 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


Change Koha default master password
See the following link
http://kohageek.blogspot.in/2013/05/how-to-change-master-password-of-koha.html


Install missing PERL modules
After install need to install some PERL PERL modules using CPAN.

Koha > About Koha > Perl Modules

Find missing PERL modules in different colors.

Open a terminal and apply following command to enable CPAN.

sudo su
cpan

To install a particular PERL module, e.g.

install Test::DBix::Class

How to start Koha
Open following links,

http://127.0.1.1:8080 (Stff client)
http://127.0.1.1:80 (Online catalogue)


Reference
https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages

No comments:

Post a Comment