Installing Koha 3 Beta On Ubuntu Gutsy Gibbon (7.10)

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

• 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.

wget http://mirrors.kernel.org/ubuntu/pool/universe/o/openssl097/libssl0.9.7_0.9.7g-5ubuntu1.1_i386.deb
sudo dpkg -i libssl0.9.7_0.9.7k-3_i386.deb

• Install yaz
  • Add the following lines to /etc/apt/sources.list:

deb http://ftp.indexdata.dk/pub/debian sarge main
deb-src http://ftp.indexdata.dk/pub/debian 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:

wget http://ftp.indexdata.dk/debian/indexdata.asc
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 )

wget http://search.cpan.org/CPAN/authors/id/M/MA/MARKSTOS/CGI-Session-4.30.tar.gz
tar -xvzf CGI-Session-4.30.tar.gz
cd CGI-Session-4.30
perl Makefile.PL
make
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

• 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

CREATE DATABASE `koha` ;

• Get Koha 3 sources. We have two options:

• Option A: Download Koha via Git (optional)

git clone git://git.koha.org/pub/scm/koha.git kohaclone
cd kohaclone
git checkout -b myinstall origin

• Option B: Download Koha from http://download.koha.org

mkdir /build
cd /build
wget http://download.koha.org/koha-3.00.00.tar.gz
tar -xzvf koha-3.00.00.tar.gz
cd koha-3.00.00

• Install Koha 3

perl Makefile.PL
make
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.