Koha 3.2 on Debian Squeeze via GIT

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

Installation of Debian 6 (Squeeze)

Notes about Server Hardware

The following instructions apply to an installation based on the 64 bit variant of Debian 6.0 (Squeeze) - in debian terminology named "amd64". The instruction might apply almost or completely to a 32 bit Debian version, in debian terminology called "i386". The 64 bit version of debian is called for historical reasons "amd64", because AMD introduced x86 based 64 bit processors beforehand INTEL. Debian "amd64" versions are designed to run both on machines with AMD's and Intel's x86-64-bit processors. Don't confuse "amd64" with "ia64". "ia64" is Debian designed for the seemingly phasing out and rarely used Intel 64 Itanium processors, running for example on Hewlett Packard servers shipped with the operating system HP-UX, marketed as very reliable servers.

At the time of this writing Debian Squeeze was not yet released and still in "Testing" status.

Debian Installation

• Install Debian from a debian amd64 "businesscard image".
• Select "Expert Install"
• Locales: There's no need for adding "additional locals", even if you plan to install Koha with other languages than english on OPAC and Staff Client. The locals defined during the debian installation apply only to the language used at the servers Shell / Terminal.
• Optional tip: If you have a server running in an inhospitable cold temperatured server room you can ssh for most parts of the installation process to the server. When the screen "Load installer components from CD" shows up, check the box for

  (X) "network-console: Continue installation remotely using ssh" 

from that list. If you do so, after you have defined the IP address for the server you'll be asked to set up a temporary ssh password, opening immediately a ssh server connection to your server, to be used only temporarily for the rest of the longest parts of the installation process. After you ssh and log in remotely to the server, the debian installer screen appears on the remote computer again. Select again "expert-install". This ssh server setup is not installed permanently to your final debian installation on the servers hard drive.

• When the screen "Software Selection" appears during the installation setup, uncheck all predefined selections and select:

  If you want to have some comfort on the shell prompt:
  (X) Standard system utilities
  If you want to install an ssh server permanently to the servers hard drive check also:
  (X) SSH Server

• Grub issues in Debian Squeeze Testing: If Grub doesn't work correctly with your hardware try to repeat the installation of Grub during the installation process several times until it doesn't show errors.

Installation of Koha 3.2 from GIT Repository

Set up Indexdata apt sources for Yaz and Zebra packages

Edit apt sources list file:

  $ sudo nano /etc/apt/sources.list

Add the following lines:

  # Index Data
  deb http://ftp.indexdata.dk/debian squeeze main
  deb-src http://ftp.indexdata.dk/debian squeeze main

The Index Data packages are signed with a key you can install as follows

  $ wget http://ftp.indexdata.dk/debian/indexdata.asc
  $ sudo apt-key add indexdata.asc

Prepare System and Install Dependencies

the following list might not be complete

  $ sudo apt-get install git-core git-email at apache2 cvs daemon libgcrypt11 libgcrypt11-dev make gcc gettext mysql-server \
  libcgi-session-perl libclass-factory-util-perl libdate-calc-perl libdate-manip-perl libdate-ical-perl libdatetime-format-mail-perl \
  libimage-magick-perl libmail-sendmail-perl liblingua-ispell-perl liblingua-stem-perl libdbd-mysql-perl idzebra-2.0 idzebra-2.0-common \
  idzebra-2.0-doc idzebra-2.0-utils libclass-factory-util-perl libdatetime-format-strptime-perl libdatetime-format-w3cdtf-perl \
  libdatetime-locale-perl libdatetime-perl liblist-moreutils-perl libdatetime-timezone-perl libdbi-perl  \
  libidzebra-2.0-dev libidzebra-2.0-mod-alvis libidzebra-2.0-mod-grs-marc libidzebra-2.0-mod-grs-regx libidzebra-2.0-mod-grs-xml \
  libidzebra-2.0-mod-text libidzebra-2.0-modules libmysqlclient15-dev libnet-ldap-perl liblist-moreutils-perl liblocale-gettext-perl \
  liblocale-po-perl  libpdf-api2-perl libmime-lite-perl libpoe-perl libtext-csv-perl libtext-charwidth-perl libtext-iconv-perl \
  libtext-wrapi18n-perl libtime-duration-perl libtime-format-perl libtimedate-perl libunix-syslog-perl libxml-dom-perl libxml-dumper-perl \
  libxml-namespacesupport-perl libxml-parser-perl libxml-perl libxml-simple-perl libxml-regexp-perl libxml-xslt-perl libxml-libxml-perl \
  libxml-libxslt-perl libxml2 libxml2-dev libxml2-utils libxslt1-dev libxslt1.1 libyaml-syck-perl libyaz4 libyaz4-dev yaz yaz-doc \
  libcgi-session-serialize-yaml-perl libdata-ical-perl libhtml-template-pro-perl libmarc-charset-perl libmarc-record-perl \
  libmarc-xml-perl libnet-z3950-zoom-perl libpdf-reuse-perl libpdf-reuse-barcode-perl libsms-send-perl libschedule-at-perl libxml-rss-perl \
  libmime-lite-perl libalgorithm-checkdigits-perl libauthen-cas-client-perl libbiblio-endnotestyle-perl libbusiness-isbn-perl \
  libdbd-sqlite2-perl libemail-date-perl libgraphics-magick-perl libhtml-scrubber-perl libhttp-oai-perl liblingua-stem-snowball-perl \
  liblocale-currency-format-perl libmarc-crosswalk-dublincore-perl libmemoize-memcached-perl libnet-server-perl libnumber-format-perl \
  libpdf-api2-simple-perl libpdf-table-perl libtext-csv-encoded-perl libuniversal-require-perl libxml-sax-writer-perl libyaml-perl \
  libidzebra-2.0 libidzebra-2.0-mod-dom libtemplate-perl 

Download Koha via Git

  $ sudo apt-get install git-core git-email
  $ git clone git://git.koha-community.org/koha.git kohaclone
  $ cd kohaclone
  $ git checkout -b myinstall origin

Selecting Version of Koha to be installed

Before that see available Koha versions on the cloned Koha

  $ git tag -l

Preparing selected Koha version to install

  $ perl Makefile.PL

follow the questionnaires

to be continued