How to Install Koha Library Software on an Ubuntu VPS
Edit Article

  • 1 Editor

Koha library software is a forgotten concept for many readers. Many of us may want a small rewind to bring back the forgotten concepts. We are here to help you in rewinding and updating it.


Let us first discuss the basics, before we go in depth..

What is the Koha Library Software?

It is an Integrated Library System (ILS) that is in use, in thousands of Libraries around the world. It is established and has been in on the go development for over 10 years. In This article, we will learn two methods for setup of public access. You can choose any method to install koha library software.


Hope now we have refreshed you some concepts


Now, we will discuss about the Koha Library Software on Ubuntu 12.04 x32 VPS. I believe koha’s most recent versions also function in the same way. Now several questions may be running in your mind.

  1. What is the koha library software?
  2. How to install koha library software in our system?
  3. How to connect with koha library software?
  4. How contents are exported in koha library software format?

All your questions have solutions



Koha Installation on Ubuntu :

Let’s Start installation by turning up a Ubuntu 12.04 x32 VPS:-

Access your Server SSH over to your server:

ssh [email protected]{your server's ip address here}

and Login.


Add the Koha Repositories to Ubuntu Sources List


Run the following commands after login to your VPS. These commands will add Repositories to the Ubuntu Sources list:

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

These commands will add koha respitoAQ ryYO

0-H67 and key to Key to Ubuntu and it will Update the package list.

Now Install Koha Now let’s install it. Run the Following command:

apt-get install koha-common

This command will install Koha with dependencies as it requires.

Configure Koha for Web Access with an IP address

This step will show you how to configure Koha with access though an IP address. Type following commands to Access the Koha Config file:

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

Now you will see the following. If you haven’t than add this to the file:

DOMAIN=""  # Change this to be your domain which you want. Any instance will 
be a subdomain of this string.
INTRAPORT="8080"  # TCP listening port enables administration 
interface
INTRAPREFIX=""  # For administration interface URL: Prefix to be 
added to the instance name.
INTRASUFFIX="-intra"  # For administration interface URL: Suffix 
to be added to the instance name.
DEFAULTSQL=""  # This value is not needed.
OPACPORT="80"  # TCP listening port for the users' interface 
(if you skip this, default of 80 will be used)
OPACPREFIX=""  # For users' interface URL: Prefix to be added to 
the instance name.
OPACSUFFIX=""  # For users' interface URL: Suffix to be added to 
the instance name.
ZEBRA_MARC_FORMAT="marc21"  # Specifies format of MARC records 
to be indexed by Zebra. Possible values are 'marc21', 'normarc' 
and 'unimarc'
ZEBRA_LANGUAGE="en"  # Primary language for Zebra indexing. 
Possible values are 'en', 'fr' and 'nb'

Configure Koha for Web Access with a Domain

This step will show you how to configure Koha with a domain for web access. Access the Koha Config file by the following command:

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

You should see the following, if not add this to the file:

DOMAIN=".DNSname.org"  # Change this to be your domain. 
Any instance will be a sub domain of this string.
INTRAPORT="80"  # TCP listening port for the administration 
interface
INTRAPREFIX=""  # For administration interface 
URL: Prefix to be added to the instance name.
INTRASUFFIX="-intra"  # For administration interface 
URL: Suffix to be added to the instance name.
DEFAULTSQL=""  # This value is not needed.
OPACPORT="80"  # TCP listening port for the users' 
interface (if you skip this, the apache default of 80 
will be used)
OPACPREFIX=""  # For users' interface URL: Prefix to 
be added to the instance name.
OPACSUFFIX=""  # For users' interface URL: Suffix to 
be added to the instance name.
ZEBRA_MARC_FORMAT="marc21"  # Specifies format of MARC 
records to be indexed by Zebra. Possible values 
are 'marc21', 'normarc' and 'unimarc'
ZEBRA_LANGUAGE="en"  # Primary language for Zebra indexing. 
Possible values are 'en', 'fr' and 'nb'

Make the following changes if they are in blue:

DOMAIN=".yourlibrary.com"  # Change this to be your domain. 
Any instance will be a subdomain of this string.
INTRAPORT="80"  # TCP listening port for the administration 
interface
INTRAPREFIX=""  # For administration interface 
URL: Prefix to be added to the instance name.
INTRASUFFIX="-intra"  # For administration interface 
URL: Suffix to be added to the instance name.
DEFAULTSQL=""  # a value is generally not needed.
OPACPORT="80"  # TCP listening port for the users' 
interface (if you skip this, the apache default of 80 will be 
used)
OPACPREFIX=""  # For users' interface URL: Prefix to 
be added to the instance name.
OPACSUFFIX=""  # For users' interface URL: Suffix to 
be added to the instance name.
ZEBRA_MARC_FORMAT="marc21"  # Specifies format of 
MARC records to be indexed by Zebra. Possible values 
are 'marc21', 'normarc' and 'unimarc'
ZEBRA_LANGUAGE="en"  # Primary language for Zebra 
indexing. Possible values are 'en', 'fr' and 'nb'

Setup the Database and Apache

If MySQL is not installed than run the following command line:

sudo apt-get install mysql-server

The VPS will prompt twice for a password; set this to something different than the server password Now, enable mod_rewrite on apache by entering the following commands:

a2enmod rewrite
service apache2 restart

This is the time to create your Koha example, run the following commands:

koha-create --create-db [YOUR INSTANCE NAME HERE]

Secure Mysql

MySQL, Allow unidentified connections, that is a no security command. Access the MySQL server by following command:

mysql -u root -p

after it enter your MySQL root password. Then run the following commands:

USE mysql;
SELECT host,user FROM user;
DELETE FROM user WHERE user='';
SELECT host,user FROM user;
FLUSH PRIVILEGES;
QUIT


Enable the Site and Apache Mods

Access the Apache Ports.conf by following command:

nano /etc/apache2/ports.conf

Find the line that display:

#Listen 80

And then change it to:

Listen 80

Now make sure the following is uncommented:

NameVirtualHost *:80

Now issue the following commands replacing [YOUR INSTANCE] with the name you chose earlier:

sudo a2enmod deflate
sudo a2ensite [YOUR INSTANCE HERE]
sudo service apache2 restart


Configure Koha from the Web

First get your password for koha:

sudo xmlstarlet sel -t -v 'yazgfs/config/pass' 
/etc/koha/sites/[YOUR INSTANCE NAME HERE]/koha-conf.xml

The Username is koha_ [INSTANCE NAME]. Now enter following command in your browser:

[YOUR IP ADDRESS]:8080
 [YOUR INSTANCE NAME HERE]-[YOUR DOMAIN HERE] eg.koha.domain.com

Then enter the username and password which were decided earlier.


Hope all you guys have refreshed your knowledge and learned the koha installation on Ubuntu Server. I will update more info in the future. Stay connected to my page so that you update your knowledge with more topics.

Article Tools

Did this article help you?

YesNo

Become
an Author!

Write an Article