Koha on Lucid using Koha packages
From Koha Wiki
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:
- 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.
- 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.
- 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.
- 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
localeat 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
#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
/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
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
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.