Koha on Redhat Enterprise 6

From Koha Wiki

Jump to: navigation, search
Home > Documentation
Home > Documentation > Installation
Home > Documentation > Installation > Installation alternatives
Koha > Technical > Administration
Koha > Technical > Administration

Environment: Virtual machine running under Virtualbox on Windows host

Redhat version: Red Hat Enterprise Linux Server release 6.3 (Santiago)

Koha Version: 3.08.06 (Source Tarball)

Zebra Version: 2.0.52 (Source Tarball)

Yaz Version: 4.2.44 (Source Tarball)


Redhat repos needed for proper RPM installation:

  • rhel-6-server-cf-tools-1-rpms
  • rhel-6-server-optional-rpms
  • rhel-6-server-rhev-agent-rpms
  • rhel-6-server-rpms
  • rhel-6-server-source-rpms

Redhat Dependencies Required before install:

ImageMagick-devel-6.5.4.7-6.el6_2.i686        
ImageMagick-6.5.4.7-6.el6_2.i686             
libXt-devel-1.0.7-1.el6.i686                 
libwmf-lite-0.2.8.4-22.el6.i686              
libSM-devel-1.1.0-7.1.el6.i686               
ghostscript-devel-8.70-14.el6_3.1.i686       
libtiff-devel-3.9.4-6.el6_3.i686             
libtiff-3.9.4-6.el6_3.i686                   
ghostscript-8.70-14.el6_3.1.i686             
libICE-devel-1.0.6-1.el6.i686                
libXext-devel-1.1-3.el6.i686                 
lcms-devel-1.19-1.el6.i686                   
jasper-devel-1.900.1-15.el6_1.1.i686         
bzip2-devel-1.0.5-7.el6_0.i686               
gdbm-devel-1.8.0-36.el6.i686                 
libxslt-devel-1.1.26-2.el6_3.1.i686          
libxslt-1.1.26-2.el6_3.1.i686                
libgcrypt-devel-1.4.5-9.el6_2.2.i686         
libxml2-devel-2.7.6-8.el6_3.3.i686           
libgpg-error-devel-1.7-4.el6.i686            
perl-XML-SAX-0.96-7.el6.noarch               
perl-XML-LibXML-1.70-5.el6.i686              
perl-XML-NamespaceSupport-1.10-3.el6.noarch  
libxml2-python-2.7.6-8.el6_3.3.i686          
libxml2-2.7.6-8.el6_3.3.i686                 
libXpm-devel-3.5.8-2.el6.i686                
libjpeg-devel-6b-46.el6.i686                 
gd-devel-2.0.35-10.el6.i686                  
libX11-devel-1.3-2.el6.i686                 
libXdmcp-devel-1.0.3-1.el6.i686              
libpng-devel-1.2.49-1.el6_2.i686             
fontconfig-devel-2.8.0-3.el6.i686            
libxcb-devel-1.5-1.el6.i686                  
libXau-devel-1.0.5-1.el6.i686                
freetype-devel-2.3.11-6.el6_2.9.i686         
zlib-devel-1.2.3-27.el6.i686                 
xorg-x11-proto-devel-7.6-13.el6.noarch       
gnome-utils-libs-2.28.1-10.el6.i686          
gd-2.0.35-10.el6.i686                        
libXpm-3.5.8-2.el6.i686                      
imake-1.0.2-11.el6.i686                      
bison-2.4.1-5.el6.i686                       
gcc-c++-4.4.6-4.el6.i686                     
libtool-2.2.6-15.5.el6.i686                  
gcc-4.4.6-4.el6.i686                         
cloog-ppl-0.15.7-1.2.el6.i686                
ppl-0.10.2-11.el6.i686                       
cpp-4.4.6-4.el6.i686                         
mpfr-2.4.1-6.el6.i686                        
glibc-devel-2.12-1.80.el6_3.6.i686           
glibc-headers-2.12-1.80.el6_3.6.i686         
glibc-2.12-1.80.el6_3.6.i686                 
glibc-common-2.12-1.80.el6_3.6.i686          
libstdc++-docs-4.4.6-4.el6.i686              
python-babel-0.9.4-5.1.el6.noarch            
babel-0.9.4-5.1.el6.noarch                   
libstdc++-devel-4.4.6-4.el6.i686             
kernel-headers-2.6.32-279.11.1.el6.i686      
automake-1.11.1-1.2.el6.noarch               
autoconf-2.63-5.1.el6.noarch                 
memcached-1.4.4-3.el6.i686                   
mysql-server-5.1.61-4.el6.i686               
httpd-manual-2.2.15-15.el6_2.1.noarch        
perl-DBD-MySQL-4.013-3.el6.i686              
mysql-5.1.61-4.el6.i686                      
httpd-2.2.15-15.el6_2.1.i686                 
httpd-tools-2.2.15-15.el6_2.1.i686           
apr-util-ldap-1.3.9-3.el6_0.1.i686           
apr-util-1.3.9-3.el6_0.1.i686                
apr-1.3.9-5.el6_2.i686                       



Download the source versions of Koha, Zebra and Yaz. In order to get Zebra to work nicely with Koha under Redhat, you must compile Zebra from source instead of using the Binary versions supplied via repos. Yaz is a dependency of Zebra, so it also must be compiled from source and installed first.

Here's what I wanted my directory structure to look like:

  - data0
     - koha (Koha home)
        - support 
          - yaz-4.2.44 (Yaz Home)
          - zebra-2.0.52 (Zebra Home)

Yaz

./configure --prefix=/data0/koha/support/yaz-4.2.44 make make install


Zebra

./configure --with-yaz=/data0/koha/support/yaz-4.2.44/bin --prefix=/data0/koha/support/zebra-2.0.52 make make test make install


Link all the binaries and library files into /usr/bin and /usr/lib respectively.

Before proceeding with the installation of Koha, you must first install all missing perl modules. This step can be quite tricky and tedious, but if you get all the dependencies installed through Yum, as mentioned above, you shouldn't have too many problems. To get a list of the perl modules you are missing, use the koha_perl_deps.pl perl script to show you which modules you have installed and which ones are still missing. To install missing Perl modules, simply install them using CPAN.

I found that SELinux was preventing some things from working as expected. I disabled SELinux in the test environment, but exceptions can be put into place to allow modification to the files SELinux is preventing Koha from writing to.

The koha-zebra-ctl.sh script that ships with Koha is not suited for Redhat Linux (prime culprit is the use of the "daemon" command, which is not available in Redhat). Instead, I modified the script to use Zebra's built in daemonize flag when launching. The modified script can also kill a running zebra instance as well with the 'pkill' command.

koha-zebra-ctl.sh needs to be copied or symlinked to /etc/init.d. To get the system to start Zebra at system startup, the startup script also needs to be put into the rc.x directories. Below is how I set up the run control scripts:

  lrwxrwxrwx. 1 root root 27 Nov 15 08:49 rc.d/rc0.d/K37zebra -> ../init.d/koha-zebra-ctl.sh
  lrwxrwxrwx. 1 root root 27 Nov 15 08:48 rc.d/rc3.d/S66zebra -> ../init.d/koha-zebra-ctl.sh
  lrwxrwxrwx. 1 root root 33 Nov 15 08:47 rc.d/init.d/koha-zebra-ctl.sh -> /data0/koha/bin/koha-zebra-ctl.sh
  lrwxrwxrwx. 1 root root 27 Nov 15 08:49 rc.d/rc2.d/K37zebra -> ../init.d/koha-zebra-ctl.sh
  lrwxrwxrwx. 1 root root 27 Nov 15 08:50 rc.d/rc6.d/K37zebra -> ../init.d/koha-zebra-ctl.sh
Personal tools