Koha 3.10 on Centos 6.3 x86 64 en

WARNING! This page is obsolete.
This page is no longer correct and exists for historical reasons only.
Please see Installation Documentation for current information

This document is based on Koha 3.6 on Centos 6.2 i386.

This document includes detailed instructions on setting up Koha version 3.10 on Centos 6.3 x86_64.

Centos Installation

1. Installation
At the screen where you choose Centos Minimal click on Customize and add the following packages:

Applications:   Emacs, Graphics -> ImageMagick
Base: Perl
Databases: MySQL Client, MySQL Server
Development:  Additional Development -> libxslt-devel, tcp_wrappers-devel
Languages:  Chinese, Japanese
Servers:  Print Server, Email Server
Web Services: PHP Support -> php-mysql, Web Server -> bütün Perl modullleri

2. After installation, install packets below.

yum -y install rpm-cron memcached tcl libicu-devel make openssh-clients vim wget setools policycoreutils-python cyrus-sasl-plain

3. Patch your server after installation.

yum -y update

4. Disable Centos SELinux settings.

Open /etc/sysconfig/selinux file.

vim /etc/sysconfig/selinux

change

SELINUX=enforcing

line as

SELINUX=disabled

Reboot server.

Note, once your setup is solid it's recommended that you actually configure SELinux instead of just disabling it.

Koha installation: (Pre-installation tasks)

1. 1. Download Koha. Install EPEL and Rpmforge repos. These repos will provide you to install some of perl modules as RPM.

rpm --install 'http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm'
rpm --install 'http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.2-2.el6.rf.x86_64.rpm'
wget -nd 'http://download.koha-community.org/koha-latest.tar.gz'

2. Install packages necessary for Koha which are unavailable in Centos minimal installation.

yum -y install perl-CPAN perl-CPAN-Meta-YAML gcc GraphicsMagick-perl
yum -y install --disablerepo=rpmforge,epel 'perl-*'
yum -y install perl-DBD-SQLite2 perl-Unix-Syslog perl-UNIVERSAL-require perl-Net-Server patch perl-Moose 
 perl-Test-YAML-Valid perl-Time-Progress

# perl-YAML 0.72
yum -y --enablerepo=rpmforge-extras install perl-YAML

3. Download yaz and zebra packets from indexdata site and install them.

wget http://ftp.indexdata.dk/pub/zebra/redhat/centos/6/RPMS/x86_64/idzebra-2.0-2.0.54-1indexdata.x86_64.rpm
wget http://ftp.indexdata.dk/pub/zebra/redhat/centos/6/RPMS/x86_64/libidzebra-2.0-2.0.54-1indexdata.x86_64.rpm
wget http://ftp.indexdata.dk/pub/zebra/redhat/centos/6/RPMS/x86_64/libidzebra-2.0-modules-2.0.54-1indexdata.x86_64.rpm
wget http://ftp.indexdata.dk/pub/zebra/redhat/centos/6/RPMS/x86_64/libidzebra-2.0-devel-2.0.54-1indexdata.x86_64.rpm

wget http://ftp.indexdata.dk/pub/yaz/redhat/centos/6/RPMS/x86_64/libyaz4-4.2.51-1indexdata.x86_64.rpm
wget http://ftp.indexdata.dk/pub/yaz/redhat/centos/6/RPMS/x86_64/libyaz4-devel-4.2.51-1indexdata.x86_64.rpm
wget http://ftp.indexdata.dk/pub/yaz/redhat/centos/6/RPMS/x86_64/yaz-4.2.51-1indexdata.x86_64.rpm


rpm -ivh libidzebra* idzebra* libyaz4* yaz*

Note: Zebra version should be 2.0.52 or later. Otherwise materials related to records do not appear in the search results when records are updated.

4. Fix GraphicsMagic installation.

cd /usr/lib64/perl5/vendor_perl/auto/Graphics/Magick
mv Magick.so Magick-0.so
ld -share -o Magick.so `pwd`/Magick-0.so /usr/lib64/libGraphicsMagick.so.3.10.0

5. Install perl packages that do not come with Centos deployment. And upgrade perl modules which do not meet Koha’s requirements.

Find missing perl rpm packages using koha _perl_deps.pl scripts and install them:

tar zxf koha-latest.tar.gz
cd koha-3.10.01
perl koha_perl_deps.pl -m -b -r | sed -e 's/::/-/g' | awk '{print "yum -y install perl-"$1}' > perl-pkgs-install

sh perl-pkgs-install

perl-MARC-Charset package version 1.1 causes Turkish character problem. Thus, this package should be uninstalled and new version should be installed from CPAN.

rpm -e perl-MARC-Charset

Install the rest of perl modules from CPAN. Tell CPAN to auto default to yes and follow and install dependencies automatically.

perl -MCPAN -e shell
o conf build_requires_install_policy yes
o conf prerequisites_policy follow
o conf commit

Take lists of perl modules which come with Centos or installed with yum program from repos which does not meet Koha’s requirements.

perl koha_perl_deps.pl -u

As of the moment this document is written perl-Date Time packet does not meet Koha’s requirements. Thus, this package should be uninstalled and new version should be installed from CPAN. Remove these and such like packages from the system and install new versions of necessary perl modules from CPAN.

yum erase perl-DateTime
perl koha_perl_deps.pl -m -b -r | awk '{print "cpan -i "$1}' > perl-modules-install
sh perl-modules-install

Packages failed to install should be installed using “-f” switch.

perl koha_perl_deps.pl -m -b -r | awk '{print "cpan -i -f "$1}' > perl-modules-install2
sh perl-modules-install2

Install optional perl modules ,

perl koha_perl_deps.pl -m | grep 'No' | sed -e 's/::/-/g' | awk '{print "yum -y install perl-"$1}' > perl-pkgs-install-nr

sh perl-pkgs-install-nr

To see the list of perl modules installed with rpm package manager and does not meet Koha’s requirements run following command.

perl koha_perl_deps.pl -u

Uninstall these modules and then install them via CPAN.

perl koha_perl_deps.pl -u | grep 'No' | sed -e 's/::/-/g' | awk '{print "yum -y erase perl-"$1}' > perl-pkgs-install-sil

sh perl-pkgs-install-sil

Install modules from CPAN which you uninstalled,

perl koha_perl_deps.pl -m | grep 'No' | awk '{print "cpan -i "$1}' > perl-modules-install-nr
sh perl-modules-install-nr

Mysql server settings

You may set up mysqld to start automatically on every boot.

chkconfig mysqld on

Make changes below at /etc/my.cnf file. Restart mysql server.

vim /etc/my.cnf

[mysqld]
character-set-server=utf8
skip-character-set-client-handshake

service mysqld restart

Run command below for mysql server security configuration.

/usr/bin/mysql_safe_installation

Generate KOHA database. Set a password for kohaadmin user. In the example below, the password has been set as ‘kohasecret’.

mysqladmin -u root -p create koha
mysql -u root -p
grant all privileges on koha.* to kohaadmin@localhost identified by 'kohasecret';
flush privileges;

KOHA installation:

Go to Koha installation directory. Run commands below.

groupadd koha
useradd -s /bin/false -d /usr/share/koha -g koha -M koha
perl Makefile.PL

At this stage (while Makefile.PL script is running), some of questions will be asked. There are adequate explanations in the script. The server should have registered DNS name. Otherwise the script fails. When the script finishes successfully, Makefile file will have been generated. When you want to change any settings related to the script, rerun it. When you have finished with it, install koha files into the system by running following commands.

make
make install

To run a script from shell related to koha, define shell variables.

vim /etc/profile.d/koha.tcsh
setenv KOHA_CONF /etc/koha/koha-conf.xml
setenv PERL5LIB /usr/share/koha/lib

vim /etc/profile.d/koha.sh
export KOHA_CONF=/etc/koha/koha-conf.xml
export PERL5LIB=/usr/share/koha/lib

Koha zebra index configuration

1. Installation of koha index daemon
It is necessary to install koha-index-daemon program in order to update zebra indexes according to Koha catalog records changes. Koha comes with zebraqueue_daemon.pl script. This script has some problems. It is better to use Tamil index program. Install it from CPAN;

 cpan -i Koha::Contrib::Tamil

2. Zebra configuration
Package installation has been described above. The path that zebra modules have been installed displayed incorrectly in Zebra setting files in 64 bit systems. These files are zebra-authorities.cfg, zebra-authorities-dom.cfg, zebra-biblios.cfg, zebra-biblios-dom.cfg files. They are found in /etc/koha/zebradb/ in Centos Koha installation. Open these files

vim /etc/koha/zebradb/zebra-*.cfg

and then change line

modulePath: /usr/lib/idzebra-2.0/modules

as below.

modulePath: /usr/lib64/idzebra-2.0/modules

Otherwise, zebra modules cannot be started in 64 bit systems. We installed zebra 2.0 series software. In version 2.0 zebraidx binary is named as zebraidx-2.0. And in some koha scripts zebra binary is reffered as zebraidx. So ‘zebraidx-2.0’ file should be linked as ‘zebraidx’,

ln -s /usr/bin/zebraidx-2.0 /usr/bin/zebraidx

(This step may be unnecessary with newer packages: idzebra-2.0.58-6.fc23.x86_64 creates the symlink upon installation.)

If you selected GRS1 as record filter in koha installation you should make modification in word-phrase-utf.chr file for Zebra to search “İ” and “ı” Turkish letters correctly. Add lines below to word-phrase-utf.chr file.

vim /etc/koha/zebradb/etc/word-phrase-utf.chr

Add

map İ	i
map ı	i

lines. If you use ICU, you should modify etc/koha/zebradb/etc/words-icu.xml file. Find

<transliterate rule="\'>\ "/>

line and add

<transliterate rule="ı>I"/>

line below.

In order to run zebra services at system startup add lines below to “/etc/rc.local” file,

export KOHA_CONF=/etc/koha/koha-conf.xml
export PERL5LIB=/usr/share/koha/lib
/usr/bin/zebrasrv-2.0 -D -T -p /var/run/zebrasrv.pid -f /etc/koha/koha-conf.xml -l /var/log/koha/zebrasrv.log
/usr/local/bin/koha-index-daemon --timeout 10 --directory /tmp &

HTTPD Configuration

Make symbolic link to koha web server configuration file from apache server configuration directory.

ln -s /etc/koha/koha-httpd.conf /etc/httpd/conf.d/ 
vim /etc/httpd/conf/httpd.conf 
Listen 8008

Define your web server ports for Koha opac and staff interfaces. A sample setting is given below. You can customize web configuration for your needs.

vim /etc/httpd/conf.d/koha-httpd.conf
<VirtualHost *:80>
<VirtualHost *:8008>
Timeout 3600

Iptables rules

Give necessary permissions from your firewall to web, zebra etc. services. In our example we are using ports 80,443 and 8008 for web, 9998 for zebra and z39.50, 5500 for oclc gateway. Insert following rules (to the top of INPUT rules) to /etc/sysconfig/iptables file) and restart iptables service.

vim /etc/sysconfig/iptables

-A INPUT -m state --state NEW -m tcp -p tcp -s 192.168.71.146 --dport 3306 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 443 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 5500 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8008 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 9998 -j ACCEPT

/etc/init.d/iptables restart

Turkish Translation

İssue commands below to install Turkish translations files to the system. For languages other than Turkish, change tr-TR code with appropriate language code.

cd /usr/share/koha/misc/translator/
perl translate install tr-TR

Web Installation

From your browser (on the server of installed KOHA), open http://localhost:8008/ address from a browser. Make necessary settings from administrator interface.

Generating Zebra indexes

Stop any running zebra programs. Generate Zebra indexes by issuing commands below,

cd /usr/share/koha/bin/migration_tools/
./rebuild_zebra.pl -b -a -r -v

Rerun Zebra services,

. /etc/rc.local

Cron Settings

Create a file named as koha for basic cron services in /etc/cron.d/ directory

vim /etc/cron.d/koha

File content will be as follows,

SHELL=/bin/bash
PATH=/sbin:/bin:/usr/sbin:/usr/bin
MAILTO=root
HOME=/

PERL5LIB="/usr/share/koha/lib"
KOHA_CONF="/etc/koha/koha-conf.xml"

# ADVANCE NOTICES. Every day at 05:49 am.
49 5 * * * root perl /usr/share/koha/bin/cronjobs/advance_notices.pl -c

# OVERDUE NOTICES. Everyday at 05:45 am.
45 5 * * * root perl /usr/share/koha/bin/cronjobs/overdue_notices.pl -t

# SEND EMAILS. Everyday at 06:30 am.
30 6 * * * root perl /usr/share/koha/bin/cronjobs/process_message_queue.pl

# FINES. Everyday from 07:00 am to 23:00 pm
0 7-23/2 * * * root perl /usr/share/koha/bin/cronjobs/fines.pl

Make cron service reread its settings.

 service crond reload