How to Install Koha 20.11.05 on Ubuntu 20.10 (Groovy Gorilla)!
Koha is an open source Integrated Library System (ILS) used world wide by different libraries such as school, college, university special library etc. It was created in 1999 by Katipo Communications for the Horowhenua Library Trust in New Zealand. It was written in PERL and released under GNU General Public License V3 or later.
To install koha 20.11.05 completely in Ubuntu 20.10 Groovy Gorilla, we have to go through two processes i.e Charater User Interface installation (using terminal) and Graphical User Interface installation (using a web brower). Here the character user interface installation process discussed below.
Open Terminal by pressing Ctrl + Alt + T (Press at a time)
Step : 1 - Log in as superuser
sudo su
Enter root password
Step : 2 - Update the system
apt-get update
Step : 3 - Upgrade the system
apt-get upgrade
step : 4 - Install MySQL server
sudo apt-get install mysql-server
Step : 5 - Check MySQL version
mysql --version
Step : 6 - Log in to MySQl
mysql -u root -p
Step : 7 - Set required permission
SET GLOBAL sql_mode='';
Next exit
Exit;
Step : 8 - Update again the system
apt-get update
apt-get upgrade
Step : 9 - Install lightweight text editor
Installation process of leafpad in Ubuntu 20.10 click here
If anyone wants to use gedit text editor then all cammands below containing leafpad should be replaced with gedit.
Step : 10 - Add Koha community repository
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list
wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
Step : 11 - Install PERL dependencies
While installing koha 20.11.05 version on Ubuntu 20.10, sometimes during web installation process, Perl Module Missing error occurs. Basically shows, "Locale :: Language" is module missing. So, if this type of error occurs then we have to install required perl modules before executing koha-common. After bringing all required PERL modules we can make error free installation of Koha. Type below command in terminal-
perl -MCPAN -e 'install Bundle::KohaSupport'
Step : 12 - Install Koha
apt-get install koha-common
Step : 13 - Configure koha sites
sudo leafpad /etc/koha/koha-sites.conf
Here I change port number of Koha staff client to 8001. Find following line in the file and make changes.
INTRAPORT="8001"
OPACPORT="8000"
next save and quit.
Step : 14 - Create Apache configuration files.
sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart
Step : 15 - Create a Koha instance with the name library
sudo koha-create --create-db library
Step : 16 - Ubuntu MySQL security Tweak
sudo mysql_secure_installation
[Enter the MySQL Root password]
Give the answer n (no) for the first question. Give Y (Yes) for other questions. For detail instruction click here
Step : 17 - Adding ports
We have assigned 8001 port for Koha staff client and 8000 for OPAC.
Open following file and add new port.
sudo leafpad /etc/apache2/ports.conf
Copy paste following line below Listen 80
Listen 8001
Listen 8000
next save and close the fie.
Step : 18 - Restart Apache
sudo service apache2 restart
Step : 19 - Enable modules and sites
sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library
sudo service apache2 restart
Step : 20 - Zebra rebuild command
koha-rebuild-zebra -v -f library
Step : 21 - See the password in koha configuaration file
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/library/koha-conf.xml
Step : 22 - Change the password of koha_library database
sudo leafpad /etc/koha/sites/library/koha-conf.xml
Step : 23 - Configure MySQL for koha
sudo su
[enter the Linux Root password]
mysql -u root -p
[enter the MySQL Root password]
use mysql;
ALTER USER 'koha_library'@'localhost' IDENTIFIED WITH mysql_native_password BY 'library';
flush privileges;
quit;
Step : 24 - Restart memcached
sudo service memcached restart
Now, koha has been installed successfully
Step : 25 - Launch a web browser and put the following URL
http://127.0.1.1:8001 (Staff client)
http://127.0.1.1:8000 (Online catalogue)
Step : 26 - Web Installation
For web installtion instructions click here
Information Courtesy : https://en.wikipedia.org/wiki/Koha_(software)
No comments: