| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

kohaonubuntu

Page history last edited by Vimal Kumar 13 years, 4 months ago

koha-3.00.06 Installation on Ubuntu 9.10 (Karmic) and 10.04 (Lucid).

 

Become super user by executing the following command.

sudo su

Update your system,

sudo apt-get update  
 
Creating Koha system user
 
Open a Command Terminal and type following commands,
 
groupadd koha
useradd -g koha koha

 

sudo mkdir /build

sudo chmod -R 777 /build



Download Koha-3.00.06 package from www.koha-community.org
Extract the package by right click and select "Extract to".
 
Copy Koha package to the folder /build

mv koha-3.00.06 /build


Installation of dependencies

sudo apt-get install zip unzip lamp-server^ yaz idzebra-2.0 dselect  

cd /build/koha-3.00.06
sudo dpkg --set-selections <install_misc/ubuntu.packages
 sudo dselect

Installation of Perl dependencies

apt-get install libmarc-crosswalk-dublincore-perl libhtml-scrubber-perl libalgorithm-checkdigits-perl libbiblio-endnotestyle-perl
apt-get install libemail-date-perl libyaml-perl libjson-any-perl libxml-writer-perl libxml-sax-writer-perl

We have to install certain dependecies using CPAN,

sudo cpan

Accept all default settings.

Enter the following command in the CPAN prompt,

install HTTP:OAI IPC::Cmd Text::CSV::Encoded

quit


 
Configuration of  UTF-8 in MySQL and Apache
Enable UTF-8 at MySQL
Open a Terminal and type following command,
 
sudo gedit /etc/mysql/my.cnf
[Under the Basic settings section, add the following,]
 
# UTF-8 Defaults for Koha
init-connect='SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_general_ci

Save the file and close the editor.
UTF-8 encoding in Apache
Open a terminal and type the following command,
 
gedit  /etc/apache2/conf.d/charset
[Add the following two lines in]
 
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

Save the file and close the editor.

 

Enter following command to set locale on Ubuntu

 

sudo update-locale LANG=en_IN.UTF-8

 

Creation of MySQL Database for KOHA
Open a terminal and login as root and enter following commands,
 
mysql -u root -p
[enter mysql root password here]
 
Then type,
 
create database koha;
grant all privileges on koha.* to 'kohaadmin'@'localhost' identified by 'katikoan';
flush privileges;
quit;

 

Test to make sure the SAX Parser is setup correctly

cd koha-3.00.06

sudo gedit /etc/perl/XML/SAX/ParserDetails.ini

Move these two lines to the end of the file:

[XML::LibXML::SAX::Parser]
http://xml.org/sax/features/namespaces=1
Run the command again,

misc/sax_parser_print.pl


Setting environment variables
 
gedit /etc/bash.bashrc.local
Add the following lines there,
 
export KOHA_CONF=/etc/koha/koha-conf.xml
export PERL5LIB=/usr/share/koha/lib
 
Save and close the file.

Koha Installation


Now KOHA can be installed by following commands:
Enter into Koha folder
 
cd /build/koha-3.00.06
perl Makefile.PL

Answer all questions  without any change. Default values are accepted for us.
 
Type the following commands,
 
make
make test
sudo make install
 
Add the following lines to /etc/apache2/ports.conf, just below the following line Listen 80
Open a Command Terminal and type following commands

 
sudo gedit /etc/apache2/ports.conf
 
Listen 8000
Listen 8001
 
save the file and close.
 
Open a terminal and login as root
sudo su
ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
sudo a2enmod rewrite
sudo a2ensite koha
/etc/init.d/apache2 restart
 
 
Zebra configuration
Open a terminal and login as root

sudo ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
sudo update-rc.d koha-zebra-daemon defaults
sudo ln -s /usr/share/koha/bin/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
sudo update-rc.d koha-zebraqueue-daemon defaults

 

Edit the following files,

 

sudo gedit /usr/share/koha/bin/koha-zebra-ctl.sh

sudo gedit /usr/share/koha/bin/koha-zebraqueue-ctl.sh

 

Change USER and GROUP to root. Result is,

#!/bin/bash
USER=root
GROUP=root

 

Set following folders ownership to Koha user

 

sudo chmod -R 777 /var/lock/koha
sudo chown -R koha:koha /var/lock/koha
sudo chmod -R 777 /var/lib/koha/
sudo chown -R koha:koha /var/lib/koha

Cronjob Settings

sudo su
cd /usr/share/koha/bin/cronjobs
crontab -u root crontab.example
crontab -u username crontab.example  [Username denotes name of your home user]
crontab -e
 
Change the locations in following lines ,
 
#Environment
PERL5LIB=/usr/share/koha/lib
KOHA_CONF=/etc/koha/koha-conf.xml
 
#Some additional variables
KOHA_CRON_PATH=/usr/share/koha/bin/cronjobs
 
Save the file by pressing ctrl+o buttons
Press enter
Quit the editor by pressing ctrl+X buttons

Some settings for Apaache,

sudo gedit /etc/koha/koha-httpd.conf

Find the following line,

## OPAC
<VirtualHost 127.0.1.1:80>

Change the port number

## OPAC
<VirtualHost *:8001>

Find this line too,

## Intranet
<VirtualHost 127.0.1.1:8080>

Change to

## Intranet
<VirtualHost 127.0.0.1:8000>

Add the following line at the end of the file,

ServerName localhost

Restart the Apaches server,

sudo /etc/init.d/apache2 restart

Run the Web installer  
 
http://127.0.0.1:8000
 
URL of OPAC is http://127.0.0.1:8001
 

Zebra Management
 
Starting Zebra Server
 
Open a terminal and type following commands,
 
sudo su
sudo /etc/init.d/koha-zebra-daemon start
sudo /etc/init.d/koha-zebraqueue-daemon start
 
Rebuilding Zebra Index
sudo KOHA_CONF=/etc/koha/koha-conf.xml PERL5LIB=/usr/share/koha/lib /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -r -v

Quick Indexing
sudo KOHA_CONF=/etc/koha/koha-conf.xml PERL5LIB=/usr/share/koha/lib /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -w

 

Reference

http://wiki.koha-community.org/wiki/Koha_on_Ubuntu

http://everydaytechy.blogspot.com/2010/05/install-koha-30000-on-ubuntu-910.html

 

Send your feed back to vimal0212 at gmail.com

Comments (0)

You don't have permission to comment on this page.