Install Koha On Ubuntu 16

Download as docx, pdf, or txt
Download as docx, pdf, or txt
You are on page 1of 5
At a glance
Powered by AI
The key steps include installing Ubuntu 16.04, adding the Koha repository, installing Koha and its dependencies like MySQL, configuring Apache and enabling sites.

The steps outlined on pages 1 and 2 include installing Ubuntu 16.04, updating the system, installing prerequisites like a text editor, adding the Koha repository, installing Koha, configuring the MySQL server, creating a Koha instance and configuring Apache.

Configuration changes that need to be made after installing Koha include tweaking MySQL security, adding ports, changing the Koha master password and installing any missing Perl modules.

Install Koha on Ubuntu 16.

04
Install Ubuntu 16.04 and update

Koha can install on Ubuntu/Xubuntu/Kubuntu/Lubuntu. Install the operating system


first. Then update the system using following commands:
apt-get update
apt-get upgrade
Install lightweight text editor
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
Ubuntu MySQL security Tweak
Apply following command:
sudo mysql_secure_installation
[Enter the MySQL Root password]
Give the answer n (no) for the first question. Give Y (Yes) for other questions.
Adding ports
We have assigned 8080 port for 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
sudo
sudo
sudo

a2dissite 000-default
a2enmod deflate
a2ensite library
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
Koha on Ubuntu Packages
Email ThisBlogThis!Share to TwitterShare to FacebookShare to Pinterest
Labels: Ubuntu 16.04

6 comments:
1.

Dr. Parthasarathi MukhopadhyayMay 14, 2016 at 2:13 PM


Dear

Vimal

Have you really tried/tested the steps. In Ubuntu 16.04, MySQL is


producing
error
reports.
See
https://bugs.kohacommunity.org/bugzilla3/show_bug.cgi?id=16402
In
mysql

Ubuntu

16.04
-h

MySQL
localhost

details:
-V

mysql Ver 14.14 Distrib 5.7.12, for Linux (i686) using EditLine wrapper

Koha

error

during

Web

Installer

Step

3:

mysql: [Warning] Using a password on the command line interface can be


insecure. ERROR 1171 (42000) at line 1385: All parts of a PRIMARY KEY
must be NOT NULL; if you need NULL in a key, use UNIQUE instead
2.

Reply

Sonam JamtshoMay 29, 2016 at 9:14 PM


Yes.. true. I also had the same issue. Any thought on that.
The following error occurred while importing the database structure:
mysql: [Warning] Using a password on the command line interface can be
insecure. ERROR 1171 (42000) at line 1385: All parts of a PRIMARY KEY
must be NOT NULL; if you need NULL in a key, use UNIQUE instead
Reply
3.

b outsideJune 5, 2016 at 6:34 PM


Koha does not work on Ubuntu Server 16.04, it does on Ubuntu Server
14.04. Learned the hard way. b outside
4.

Reply

Samak AidenJune 20, 2016 at 9:23 PM


The installation steps works on Ubuntu 16.04 if mariadb is used.
Reply

5.

Seyoum WorknehJuly 5, 2016 at 3:52 AM


The following error occurred while importing the database structure:
[Tue Jul 5 13:36:35 2016] install.pl: DBD::mysql::st execute failed: BLOB,
TEXT, GEOMETRY or JSON column 'defaultvalue' can't have a default
value
at
/usr/share/perl5/DBIx/RunSQL.pm
line
273.
Please
contact
your
system
administrator.
I got the above error during koha installation on ubuntu 16.04 Please help
me
Reply
6.

Seyoum WorknehJuly 5, 2016 at 3:59 AM


I got the following error during installing koha on ubuntu 16.04. Please
help
me
Web
installer

Step
3
The following error occurred while importing the database structure:
[Tue Jul 5 13:36:35 2016] install.pl: DBD::mysql::st execute failed: BLOB,
TEXT, GEOMETRY or JSON column 'defaultvalue' can't have a default
value
at
/usr/share/perl5/DBIx/RunSQL.pm
line
273.
Please contact your system administrator
Reply

You might also like