edin.no-ip.com

From Koha.org:

Koha is a full-featured open-source ILS. Developed initially in New Zealand by Katipo Communications Ltd and first deployed in January of 2000 for Horowhenua Library Trust, it is currently maintained by a team of software providers and library technology staff from around the globe.

This HOWTO will guide you though Koha 3.0.x installation on Debian Lenny + Squeeze mixed environment (Why in Debian mixed but not stable only? Well... This is my normal procedure with 3rd party tarball package...)

Install Debian Lenny

What does "Debian Lenny + Squeeze mixed" means? This means the Debian will install with Lenny (stable), plus Squeeze/sid APT source (testing/unstable), where "pin" and install targeted packages as testing only. I love this model more than normal installation. This is my style and you may not follow.

So first of all, install your Debian with Lenny netinst/CD/DVD. We will define hostname as koha.example.com within this HOWTO:

Setup root password as katikoan (This is the default admin password of koha installation, so we reuse it in here):

Create a normal user named as koha with password koha (optional). This will be used as daemon user for koha:

We only need Standard system for koha installation. Any other else are optional:

Now just complete the rest of Debian installation as usual. Reboot it and go to next step.

Post-configuration after first reboot

Let's install some useful packages before any else:

Check and edit your system hostname from /etc/hostname as below:

Check and edit your hosts file /etc/hosts with below information:

Completely update your Debian installation as up-to-date (if you have define some network APT sources):

Reboot and check if everything looks good.

Add Squeeze and other APT sources

Edit and update your /etc/apt/sources.list as below (The source from Index Data are required for Yaz and Zebra):

Create and edit /etc/apt/preferences as below, which "pin" your Debian on stable:

Don't forget to download keys from Index Data:

Run the update once again and check if any missing:

Install required libraries and packages

I am a bit lazy and so summarize all required packages into debian-squeeze.packages.txt. It is mainly coming from official install_misc/debian-lenny.packages and suggestion from Installing Koha 3 On Ubuntu Hardy Heron (8.04, LTS), with fine tune and update for Debian Squeeze. Download debian-squeeze.packages.txt and run the following commands:

Resolve any else conflict within aptitude (most likely accept ALL required upgrade for broken packages) and install all of them.

Now, something are still missing and we will need to install from CPAN manually (that why I would like to install with Lenny + Squeeze mixed: most packages are already included, unlink that of standard Lenny or Ubuntu 8.04):

NOTE: Once you run perl Makefile.PL during installation (which will mention later), it may report that some libraries or packages are still missing. Come back to this section and complete the missing.

Prepare MySQL locale and database

During package installation MySQL will ask for admin password. Whatever you answered let's update it as katikoan for simpler management:

Next, edit /etc/mysql/my.cnf, add and modify your setup as below:

Restart MySQL in order to make it active:

Create database and user for Koha:

Install Koha

Download the lastest stable from http://download.koha.org/ (don't trust http://koha.org/download, information is outdated...), e.g. koha-3.00.04.tar.gz at this moment:

Now process the Makefile.pl. It will ask you a lot of question, BUT, JUST KEEP ON PRESSING ENTER AND ACCEPT ALL DEFAULT VALUE (that why we setup all user's password as katikoan as simplified). You may only hope to change them if you understand it:

Well, if nothing missing, we may now compile Koha:

NOTE: You may receive some errors during the make test complaining about an “Illegal Date” … they can safely be ignored.

Install it if looks fine:

Configure and start Apache

Copy VirtualHost setup for Koha (NOTE: You may update it as <VirtualHost *:80> and <VirtualHost *:8080> if you still see the usual Apache default site; also run a2dissite default if required)

Add the following lines to /etc/apache2/ports.conf:

Complete the rest of tasks:

Configure and start Zebra

Here we will run Zebra as daemons, and add to startup process:

Run the web installer

Nothing special, just browse your site with http://localhost:8080/ and follow the rest of installation.

Once web installer complete, you may log into Koha admin interface with username kohaadmin with password katikoan

For OPAC interface you can now access with http://localhost/

What's next?

In order to find items using the Zebra interface, you will have to schedule indexing. If you bulk imported bibliographic records, you will want to run a “Fast Index” first. This is done by entering the following command:

You should also refer to INSTALL.debian-lenny and figure out any missing procedure after "Step 6. Run the Web Installer, populate the database, initial configuration of settings"

Attachment	Size
debian-squeeze.packages.txt	5.02 KB