Koha on Lucid using Koha packages

== 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.
== 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
== Sources ==
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.
== Dependencies ==
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.
==Apache==
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.
Category:Documentation
Category:Installation
Category:Obsolete