Scribd
Upload
1K views4 pages

Koha Installation On Debian

1. The document provides step-by-step instructions for installing Koha, an open source library management system, on a Debian system. It details adding necessary software repositories, installing prerequisite packages like Apache and MySQL, creating a Koha database instance, and configuring the web installer. 2. Key steps include adding the Debian and Koha software repositories, installing Koha and its dependencies, disabling the default Apache virtual host, creating a Koha database instance, and configuring credentials for the web installer. 3. Providing concise yet comprehensive installation instructions, the document outlines the complete process for setting up Koha on Debian in an accessible manner for users without technical backgrounds.

Uploaded by

Rtn M J Abdin
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
1K views4 pages

Koha Installation On Debian

1. The document provides step-by-step instructions for installing Koha, an open source library management system, on a Debian system. It details adding necessary software repositories, installing prerequisite packages like Apache and MySQL, creating a Koha database instance, and configuring the web installer. 2. Key steps include adding the Debian and Koha software repositories, installing Koha and its dependencies, disabling the default Apache virtual host, creating a Koha database instance, and configuring credentials for the web installer. 3. Providing concise yet comprehensive installation instructions, the document outlines the complete process for setting up Koha on Debian in an accessible manner for users without technical backgrounds.

Uploaded by

Rtn M J Abdin
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
You are on page 1/ 4

Koha Installation on Debian

Steps to be followed:
1. Add debian packages repository
2. Add koha debian repository
3. Install koha
4. Disable the default virtual host (Strongly recommended)
5. Web installer
Before the start: Start the root terminal. To start root terminal
Go to applications
Select root terminal
Give the root password
Enter into the root terminal
Add the koha repository (Choose the stable release repository)
Koha needed some packages to work correctly. We are going to install koha automatically with
required packages. This is suitable for the end users. As we are not from technical education
background, simple installation is the best solution for us.

Step-1: Add debian packages repository/Network Mirror:


Debian repository is needed to download required dependency packages for koha. E.g. Mysql
database, apache2 server, perl packages etc.

Edit the file: (/etc/apt/sources.list)


gedit /etc/apt/sources.list

Put # on dev cdrom lines.


Add the following lines in the bottom of the file.
deb http://ftp.au.debian.org/debian stable main contrib
deb-src http://ftp.au.debian.org/debian stable main contrib
Click save and close the window.
Run the update command:
apt-get update

Step-2: add koha package repository:

Edit the file: (/etc/apt/sources.list)


gedit /etc/apt/sources.list

Add the following lines in the bottom of the file:


deb http://debian.koha-community.org/koha squeeze main

Click save and close the window.


Run the command:
wget http://debian.koha-community.org/koha/gpg.asc
apt-key add gpg.asc

apt-get update

Now our system is ready to fire.

Step-3: Install koha:


To install the koha with all prerequisite, follow the instruction below:
Run the command:
apt-get install koha-common

To configure your server for use with DNS names: After install, edit /etc/koha/kohasites.conf with details about your site. You may need to create this file.
If you don't need DNS configuration and want to access Koha via IP only
(often done for test installations), you can skip creating this file and you
will get default values (OPAC on port 80 and Staff client on port 8080).
Some example content would be:
DOMAIN=".mydomain.co.nz" # Any library 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="/usr/share/koha/defaults.sql.gz" # only needed if you're pre-populating from another
Koha database
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'

Next, you will need to enable the Apache mod_rewrite module:


sudo a2enmod rewrite
service apache2 restart

If you are planning to run MySQL on the same server as you are running Koha
on, then make sure you install it:
sudo apt-get install mysql-server
[Define root password(diul123)]

Creating the Koha Instance


Now you need to create your first koha instance. Replace instancename with the
name of your library. If you want to have library.example.com, then instancename can
probably be "library".
sudo koha-create --create-db instancename
(sudo koha-create --create-db diul )[For our purpose]

[Installs database and other dependencies automatically]


Requirement-1: Install apache2 and related packages such as: apache2
server with required add-ons.
Requirement-2: Install mysql server and other related packages such as:
mysql-server, mysqlclient with required add-ons.
o Give the mysql password when prompt.
Requirement-3: Install yaz packages such as: yaz, yaz-doc,with required
add-ons.
Requirement-4: Install zebra packages such as: idzebra with required addons.
Requirement-5: Install all required perl packages.

Step-4: Disable the default site from apache server:


By default apache2 uses 80 port for localhost. If you dont disable koha OPAC interface
wont be visible generally. You can set other port by changing the apache file, but it is
difficult for end users. So it is safest to disable the default-000 site. By running following
command.
a2dissite 000-default
service apache2 reload

Step-5: Web installer:


Username: koha_diul (koha_instancename)
Password:
The username to log in with will be koha_instancename and the password will be near
the end of /etc/koha/sites/instancename/koha-conf.xml. You will need to be root to view
this You could also use this command:
xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/instancename/koha-conf.xml

to print password out.


Or run the command
gedit /etc/koha/sites/instancename/koha-conf.xml

And find the line near bottom . Database name and password. Preserve it. It will be
needed to koha web installer

You might also like