Koha 3.10.03 su CentOS 6.3 i386 (installazione in locale) Indice CENTOS ............................................................................................................................1 APACHE............................................................................................................................1 MYSQL .............................................................................................................................1 PERL .................................................................................................................................2 PHP ....................................................................................................................................2 PRE-INSTALLATION SETUP .........................................................................................2 PHPMYADMIN ................................................................................................................3 KOHA ................................................................................................................................3 HTTPD - KOHA ...............................................................................................................4 CREARE UN DATABASE ...............................................................................................5 SET UP ADMIN INTERFACE .........................................................................................5 ZEBRA ..............................................................................................................................5 REINDEX ..........................................................................................................................6 DAEMON ..........................................................................................................................6 ZEBRA - DAEMON .........................................................................................................6 CAMBIARE I DATI DI DEFAULT DEL DATABASE ....................................................6 PATRON ............................................................................................................................6 CRONJOB .........................................................................................................................7 CENTOS 1. Scaricare CentOS e, dopo averlo scritto su un USB, installare la versione Live su una partizione --2. Verifica della versione dei CentOS # cat /etc/issue --- APACHE 3. Installare Apache # yum install httpd --4. Settare Apache in modo che parta al boot del sistema --5. Far partire Apache #service httpd start --6. Testare Apache digitare localhost nel browser e visualizzare la pagina Test di Apache --- MYSQL 7. Installare MySQL # yum install mysql mysql-server --8. Far partire MySQL #service mysqld start 1 --9. Mettere in sicurezza l’installazione di MySQL # /usr/bin/mysql_secure_installation Set root password? [Y/n] Remove anonymous users? [Y/n] Disallow root login remotely? [Y/n] Remove test database and access to it? [Y/n] Reload privilege tables now? [Y/n] --10. Provare ad accedere a MySQL # mysql -p enter the root password > exit --11. Settare MySQL in modo che parta al boot del sistema PERL 12. Installare Perl # yum install perl --13. Verifica della versione di Perl # rpm -qa perl --- PHP 14. Installare PHP # yum install php --14.1. Configurare PHP # vim /etc/php.ini memory_limit = 16M max_execution_time = 30 upload_max_filesize = 2M post_max_size = 8M --14.2. Riavviare Apache # service httpd restart --14.3. Testare PHP digitare localhost/phpinfo nel browser e visualizzare la pagina di output PHP --- PRE-INSTALLATION SETUP 15. Aggiornare il sistema # yum -y update (In caso si blocchi l'aggiornamento e yum rimanga in esecuzione digitare, come root, # yum-complete-transaction --cleanup-only) --16. Set up di EPEL and RPMForge. (Per facilitare l’installazione dei moduli Perl con RPM piuttosto che con Cpan) # rpm --install 'http://download.fedoraproject.org/pub/epel/…/epelrelease-….noarch.rpm' # rpm --install 'http://pkgs.repoforge.org/rpmforge-release/rpmforgerelease-….rpm' --- 2 17. Installare alcuni rpms non compresi nell’installazione di Centos, ma richiesti da Koha # yum -y install libyaz libyaz-devel perl-CPAN perl-CPAN-Meta-YAML gcc GraphicsMagick-perl # yum -y install --disablerepo=rpmforge,epel 'perl-*' # yum -y --enablerepo=rpmforge-extras install perl-YAML --17.1. Fissare l’installazione di GraphicsMagic # cd /usr/lib/perl5/auto/Graphics/Magick # mv Magick.so Magick-0.so # ld -share -o Magick.so `pwd`/Magick-0.so /usr/lib/libGraphicsMagick.so… --- PHPMYADMIN 18. Installare PhpMyAdmin # yum search phpMyadmin # yum -y install phpMyadmin.noarch --19. Riavviare Apache # service httpd restart --20. Testare PHPMyAdmin digitare localhost/phpmyadmin nel browser, inserire i dati di accesso e visualizzare la pagina di PHPMyAdmin --- KOHA 21. Aggiunggere un nuovo user per koha # useradd *** # passwd *** --22. Scaricare e decomprimere Koha # wget http://download.koha-community.org/koha-latest.tar.gz # tar xvf koha-latest.tar.gz --23. Installare "Development Tools" (per installare i moduli perl richiesti da Koha) # yum groupinstall "Development Tools" --24. Installare le dipendenze (usare lo script koha_perl_deps.pl per sapere quali moduli scaricare da EPEL and RPMForge. Non si specifichino singoli moduli, così che lo script valga anche quando quelli richiesti da Koha cambieranno) # cd koha-… # perl koha_perl_deps.pl -m | grep 'Yes' | sed -e 's/::/-/g' | awk '{print "yum -y install perl-"$1}' > perl-pkgs-install # sh perl-pkgs-install --25. Configurare CPAN per dire “yes” automaticamente e seguire e installare tutte le dipendenze in automatico # perl -MCPAN -e shell > o conf build_requires_install_policy yes > o conf prerequisites_policy follow > o conf commit > exit --- 3 25.1. Installare i moduli richiesti da Koha # cd koha-… # perl koha_perl_deps.pl -m | grep 'Yes' | awk '{print "cpan -i -f "$1}' > perlmodules-install # sh perl-modules-install --26. Installare gli ultimi moduli rimasti con cpan # cd koha-… # perl koha_perl_deps.pl -u -m # cpan AnyEvent AnyEvent::HTTP CGI::Session::Driver::memcached CHI CHI::Driver::Memcached Cache::Memcached::Fast DBD::SQLite2 Data::Pagination Data::Paginator JSON::Any Memoize::Memcached Moose MooseX::Storage MooseX::Types Net::Server Net::Z3950::ZOOM SMS::Send String::RewritePrefix Test::Strict Test::YAML::Valid Time::Progress UNIVERSAL::require DateTime DateTime::TimeZone --26.1. Risolvere il problema con il modulo Net::Z3950::ZOOM che non si installa: [fonte] http://lists.indexdata.dk/pipermail/net-z3950/2008-January/000723.html [/fonte] Scaricare da http://rpmfind.net/linux/rpm2html/search.php?query=tcp_wrappers-devel/ il pacchetto: "tcp_wrappers-devel-….rpm" [cartella dove si è scaricato]# rpm --install tcp_wrappers-devel-….rpm # cd koha-… # perl koha_perl_deps.pl -u -m # cpan Net::Z3950::ZOOM --27. Installare Koha # cd koha-… # perl Makefile.PL --28. Make Koha # cd koha-… # make --29. Make install Koha # cd koha-… # make install --30. Esportare le variabili relative a Koha # vim /…/koha.tcsh setenv KOHA_CONF /…/koha-conf.xml setenv PERL5LIB /…/koha/lib # vim /etc/profile.d/koha.sh export KOHA_CONF=/…/koha-conf.xml export PERL5LIB=/…/koha/lib --- HTTPD - KOHA 31. Settare Koha su HTTPD # ln -s /…/koha/koha-httpd.conf /…/conf.d/ # vim /…/httpd.conf Listen *** --32. Settare un http_context: # chcon -t httpd_sys_content_t /…/koha/intranet/cgi-bin/* -R 4 # chcon -t httpd_sys_content_t /…/koha/opac/cgi-bin/* -R --33. Riavviare Apache: # service httpd restart --- CREARE UN DATABASE 34. Creare il database Koha Login in http://localhost/phpmyadmin/ Aggiungere un database "***" Aggiungere un utente "***" con password "***" per il database "***" --- SET UP ADMIN INTERFACE 34. Andare a http://localhost:***/ per terminare l’installazione --- ZEBRA 35. Installare Yaz # wget http://ftp.indexdata.dk/pub/yaz/redhat/centos/.../SRPMS/yaz-...1indexdata.src.rpm # rpm -ivh yaz-…-1indexdata.src.rpm # cd /root/rpmbuild/SOURCES # tar xvf yaz-….tar.gz # cd yaz-… # ./configure # make # make install --36. Installare Libicu # yum install libicu-devel --37. Installare Zebra # wget http://ftp.indexdata.dk/pub/zebra/redhat/centos/.../SRPMS/idzebra-...1indexdata.src.rpm # rpm -ivh idzebra-…-1indexdata.src.rpm # cd /root/rpmbuild/SOURCES # tar xvf idzebra-….tar.gz # cd idzebra-… # ./configure # make # make install --38. Cambiare le Path # vim /…/koha/bin/koha-zebra-ctl.sh ZEBRASRV=/…/zebrasrv # vim /…/zebradb/zebra-authorities.cfg - zebra-authorities-dom.cfg - zebrabiblios.cfg - zebra-biblios-dom.cfg modulePath: /…/lib/idzebra-…/modules --39. Permission on folder 5 # cd /var/log/koha # chown -R koha… # cd /var/run/koha # chown -R koha… # cd /var/lock/koha # chown -R koha… --- REINDEX 40. Creare alcuni record (authorities e biblios) in Koha e fare un reindex totale: # su *** (come utente creato per Koha) # cd /…/koha/bin/ $ migration_tools/rebuild_zebra.pl -b -a -v -r --- DAEMON 41. Installare il tool daemon # wget http://libslack.org/daemon/download/daemon-....tar.gz # tar xvf daemon-….tar.gz # cd daemon-… # ./config # make # make test # make install --- ZEBRA - DAEMON 42. Situazione iniziale # ps aux | grep zebra --43. Zebra - Demone # ln -s /…/koha/bin/koha-zebra-ctl.sh # chkconfig --add koha-zebra-daemon # chkconfig koha-zebra-daemon on # su koha $ /…/init.d/koha-zebra-daemon start $ ps aux | grep zebra --- /…/init.d/koha-zebra-daemon CAMBIARE I DATI DI DEFAULT DEL DATABASE 44. Cambiare in #vim /…/koha/koha-conf.xml i dati di accesso al database 43. Eliminare da Phpmyadmin l'utente di default e farne uno con i dati di quello settato in koha-conf.xml --- PATRON 45. Dal pannello di controllo di Koha creare un Patron amministratore del sistema per non entrare con l'utente del database --- 6 CRONJOB 46. Settare un Cronjob per il reindex dei record [root@host /]# env … PATH=/… e poi: [root@host /]#su koha [koha@host /]$ crontab -e PERL5LIB=/…/koha/lib KOHA_CONF=/…/koha/koha-conf.xml */[time] * * * * PATH=/…; /usr/share/koha/bin/migration_tools/rebuild_zebra.pl b -a -z >/dev/null [gli a capo non vanno fatti] --- Ulteriore documentazione di riferimento http://wiki.koha-community.org/wiki/Koha_3.6_on_Centos_6.2_i386 7