koha-mungle-borrowers.sh
Ova stranica će pokušati dokumentirati instalaciju kohe na najjednostavniji mogući način. Primjeri za korištenje su:
- demo instanca
- development instanca
- recovery iz backup-a ili testiranje sa zadnjom verzijom kohe iz git-a (potreban je samo dump baze)
Cijela virtualna mašina dostupna je kao ~325 Mb download: http://mjesec.ffzg.hr/~dpavlin/koha/koha-lxc-20091207.tar.bz2
Oprez: ova virtualna mašina nema root password a svi ostali passwordi su dokumentirani na ovoj stranici, tako da je mudro promjeniti ih ako je želite koristiti!!
Contents: [Koha Croatian user group]
|
Virtualna mašina
Instalacija u LXC (Linux containers) ali bilo koja instalacija bi trebala biti jednako dobra.
root@t61p:~# lxc-debian create
What is the name for the container ? [debian] koha-lxc
What hostname do you wish for this container ? [koha-lxc]
What IP address do you wish for this container ? [172.20.0.21] 192.168.3.3
What is the gateway IP address ? [172.20.0.1] 192.168.3.1
What is the MTU size ? [1500]
Specify the location of the rootfs [./rootfs.koha-lxc] /virtual/koha-lxc
Specify the location for an extra fstab file [(none)]
Choose your architecture
1) amd64
2) i386
#? 2
Architecture i386 selected
Checking cache download ...Found.
Copying rootfs ...
...
Za locale bi bilo zgodno instalirati:
- en_US.UTF-8 UTF-8
- hr_HR.UTF-8 UTF-8
Default locale for the system environment: None
root@t61p:~# lxc-start --name koha-lxc
Naša virtualna mašina se zove koha-lxc i da bi Koha testovi prošli mora biti moguće resolvati to DNS ime. Provjerite da /etc/hosts ima zapis:
koha-lxc:/srv/koha# grep koha-lxc /etc/hosts
192.168.3.3 koha-lxc
Dodatni paketi
koha-lxc:~# apt-get install vim less openssh-server git-core dselect
Zebra
koha-lxc:/srv/koha# cat > /etc/apt/sources.list.d/indexdata.list
deb http://ftp.indexdata.dk/debian lenny main
deb-src http://ftp.indexdata.dk/debian lenny main
GIT
koha-lxc:~# cd /srv/
koha-lxc:/srv# git clone git://git.koha.org/pub/scm/koha.git
Initialized empty Git repository in /srv/koha/.git/
...
Ostatak instalacije manje-više slijedi upute od Kohe: INSTALL.debian-lenny
Lokalni branch
Napraviti lokalni branch za ovu intalaciju:
koha-lxc:/srv/koha# git checkout -b koha-lxc origin
Branch koha-lxc set up to track remote branch refs/remotes/origin/master.
Switched to a new branch "koha-lxc"
Push lokalnih promjena na drugi git server
Opcionalno dodajte svoj public git repozitorij u koji će se spremati promjene:
koha-lxc:/srv/koha# git remote add koha-dev dpavlin@koha-dev.rot13.org:/srv/koha/
Prvi push mora imati --all parametar da prebaci i novo ime branch-a a ne samo promjene:
koha-lxc:/srv/koha# git push koha-dev --all
dpavlin@koha-dev.rot13.org's password:
Counting objects: 5, done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 339 bytes, done.
Total 3 (delta 2), reused 0 (delta 0)
To dpavlin@koha-dev.rot13.org:/srv/koha/
* [new branch] koha-lxc -> koha-lxc
Debian paketi
dpkg --set-selections < install_misc/debian-lenny.packages
dselect
# Install, Quit
MySQL
U jednom trenutku instalacija će pitati:
New password for the MySQL "root" user:
npr. mysqlroot
Kreirati bazu
koha-lxc:~# mysqladmin -uroot -pmysqlroot create koha
Kreirati korisnika
koha-lxc:~# mysql -uroot -pmysqlroot
mysql> grant all on koha.* to 'kohaadmin'@'localhost' identified by 'katikoan' ;
Query OK, 0 rows affected (0.00 sec)
mysql> flush privileges;
Query OK, 0 rows affected (0.00 sec)
mysql> quit
Provjerite da se možete povezati sa kohaadmin korisnikom:
koha-lxc:/srv/koha# mysql -h localhost -ukohaadmin -pkatikoan koha
korisnik i grupa
koha-lxc:/srv/koha# addgroup koha
Adding group `koha' (GID 1000) ...
Done.
koha-lxc:/srv/koha# adduser --no-create-home --disabled-login --ingroup koha --gecos Koha koha
Adding user `koha' ...
Adding new user `koha' (1000) with group `koha' ...
Not creating home directory `/home/koha'.
perl
Debian paketi
koha-lxc:~# apt-get install libgd-gd2-perl libgd-barcode-perl libnumber-format-perl libcache-memcached-perl libparams-util-perl libmodule-install-perl
CPAN
koha-lxc:~# cpan Algorithm::CheckDigits HTTP::OAI IPC::Cmd IPC::Cmd Memoize::Memcached PDF::API2::Simple PDF::Reuse::Barcode PDF::Table SMS::Send Storable Test::More Authen::CAS::Client
Authen::CAS::Client
Trenutna development koha ima bug zbog kojeg je CAS autorizacija po defaultu uključena, pa zahtijeva još nekoliko dodatnih modula
koha-lxc:~# apt-get install libtest-mockobject-perl
koha-lxc:~# cpan Authen::CAS::Client
SAX parser
koha-lxc:/srv/koha# apt-get remove libxml-sax-expat-perl
koha-lxc:/srv/koha# misc/sax_parser_print.pl
Koha wants something like:
XML::LibXML::SAX::Parser=HASH(0x81fe220)
You have:
XML::LibXML::SAX::Parser=HASH(0x9858cc0)
Looks good.
Koha install
koha-lxc:/srv/koha# perl Makefile.PL
...
koha-lxc:/srv/koha# make test
...
koha-lxc:/srv/koha# make install
/usr/bin/perl "-Iblib/arch" "-Iblib/lib" fix-perl-path.PL blib
Koha's files have now been installed.
In order to use Koha's command-line batch jobs,
you should set the following environment variables:
export KOHA_CONF=/etc/koha/koha-conf.xml
export PERL5LIB=/usr/share/koha/lib
Apache
ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
Enable port 8080 for Koha intranet
koha-lxc:/srv/koha# echo 'Listen 8080' > /etc/apache2/conf.d/port-8080.conf
And finish Apache configuration:
koha-lxc:/srv/koha# a2enmod rewrite
koha-lxc:/srv/koha# a2ensite koha
koha-lxc:/srv/koha# /etc/init.d/apache2 restart
Zebra
koha-lxc:/srv/koha# ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
koha-lxc:/srv/koha# update-rc.d koha-zebra-daemon defaults
koha-lxc:/srv/koha# /etc/init.d/koha-zebra-daemon start
Finish Koha instalation
http://192.168.3.3:8080/
- login: kohaadmin
- password: katikoan
from /etc/koha/koha.conf.xml
koha-lxc:/srv/koha# egrep '(user|pass)' /etc/koha/koha-conf.xml | tail -2
<user>kohaadmin</user>
<pass>katikoan</pass>
Prebacivanje postojece instalacije na cisti Squeeze i upgrade na 3.2.x
Konacno sam uhvatio vremena testirati upgrade 3.1 na 3.2.x iz Git-a (na IRB-u)
1. prebacio sam cijelu bazu i aplikaciju na virtualni server na kojem je Debian Squeeze
2. Instalirao sam sve potrebno i upogonio tu "staru" verziju KOHA-e na novom serveru
- Squeeze sad ima gotovo sve Perl module u dostupne u paketima
- putem CPAN-a sam instalirao samo NET::Z3950::ZOOM jer Debian paket ima neke konflikte u dependency-ima
3. gotovo sve je proradilo iz druge - bilo je naravno nekih tipfelera u apache konfiguraciji :)
4. tada sam povukao promjene iz gita, napravio rebase i mergao to u svoj branch
5. nakon toga sam napravio postupak upgrade-a kako je opisano u INSTALL.debian
6. vecina stvari je proradila ok, potrebno je u administraciji pokrenuti upgrade baze
7. LDAP nije proradio.. imam neki cudan problem i morao sam mijenjati lib/C4/Auth_with_ldap.pl
120c121
< my $res = $db->bind( $principal_name, password => $password );
---
my $res = $db->bind( "uid=$principal_name,dc=irb,dc=hr", password => $password );
- i u koha-conf.xml sam kod ldap konfigracije morao staviti:
<update>0</update>
Sad to radi, buduci da nije danas bilo promjena u bazi, zaswitchat cu samo IP adrese servera, promijeniti hostname i valjda ce biti ok :)
contributed by alen.vodopijevec on Jan 6 6:22am