Koha v.3.0 alpha- notes d’install

1.Pré-requis
1.1 Linux Debian
On a utilisé un PC sur lequel on a installé une Linux Debian “Etch” 4.0. Minimale, c’est-à-dire juste le CD de base, et le reste qui se récupère par internet à l’installation: je ne connaissais pas, c’est pratique.
Là-dedans, quelques prérequis: Apache, MySQL, GCC, daemon.

1.2 UTF-8
Koha 3 fonctionne en UTF-8 d’un bout à l’autre.
Cf http://wiki.koha.org/doku.php?id=encodingscratchpad.
Il faut que le système d’exploitation, Apache, et MySQL soient tous par défaut en utf-8.
Pour Apache, il faut éventuellement ajouter ces lignes dans le fichier /etc/apache2/apache2.conf

AddCharset UTF-8
AddDefaultCharset UTF-8


Pour MySQL, il faut si nécessaire éditer le fichier my.cnf de mysql pour passer tous les latin-1 en utf-8.

Sur ce point, à nouveau, voir
http://wiki.koha.org/doku.php?id=encodingscratchpad.

1.3 Git, Yaz et Zebra

Editer votre fichier /etc/apt/sources.list et ajouter:

# Index Data
deb http://ftp.indexdata.dk/debian etch main
deb-src http://ftp.indexdata.dk/debian etch main
# Backports
deb http://www.backports.org/debian etch-backports main contrib non-free


Vous indiquez à votre système où aller chercher les packages dont il a besoin pour installer Yaz (serveur Z3950) et Zebra (Moteur d’indexation) de chez IndexData, et Git, le gestionnaire de versions utilisé par Koha. Je conseillerais d’installer Git, pour pouvoir bénéficier des patches, mais ce n’est pas obligatoire.

Ces deux sources ont besoin d’une clé, qu’il faut installer:

# la clé pour backports
$ sudo apt-get install debian-backports-keyring
# la clé pour IndexData
$ wget http://ftp.indexdata.dk/debian/indexdata.asc
$ sudo apt-key add indexdata.asc


Il faut ensuite mettre à jour le système, installer Git, Yaz et Zebra


$ sudo apt-get update
$ sudo apt-get -t etch-backports install git-core git-email
$ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc


Maintenant on peut passer à Koha, même si on n’en a pas tout à fait fini avec les dépendances

1.4 Récupérer Koha

1.4.1 Option A: Koha via Git
C’est l’option que je recommanderais, pour avoir les derniers packages.

$ git clone git://git.koha.org/pub/scm/koha.git kohaclone
$ cd kohaclone
$ git checkout -b myinstall origin


Note. Pour plus d’infos sur Git, voir le Koha Git Usage Guide:
http://wiki.koha.org/doku.php?id=en:development:git_usage.

1.4.2 Option B: Récupérer Koha à http://download.koha.org

$ wget http://download.koha.org/koha-3.00.00-alpha.tar.gz


Attention, si vous prenez les partitionnements par défaut de Debian, le répertoire / dans lequel vous aller récupérer le tar.gz et le dézipper sera trop petit pour y faire l’install. Il faut déménager le code source ailleurs: /home/koha, par ex., si vous avez créé un utilisateur koha sur le système.

1.5 Installer les dépendances qui manquent
Le code source de Koha propose sous install_misc/ un fichier qui contient une liste des dépendances de koha. On peut ajouter les programmes de cette liste à la sélection:

$ sudo dpkg --set-selections < install_misc/debian.packages


Puis installer:

$ sudo dselect


Le programme propose une liste de choix, qu'il faut suivre jusqu'au bout à partir de [I]nstall et jusqu'à la fin de la liste : [C]onfigure, [R]emove et [Q]uit.

1.6 Il reste quelques dépendances Perl qui ne sont pas disponibles dans les fichiers Debian standard et qu'il faut aller chercher directement sur cpan. La commande suivante installe tout d'un coup, y compris les éventuelles dépendances nécessaires à chacun des modules de la liste.

$ sudo cpan MARC::Record Class::Accessor MARC::Charset MARC::File::XML Net::Z3950::ZOOM HTML::Template::Pro MARC::Crosswalk::DublinCore PDF::Reuse PDF::Reuse::Barcode Data::ICal GD::Barcode::UPCE XML::RSS Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle POE Schedule::At


Note: si c'est la première fois que vous utilisez cpan, le système vous posera quelques questions concernant le paramétrage de cpan avant de procéder à l'installation proprement dite.

Note 2: il est possible que certains modules ne réussissent pas les tests d'installation pour des raisons diverses. Par exemple, Net::Z3950::ZOOM fait des tests de communication avec l'extérieur, et les tests peuvent échouer du fait d'un firewall ou quelque chose comme ça. Si les tests échouent le module Perl ne s'installe pas. Il faut alors l'installer en "forçant":

$ cpan
cpan> force install Mon::Module::Perl


2. Configuration des dépendances

2.1 mettre à jour le mot de passe root pour mysql

$ sudo mysqladmin password

2.2 Créer une base de données koha, avec un utilisateur koha, ayant tous privilèges sur la base koha

$ mysqladmin -uroot -p <password> create database <kohadatabasename>
$ mysql -uroot -p <password>
mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
mysql> flush privileges;
mysql> quit


Perso, je fais la même chose via phpmyadmin. Si phpmyadmin n'est pas installé sur votre machine:

$ apt-get install phpmyadmin


2.3 Tester le Parser XML SAX
Koha utilise SAX. Pas Expat ni PurePerl. Koha propose un fichier qui teste votre installation:

$ cd koha
$ misc/sax_parser_print.pl


Ce qui doit vous donner qq chose comme ça: XML::LibXML::SAX::Parser=HASH(0x81fe220)
Si à la place de SAX vous voyez PurePerl ou Expat, il faut éditer le fichier /etc/perl/XML/SAX/ParserDetails.ini pour ne laisser que:

[XML::LibXML::SAX::Parser]
http://xml.org/sax/features/namespaces = 1


2.4 Installer DBD::mysql
Ce module Perl a toute une batterie de tests pour lesquels il a besoin d'une base de données de test. Le document INSTALL.debian recommande toute la procédure de tests. C'est la galère. Ma suggestion:

$ cpan
cpan> force install DBD::mysql


3. Maintenant, on peut enfin passer à Koha proprement dit

$ perl Makefile.PL
# répondre aux questions
$ make
$ make test


Ici plein de tests, dont certains peuvent échouer; en particulier j'ai eu l'impression qu'il faisait des tests sur certaines tables de la base de données... qui n'est pas encore créée (?). Par ailleurs, si certains modules Perl se sont mal installé aux étapes précédentes, vous allez le voir ici, et on peut récupérer le truc en faisant un nouveau

$ sudo cpan Mon::Module::Perl


Après quoi on peut recommencer et cette fois aller au bout:

$ perl Makefile.PL
# répondre aux questions
$ make
$ make test
$ sudo make install


A la fin du make install, un message vous dira de définir deux variables d'environnement; vous pouvez le faire avec la commande export, mais si vous voulez qu'elles soient dans l'environnement au démarrage quand on se logge sur la machine, il faut les inscrire dans le fichier .bashrc de chaque utilisateur, par ex. sous /root et /home/koha si vous avez un utilisateur koha. Les lignes à ajouter dans ces fichiers sont:

# export params conf koha
export KOHA_CONF=/etc/koha/koha-conf.xml
export PERL5LIB=/usr/share/koha/lib


4. Configurer et démarrer Apache

$ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha


Ajouter dans /etc/apache2/ports.conf:

Listen 80
Listen 8080


Puis lancer les commandes:

$ sudo a2enmod rewrite
$ sudo a2ensite koha
$ sudo apache2ctl restart


5. Configurer et démarrer Zebra

Zebra et zebraqueue sont démarré en daemon dans le script de démarrage. $SCRIPT_DIR correspond au répertoire des scripts de koha, typiquement /usr/share/koha/bin.

Zebra:

$ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
$ sudo update-rc.d koha-zebra-daemon defaults
$ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start


Zebraqueue:

$ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
$ sudo update-rc.d koha-zebraqueue-daemon defaults
$ sudo ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start


6. Utilisez l'installeur web en pointant votre navigateur sur http://<servername>:8080/
Note: ne vous précipitez pas sur le choix en français: il y a un petit bug dans la version alpha que j'ai utilisé, il ne trouve pas les fichiers sql pour peupler la base dans les répertoires français; utiliser le web installer en anglais, ça marche et vous pourrez basculer l'interface en anglais ensuite.

7. Ensuite?
7.1 Import:

$ misc/migration-tools/bulkmarcimport.pl -file /chemin/de/mon/fichier/marc.iso2709


7.2 Indexation rapide (Fast Index):

$ misc/migration-tools/rebuild_zebra.pl -b -w


Une fois l'indexation achevée, vous allez pouvoir chercher des notices dans le catalogue. Note: si vous n'utilisez pas l'utilitaire Fast Index et que vous avez un daemon zebraqueue qui tourne, ça va indexer en arrière fond, mais lentement.

Je crois que c'est tout. Notes complémentaires et corrections bienvenues en commentaire. Merci à Hamid Makkasse pour la comparaison de notes, et Th.Cl., H.S. et M.M. pour leur contribution.