Koha on Lucid using Koha packages

From Koha Wiki
Jump to navigation Jump to search

WARNING! This page is obsolete.
This page is no longer correct and exists for historical reasons only.

Introduction and Caveats

Though this may help get you closer to installing Koha Packages, Lucid is not currently supported. There are more current instructions which work with Precise.

This document is my attempt to create a test install of the Koha Community's .deb packages on Lucid. Further information here: Debian

The following caveats apply:

  1. I'm not a librarian, a developer or a sysadmin either (other than keeping the household computers running). Thus, I could have got this all wrong.
  2. This is a proof of concept on a basic install for a single instance of Koha, with mandatory data only. Beyond that is your own look out.
  3. This proof of concept, was from a fresh install in a VM. Complete success was considered to be a completed web installation process for koha.

Preparatory steps

  • Install Lucid. I've used the Desktop variant from the Live CD.
  • Get the network happening. If it doesn't happen, fixing this is way outside the scope of this document. Good luck.
  • In theory the locale should already be UTF-8. If in doubt type locale at your prompt.
  • Check for updates:
sudo apt-get update; sudo apt-get upgrade 

Equally aptitude or the synaptic package manager could be used. I'm not going to use any of Ubuntu's GUI-for-everthing tools in this example.

  • Create koha user:
sudo adduser koha


Add the following to /etc/apt/sources.list.d/koha.list

#Index Data (Zebra) sources
deb http://ftp.indexdata.dk/ubuntu lucid main
deb-src http://ftp.indexdata.dk/ubuntu lucid main

#Koha .deb packages (Koha-community)
deb http://debian.koha-community.org/koha squeeze-dev main

Check the /etc/apt/sources.list file too and make sure that the universe repositories are available (uncommented).

Add the security keys for these repositories. These keys should just work. If they don't it's outside my experience to fix them. However, make sure that you've recently used sudo before you run Koha Community Key. Otherwise, the apt-key will get piped in as your password and sudo gets a bit confused.

wget -O- http://ftp.indexdata.dk/debian/indexdata.asc | sudo apt-key add -
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add - 

After this you'll need to run sudo apt-get update again to include these.


Ubuntu has all the packages needed but, although they're all in the pool, some do not have candidate numbers; so none of the package tools will touch them and they need to be installed manually. Also note:

  • Where I've fetched, I've used my local(-ish) server, but any Ubuntu mirror should work.
  • All the wgeting is done at once, but the packages must be installed in this order or dependencies break.
  • There are some packages that are retrieved through apt-get. This helps keep as many packages as possible under automated control.
sudo apt-get install libpdf-api2-perl libtext-csv-perl libcache-memcached-perl
sudo apt-get install libclass-singleton-perl libparams-validate-perl
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libh/libhttp-oai-perl/libhttp-oai-perl_3.23-1_all.deb
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libl/liblocale-currency-format-perl/liblocale-currency-format-perl_1.28-1_all.deb
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libm/libmemoize-memcached-perl/libmemoize-memcached-perl_0.03-1_all.deb
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libp/libpdf-api2-simple-perl/libpdf-api2-simple-perl_1.1.4u-1_all.deb
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libt/libtext-csv-encoded-perl/libtext-csv-encoded-perl_0.10-1_all.deb
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libm/libmodern-perl-perl/libmodern-perl-perl_1.03-3_all.deb
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libc/libclass-load-perl/libclass-load-perl_0.06-1_all.deb
wget http://au.archive.ubuntu.com/ubuntu/pool/universe/libd/libdatetime-timezone-perl/libdatetime-timezone-perl_1.35-1+2011h_all.deb
sudo dpkg -i libhttp-oai-perl_3.23-1_all.deb liblocale-currency-format-perl_1.28-1_all.deb
sudo dpkg -i libmemoize-memcached-perl_0.03-1_all.deb libpdf-api2-simple-perl_1.1.4u-1_all.deb
sudo dpkg -i libtext-csv-encoded-perl_0.10-1_all.deb
sudo dpkg -i libmodern-perl-perl_1.03-3_all.deb
sudo dpkg -i libclass-load-perl_0.06-1_all.deb
sudo dpkg -i libdatetime-timezone-perl_1.35-1+2011h_all.deb

Installing Koha

Now install the koha packages.

sudo apt-get install koha-common

Debconf will have things to say on the way through. When it asks about the database password, it means the MySQL root password.


At this point the database is organised, but apache isn't and you need to do the following:

  • Add the rewrite module:
sudo a2enmod rewrite
  • Either fix the virtual host statements to fit your setup, or cross your fingers and do this:
sudo a2dissite default
  • Restart Apache:
sudo /etc/init.d/apache2 restart

If you point your browser at http://yourhostname:8080 then it should get into the web-browser set up. After you go though the web-browser install process it should be a working Koha install.

If in this process you elected to use zebra, then you will also want to run the following:

sudo chown -R koha:koha /var/log/koha

Have fun.

Fixing zebra problems

After installation, it might be necessary to chown /etc/koha/koha-conf.xml to koha:www-data, and all files in /var/lock/koha/zebradb/biblios to koha:koha. Otherwise, zebra indexing might fail.


WARNING! This page is obsolete.
This page is no longer correct and exists for historical reasons only.