Koha installation on Ubuntu 12.04

Install Ubuntu /Xubuntu 12.04 LTS. See the below link to get detailed installation instructions.
 http://www.ubuntu.com/download/desktop/install-ubuntu-desktop

Open Applications > Accessories > Terminal and  apply following commands,
  
sudo su
apt-get install leafpad
  
Add Koha package repository

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
echo deb http://debian.koha-community.org/koha oldstable main | sudo tee /etc/apt/sources.list.d/koha.list

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Initial Configuration
Create a new file

leafpad /etc/koha/koha-sites.conf

Add the following lines and save.

DOMAIN=".myDNSname.org"  # Change this to be your domain.
INTRAPORT="8080"  # TCP listening port for the administration interface
INTRAPREFIX=""
INTRASUFFIX="-intra"
DEFAULTSQL=""
OPACPORT="80"  # TCP listening port for the users' interface
OPACPREFIX=""
OPACSUFFIX=""
ZEBRA_MARC_FORMAT="marc21"  # Possible values are 'marc21', 'normarc' and 'unimarc'
ZEBRA_LANGUAGE="en"  # Possible values are 'en', 'fr' and 'nb'

Adding ports
Open following file and add ports

sudo leafpad /etc/apache2/ports.conf

Copy paste following line below Listen 80

Listen 8080
 
Restart Apache,

sudo service apache2 restart

Configuration of UTF-8 in MySQL and Apache
Enable UTF-8 at MySQL 
Open a Terminal and type following command, 

sudo su 
leafpad /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  

leafpad /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.

Sax parser setup

leafpad /etc/perl/XML/SAX/ParserDetails.ini

Cut and paste the following command to the bottom of the file and save it.

[XML::LibXML::SAX::Parser]
http://xml.org/sax/features/namespaces=1 


Instance creation

sudo apt-get install mysql-server

[Put a password for MySQL Root USER]

Apply following commands,
 
sudo apt-get clean
sudo a2enmod rewrite
sudo service apache2 restart
sudo koha-create --create-db library


Ubuntu MySQL security Tweak

sudo su
mysql -u root -p

[Enter the MySQL Root password when it ask]
Execute the following commands,

USE mysql;
DELETE FROM user WHERE user='';
FLUSH PRIVILEGES;
QUIT


Configuring Apache
Execute the following commands in a terminal. 

sudo a2dissite 000-default
sudo a2enmod rewrite
sudo a2enmod deflate
sudo a2ensite library
sudo service apache2 restart

Start web installation of Koha
The username to log in with will be koha_library and the password will be near the end of /etc/koha/sites/library/koha-conf.xml

Apply the following command to see the koha login password. Note down the password.

sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/library/koha-conf.xml

Open following link in a broswer and proceed with post installation configurations,

http://127.0.1.1:8080

How to change Koha master password?
See the following link
http://kohageek.blogspot.in/2013/05/how-to-change-master-password-of-koha.html

Zebra rebuild command

sudo su
koha-rebuild-zebra -v -f library

Reference

http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages#Enable_Modules_and_Site
 

21 comments:

  1. http://manual.koha-community.org/3.2/en/marceditexcel.html i go this link and follwo this steps but i got some error

    ReplyDelete
  2. Any Application Require for koha cateloging system and domain naming system such as http://opac.easternuni.edu.bd/ ?????? Please help me about this.

    ReplyDelete
  3. is this realy work properly ............ what u suggest to our school? can i going to work?

    ReplyDelete
    Replies
    1. Sure. You can proceed with the installation.

      Delete
  4. i have faced this problem what can I do

    Can't use an undefined value as an ARRAY reference at /usr/lib/perl5/DBI.pm line 205

    ReplyDelete
  5. i have faced this problem what can I do

    Can't use an undefined value as an ARRAY reference at /usr/lib/perl5/DBI.pm line 2054.

    ReplyDelete
  6. hi vimal my problem is .......... i don't know how can i got the password for ......... http://localhost:80

    ReplyDelete
    Replies
    1. You can login from stafffcient 127.0.1.1:8080
      locahost:80 for online catalogue.

      Delete
  7. After going through all the steps I found it

    System maintenance

    The Koha online catalog is offline for system maintenance. We'll be back soon! If you have any questions, please contact the site administrator


    pls help...

    ReplyDelete
    Replies
    1. You should login to Koha staff client (e.g. http://127.0.1.1:8080) and finish post installation steps.

      Delete
  8. I have installed ubuntu 14.04LTS koha dspace joomla using liblive cd.

    I understood that \etc\koha\koha-sites.conf is edited to configure using domain name.

    My question is how to configure static ip address to host the koha opac on web.

    ReplyDelete
  9. Dear Vimal,
    I got the following error at the last stage :
    sudo a2ensite library
    ERROR: Site library does not exist!

    Kindly advice

    ReplyDelete
    Replies
    1. No problem. You can proceed. Koha will work.
      You can try Koha on Ubuntu 14.04.
      Documentation is here
      http://kohageek.blogspot.in/2015/05/install-koha-on-ubuntu-1404.html

      Delete
  10. sir,in koha ,how we know whether we have missed any accession number in data entry

    ReplyDelete
  11. Create reports to know biblios without items,
    http://wiki.koha-community.org/wiki/SQL_Reports_Library#All_bibs_without_items

    ReplyDelete
  12. Sir, Kindly tell me. i have design OPAC on koha, So how to switched on Internet (on website) ?

    ReplyDelete
  13. how to install KOHA version 3.16.01?

    ReplyDelete
  14. Sir, I have found some errors regarding the installation of Koha common...mey be that is why the IP, 127.0.1.1:8080 is directing me to the apache web page instead of staffclient..what should I
    do now?

    ReplyDelete