Install Koha on Ubuntu 14.04

Install Ubuntu 14.04 and update

Koha can install on Ubuntu/Xubuntu/Kubuntu/Lubuntu/LinuxMint 17. Install the operating system first. Then update the system using following commands:

apt-get update
apt-get upgrade

Install lightweight text editor
 
apt-get install leafpad

Add Koha community repository
Add Koha software channel into Ubuntu.

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


apt-get update

Install Koha
Following command will install latest release of Koha.

apt-get install koha-common

The command will start to download Koha and required packages.
On the way, the process will ask to enter mail of system. Accept the default values.

Have you got following error message?

Errors were encountered while processing:
 libapache2-mpm-itk
 apache2-mpm-itk
 koha-common
E: Sub-process /usr/bin/dpkg returned an error code (1)


This error related with  apache2-mpm-itk issue. Apply following commands. If you have not found error related to apache2-mpm-itk, skip following section.

How to solve apache2-mpm-itk issue?

Apply following commands in a terminal

sudo a2dismod mpm_event
sudo a2enmod mpm_prefork
sudo service apache2 restart

sudo apt-get install -f

Server configuration
In this step, need to edit network information like domain name and port numbers.

sudo leafpad /etc/koha/koha-sites.conf

Here I change port number of Koha staff client to 8080. Find following line in the file and make changes.

INTRAPORT="8080"


Install MySQL server
Apply following command to install MySQL server.

sudo apt-get install mysql-server

Give a new password for root user while installation.

Koha instance creation
Apply following commands to create Apache configuration files.

sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart


Create a Koha instance with the name library.

sudo koha-create --create-db library

Ubuntu MySQL security Tweak
Apply following commands:

sudo su
mysql -u root -p


[Enter the MySQL Root password when it ask]

Execute the following commands  too,

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


Adding ports
We have assigned 8080 port for Koha staff client and 80 for OPAC.
Open following file and add new port.

sudo leafpad /etc/apache2/ports.conf

Copy paste following line below Listen 80

Listen 8080



Restart Apache,

sudo service apache2 restart


Enable modules and sites

sudo a2dissite 000-default
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 browser and proceed with the post installation configurations,

http://127.0.1.1:8080


Default User Name is koha_library

How to change Koha default master password?

Default master passerword of Koha is difficult to remember. Either note down the password in a diary or change the password.

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


Install missing PERL modules
After install need to install some PERL PERL modules using CPAN.
Koha > About Koha > Perl Modules
Find missing PERL modules in different colors.

Open a terminal and apply following command to enable CPAN.

sudo su
cpan

To install a particular PERL module, e.g.

install Test::DBix::Class


Reference
Koha on Ubuntu Packages

Clean all fine amount

In certain occassions librarian need to clean entire fine amount in Koha system. Amount and outstanding fines are located in accountlines table in Koha database.


You can apply following commands to clean entire fine amount in the table.

Open Applications > Accessories > Terminal

Open mysql account,

sudo su
mysql -uroot -p

Clean amount in table,

mysql -uroot -pmysqlroot
use koha_library;
UPDATE `accountlines` SET `amount` = '';
UPDATE `accountlines` SET `amountoutstanding` = '';
quit 


Check the change now




Resize patron images to upload

Resize  patron images before upload into Koha. Big size patron images can make Koha database size big. You can resize images using imagemagick commands with Ubuntu or Debian.

Install Image Magick

sudo apt-get install imagemagick

Copy all patron images into a folder. Enter inside the folder from command Terminal, Example:

cd /home/koha/Pictures 

mogrify -resize 50% -format jpg *


Change percentage based on the original file size.

Resize image by specifies width and height,

mogrify -resize 800x600 -format jpg *

Specify width only, it automatically calculate height,

mogrify -resize 800x -format jpg *

Information courtesy: Shaiful Azam's Weblog

കോട്ടയം പബ്ലിക്‌ ലൈബ്രറി സ്വതന്ത്ര സോഫ്റ്റ്‌വെയർ ഉപയോഗിച്ച് കമ്പ്യൂട്ടർവൽക്കരിക്കുന്നു.

വിവര സാങ്കേതിക വിദ്യയിലെ മാറ്റങ്ങൾ ലൈബ്രറികളുടെ  പ്രവർത്തന രീതികളെ അടിമുടി പരിഷ്ക്കരിച്ചിട്ടുണ്ട്. കമ്പ്യൂട്ടർവൽക്കരണത്തിലൂടെ മെച്ചപ്പെട്ട സേവനം വായനക്കാർക്ക് നൽകുന്നതിനു ലൈബ്രറികൾക്ക് സാധിക്കുന്നുണ്ട്. ലൈബ്രറികളുടെ കമ്പ്യൂട്ടർവൽക്കരണം അടുത്ത കാലം വരെ ചിലവേറിയതായിരിന്നു. ലൈബ്രറി സോഫ്റ്റ്‌വെയറുകളുടെ ഉയർന്ന വിലയായിരിന്നു പ്രധാന കാരണം. സ്വതന്ത്ര സോഫ്റ്റ്‌വെയറിന്റെ ഈ രംഗത്തെക്കുള്ള കടന്നു വരവ് ലൈബ്രറികളുടെ കമ്പ്യൂട്ടർവൽക്കരണം കാര്യക്ഷമമായ രീതിയിലും, കുറഞ്ഞ ചിലവിലും നടത്തുവാൻ സാധിക്കും എന്ന് തെളിയിച്ചു. 

'കോഹ' (Koha) സ്വതന്ത്ര സോഫ്റ്റ്‌വെയർ ഉപയോഗിച്ചു കൊണ്ട് കോട്ടയം പബ്ലിക്‌ ലൈബ്രറി (Kottayam Public Library) കമ്പ്യൂട്ടർവൽക്കരിക്കുന്ന പദ്ധതിക്ക് തുടക്കം കുറിക്കുകയാണ്. ന്യൂസിലണ്ടിലെ ഹാരോവെന്വ ലൈബ്രറി ട്രസ്റ്റ്‌ (Horowhenua Library Trust) ആണ് കോഹ ലൈബ്രറി സോഫ്റ്റ്‌വെയർ പദ്ധതിക്ക് 2000ൽ തുടക്കമിട്ടത്. ഇന്ന് ലോകത്താകമാനം വിവിധ തരം ലൈബ്രറികളിൽ കോഹ ഉപയോഗിച്ചു വരുന്നു. ഇന്ത്യയിൽ തന്നെ ഡൽഹി പബ്ലിക്‌ ലൈബ്രറിയും (Delhi Public Library), കൊണ്ണമാറ പബ്ലിക്‌ ലൈബ്രറിയും (Konnemara Public Library) കോഹ ഉപയോഗിക്കുന്നുണ്ട്. കേരളത്തിലെ ഭൂരിഭാഗം  യുണിവേഴ്സിറ്റി ലൈബ്രറികളും കോഹ ഉപയോഗിച്ചു തുടങ്ങിയിരിക്കുന്നു. 

ഒരു ലക്ഷത്തിലധികം പുസ്തകങ്ങളാണ് കോട്ടയം പബ്ലിക്‌ ലൈബ്രറിയിൽ ഉള്ളത്. പുസ്‌തകങ്ങളെക്കുറിച്ചുള്ള വിവരങ്ങൾ മെച്ചപ്പെട്ട രീതിയിൽ വായനക്കാർക്ക് അറിയുന്നതിനുള്ള സംവിധാനം ഒരുക്കുകയാണ് പ്രധാന ലക്ഷ്യം. ഇതിനു വേണ്ടിയുള്ള ഓണ്‍ലൈൻ കാറ്റലോഗ് ഉടൻ പ്രവർത്തന സജ്ജമാകും. ഓരോ ഭാഷയിലുമുള്ള പുസ്തകങ്ങളുടെ വിവരങ്ങൾ അതാത് ഭാഷകളിൽ തന്നെ ലഭ്യമാക്കാൻ കഴിയും. വായനക്കാരന് വീട്ടിലിരിന്നു കൊണ്ട് തന്നെ ഇന്റർനെറ്റിന്റെ സഹായത്തോടെ പുസ്തകങ്ങൾ തിരയാനും അവയുടെ ലഭ്യത പരിശോധിക്കാനും പുതിയ സംവിധാനത്തിന്റെ സഹായത്തോടെ സാധിക്കും. പുസ്തകങ്ങൾ ഓണ്‍ലൈൻ റിസർവ് ചെയ്യാം. വായനക്കാർക്ക്‌ പുതിയ പുസ്തകങ്ങൾ വാങ്ങാനുള്ള നിർദേശം ഓണ്‍ലൈൻ കാറ്റലോഗിലൂടെ സമർപ്പിക്കാം. 

സ്വതന്ത്ര സോഫ്റ്റ്‌വെയർ ഉപയോഗിച്ച് കമ്പ്യൂട്ടർവൽക്കരണം നടത്തുന്ന മധ്യ തിരുവിതാംകൂറിലെ ആദ്യ പബ്ലിക്‌ ലൈബ്രറി ആയിരിക്കും കോട്ടയം പബ്ലിക്‌ ലൈബ്രറി. ഈ പ്രദേശത്തെ മറ്റു പബ്ലിക്‌ ലൈബ്രറികൾക്ക് കമ്പ്യൂട്ടർവൽക്കരണത്തിനു ഒരു പുതിയ മാതൃക കാണിച്ചു കൊടുക്കുന്നതിനും, മാർഗ നിർദേശവും പരിശീലനവും നൽകുന്നതിനു ഈ സംരംഭം കൊണ്ട് സാധിക്കും.

Install perl modules through CPAN on Debian/ Ubuntu

After installation of Koha on Debian, it seems that installation of remaining cpan modules (e.g. Data::Pagination) reluctant to install via terminal. We need to install following package to install CPAN modules properly:

su
apt-get install build-essential

Then try to install cpan modules from terminal,

cpan
install Package::Name

e.g. install Data::Pagination 

Add a staff patron

Adding staff patron in Koha help library staff in various sections to get individual login power to perform routines tasks (e.g. Circulation, Acquisition, Cataloging etc.). Follow the steps,

1. Create a profile for the staff. Patron category should be staff.
    Patrons > New Patron > Staff Patron



   Assign user name and password to login
Save patron profile.


2. Give necessary permission to access various Koha modules,


Check the necessary modules. Remember to check Catalogue module, mandatory for login.


Save the permissions and log out from Koha. Try to login using new staff patron user name and login.