Installing Koha 3 Beta On Ubuntu Gutsy Gibbon (7.10)

Also: instructions for installing on Ubuntu Feisty Fawn (7.04)

Installing Prerequisites

  • Install libexpat ( Needed For Zebra ).
apt-get install libexpat1-dev
  • Install libssl0.9.7 ( Needed For Yaz ). Gutsy has libssl0.9.8, but yaz won't install with that one. We need to download the older version and install it by hand.
sudo dpkg -i libssl0.9.7_0.9.7k-3_i386.deb
  • Install yaz
    • Add the following lines to /etc/apt/sources.list:
deb sarge main
deb-src sarge main

NOTE: If yaz version installed with sarge is too old for Net::Z3950::ZOOM then try with “etch” instead.

  • Install the public key that IndexData uses to sign their packages:
apt-key add indexdata.asc
  • Update the package index
apt-get update
  • Install yaz using apt-get
apt-get install yaz
  • Install zebra using apt-get
apt-get install idzebra
sudo apt-get install idzebra-doc
  • Install the necessary Perl modules
apt-get install gzip tar unzip make lynx wget gcc libgcrypt-dev libgdbm-dev libxml2-dev libyaz-dev
perl -MCPAN -e 'install HTML::Template::Pro'
perl -MCPAN -e 'install Lingua::Stem'
perl -MCPAN -e 'install XML::SAX'
perl -MCPAN -e 'install Class::Accessor'
perl -MCPAN -e 'install MARC::Record'
perl -MCPAN -e 'install MARC::Charset'
perl -MCPAN -e 'install MARC::File::XML'
perl -MCPAN -e 'install XML::LibXML::SAX::Parser'
perl -MCPAN -e 'install CGI::Session'
perl -MCPAN -e 'install Class::Factory::Util'
perl -MCPAN -e 'install Date::ICal'
perl -MCPAN -e 'install Date::Calc'
perl -MCPAN -e 'install Date::Manip'
perl -MCPAN -e 'install GD::Barcode::UPCE'
perl -MCPAN -e 'install List::MoreUtils'
perl -MCPAN -e 'install MARC::Crosswalk::DublinCore'
perl -MCPAN -e 'install Mail::Sendmail'
perl -MCPAN -e 'install Net::LDAP'
perl -MCPAN -e 'install Net::LDAP::Filter'
perl -MCPAN -e 'install Net::Z3950::ZOOM'
perl -MCPAN -e 'install PDF::API2'
perl -MCPAN -e 'install PDF::API2::Page'
perl -MCPAN -e 'install PDF::API2::Util'
perl -MCPAN -e 'install PDF::Reuse'
perl -MCPAN -e 'install POE'
perl -MCPAN -e 'install Schedule::At'
perl -MCPAN -e 'install Text::CSV'
perl -MCPAN -e 'install Text::CSV_XS'
perl -MCPAN -e 'install Text::Iconv'
perl -MCPAN -e 'install XML::Dumper'
perl -MCPAN -e 'install XML::LibXML'
perl -MCPAN -e 'install XML::LibXSLT'
perl -MCPAN -e 'install XML::RSS'
perl -MCPAN -e 'install XML::Simple'
perl -MCPAN -e 'install YAML::Syck'
perl -MCPAN -e 'install Data::ICal'
perl -MCPAN -e 'install PDF::Reuse::Barcode'
perl -MCPAN -e 'install Biblio::EndnoteStyle'
  • Install CGI::Session From Source ( There is a bug in Syck that requires this )
tar -xvzf CGI-Session-4.30.tar.gz
cd CGI-Session-4.30
perl Makefile.PL
make test
make install
  • Install Apache2 (of course if not already installed)
    apt-get install apache2
  • Install MySQL (of course if not already installed)
    apt-get install mysql-server

Install Koha

  • Create a user named koha and add them to a group named koha
useradd koha
passwd koha
  • Create an empty MySQL database named 'koha'
    • I used phpmyadmin to do this. After executing the code, put in your server's ip, and click the phpmyadmin folder. The login will be root and the mysql password you chose when it was installed.
apt-get install phpmyadmin
cd /var/www
ln -s /usr/share/phpmyadmin .
  • Create a mysql user named kohaadmin. Execute the following SQL statement to do so.
GRANT ALL PRIVILEGES ON * . * TO 'kohaadmin'@'localhost' IDENTIFIED BY 'some_password' WITH GRANT OPTION ;
  • Create a mysql data owned by kohaadmin named koha, be sure to be logged into MySQL as kohaadmin
  • Get Koha 3 sources. We have two options:
  • Option A: Download Koha via Git (optional)
git clone git:// kohaclone
cd kohaclone
git checkout -b myinstall origin
mkdir /build
cd /build
tar -xzvf koha-3.00.00.tar.gz
cd koha-3.00.00
  • Install Koha 3
perl Makefile.PL
make test
sudo make install
sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
sudo a2enmod rewrite
sudo a2ensite koha && /etc/init.d/apache2 reload
sudo zebrasrv -f /etc/koha/koha-conf.xml
  • Open port 8080 in Apache
    • Edit /etc/apache2/ports.conf and add the line
      Listen 8080
    • Execute the command
      apache2ctrl restart
  • Browse to http://servername:8080/ and answer the questions.
ubuntu_gutsy.txt · Last modified: 2008/12/12 16:53 by pabloab
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki