Installing Koha: Download koha and install required packages

  1. Installing Koha : Introduction
  2. Installing Koha: Create a User Account on Debian
  3. Installing Koha: Update Debian packages
  4. Installing Koha: Download koha and install required packages
  5. Installing koha: Create MySQL database
  6. Installing Koha: Configure the installer and install koha
  7. Installing Koha: Configure apache2 web server and run koha web installer
  8. Installing Koha: Configure and start Zebra

To download koha’s source code, issue the following command.

wget -c

This will download koha in a compressed (or tarball) format into your current folder.
When the download is complete, extract the compressed tarball by issuing the following command:

tar -zxvf koha-latest.tar.gz

Depending on the version of koha at the time of installing, you will have a folder with a name like koha-3.22.13 which is the version of koha at the time of this writing.

Now change into this folder with the following command:

cd koha-3.22.13

Now we need to install dependencies required for koha to run properly
To install these dependencies, run the following commands:

sudo apt-get install koha-deps koha-perldeps make

This will download and install a lot of packages (more than 500) from the internet. It might take more than 20 minutes depending on the speed of your internet and your server.

This step also includes installation of MySQL database. For that reason, you will be prompted to provide a root/administrator password for the database.

Next, you need to confirm if all koha dependencies have been installed with the following command:

perl -m -u

The file used with the arguments -u -m will print to the screen the uninstalled (-u) or missing (-m) packages. If there are any, you will have to install them as well.

You might get a result as shown below

                                          Installed         Required          Module is
Module Name                               Version           Version            Required
HTTPD::Bench::ApacheBench                 0 *               0.73                    No
MARC::Crosswalk::DublinCore               0 *               0.02                    Yes
Test::DBIx::Class                         0 *               0.42                    No

Total modules reported: 3                      * Module is missing or requires an upgrade.

As shown in the last column, the fist and last modules are not required. The installer might show an error but it is still OK if we go ahead and install them.
To install a package like HTTPD::Bench::ApacheBench, we rename the package to libhttpd-bench-apache-perl (add prefix lib and suffix -perl)
Depending on various issues, you might get more, fewer or even no more packages to be installed.

To install all the 3 packages at once, issue the command as shown below

sudo apt-get install libhttpd-bench-apachebench-perl  libmarc-crosswalk-dublincore-perl libtest-dbix-class-perl

IF the above method (using apt) does not work, you can still try using cpan. In my case, libhttpd-bench-apachebench-perl and libtest-dbix-class-perl failed using the above method.

To install them using cpan issue the following command

sudo cpan -f -i HTTPD::Bench::ApacheBenchTest::DBIx::Class

This will install (-i) by force (-f) even if the tests fail.

Still, the HTTPD::Bench::ApacheBench package fails. Since it is not a required package, you can still proceed to install koha. There are various solutions if you google this but will mot go into it now because it will not prevent us from installing koha.

Otuoma Sanya

Otuoma Sanya is a full-time systems librarian, tech enthusiast and writer. His areas of interest are data mining, institutional repositories, library automation and web development using python Django.

Leave a Reply