Outils pour utilisateurs

Outils du site


informatique:scinf:koha

Koha

Informations générales

Installation

Documentation utilisée : http://wiki.koha-community.org/wiki/Debian

L'installation est réalisée sous Debian 8 (Jessie), via les packages prévus.

Prérequis

  • Apache
  • MySQL/MariaDB
  • Perl

Mise en place du dépôt

D'abord le téléchargement de la clé et son ajout :

 $ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Puis, on ajoute le dépôt qui nous intéresse, par exemple en créant le fichier /etc/apt/sources.list.d/koha.list et en y écrivant l'URL du dépôt : deb http://debian.koha-community.org/koha [version] main.

Il faut remplacer [version] par la version choisie : oldstable, stable, unstable. Ici, c'est la version stable qui est utilisée.

La documentation officielle propose la commande suivante :

 $ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Mais on peut aussi le faire avec son éditeur préféré :

 $ sudo vim /etc/apt/sources.list.d/koha.list

Et on y colle le deb http://debian.koha-community.org/koha stable main

Puis, on rafraîchit la liste des paquets :

 $ sudo aptitude update

Installation de Koha

Et on installe Koha :

 $ sudo aptitude install koha-common

Activation des modules pour Apache

 $ sudo a2enmod rewrite
 $ sudo a2enmod cgi
 $ sudo apachectl graceful

Création de la DB

Il y a deux cas de figure : 1) le serveur MySQL est en local, 2) il est distant. Dans le deuxième cas : http://wiki.koha-community.org/wiki/Debian#Create_a_Koha_instance , deuxième partie.

Sinon :

 $ sudo koha-create --create-db [libraryname]

Locale en français

Pour avoir la liste des langues disponibles :

 $ sudo koha-translate --list --available

Pour installer une langue désirée :

 $ sudo koha-translate --install [language-code]

Il est bien entendu possible d'installer plusieurs langues, j'ai fait le test avec ``fr-FR``, ``en-GB`` (par défaut), ``de-CH`` et ``it-IT``. Par contre, il semble que la commande n'installe qu'un code à la fois. Une fois le code installé, on le trouve directement dans les préférences systèmes.

Atteindre l'interface admin

Pour la suite de l'installation, il s'agit de se rendre sur une URL en [libraryname]-infra.domain.tld. Se pose donc le problème d'une installation en localhost. Une solution est de configurer le /etc/hosts :

 127.0.0.1	localhost [libraryname]-intra.localhost [libraryname].localhost

Il est également nécessaire de modifier le fichier /etc/apache2/site-available/[libraryname].conf.

Pour l'OPAC :

 ServerName [libraryname].localhost

et pour l'Intranet :

 ServerName [libraryname]-intra.localhost

Ne pas oublier de redémarrer apache : $ sudo apachectl graceful.

Je ne sais pas si c'est la bonne méthode, mais ça marche.

Reste à trouver l'identifiant de connexion dans le fichier /etc/koha/sites/[libaryname]/koha-conf.xml, par exemple avec les commandes suivantes :

 $ sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/[libraryname]/koha-conf.xml

et

 $ sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/[libraryname]/koha-conf.xml

Terminer l'installation

Avec ces informations, se connecter sur http://[libaryname]-intra.domain.tld (par exemple localhost).

Si à la connexion on ne peut pas choisir la langue, voir le point précédent. Puis, à chaque étape, il faut se reconnecter pour la suite.

Captures d'écran

Il faut donner les droits sur la DB à l'utilisateur koha_[libraryname] :

 $ sudo mysql -u root -p
 > GRANT ALL ON [db-name].* TO 'koha_[libraryname]'@'localhost';

Lors de la dernière partie de l'installation, il s'agit de choisir le format de métadonnées : unimarc ou marc21.

Pour l'étape suivante, il est nécessaire de faire attention que toutes les données nécessaires soient sélectionnées. Il m'est arrivé de faire l'installation sans avoir coché les permissions, ce qui empêche ensuite d'attribuer des permissions aux usagers !

Réinstallation

Lors du paramétrage, au moment de définir les permissions pour les bibliothécaires, un problème est apparu : impossible de le faire, aucune permission ne s'affiche. Après quelques investigations, aidés par des personnes sur le canal IRC et la mailing list, il s'avère que les tables de la DB concernant les permissions des utilisateurs sont vides. Quelque chose s'est mal passé à l'installation.

Je décide de recommencer :

$ sudo koha-remove [library]
sudo koha-create --create-db [library]
Koha instance is empty, no staff user created.
Starting Zebra server for [library]

Commandes terminal

En installant les paquets pour koha, un certain nombre de commandes deviennent disponibles depuis le terminal :

koha-create
koha-create-dirs
koha-disable
koha-dump
koha-dump-defaults
koha-email-disable
koha-email-enable
koha-enable
koha-enable-sip
koha-foreach
koha-indexer
koha-list
koha-mysql
koha-post-install-setup
koha-rebuild-zebra
koha-remove
koha-reset-passwd
koha-restart-zebra
koha-restore
koha-start-sip
koha-translate

Paramétrage

Cette partie correspond à un test que j'ai réalisé.

Marc21

Langue de l'interface

 Home › Administration › System preferences > i18n/l10n

Une fois que l'on a choisi le français, ``i18n/l10n`` devient ``internationalisation``

Il est possible de paramétrer différemment les langues de l'intranet (interface admin) et de l'OPAC.

Suite

  1. D'abord, création des groupes. Il y a deux types de groupe : search domain (domaine de recherche) et properties (propriétés). De ce que j'ai compris, le premier est censé permettre de chercher dans un domaine particulier (chimie, biologie, etc.), tandis que le seconds permet de regrouper les bibliothèques par type de bibliothèque (patrimoniale, lecture publique, universitaire, etc.). Mais il semble que le second n'est pas utilisé par le logiciel, tandis que le premier permet, depuis l'OPAC, de faire une recherche dans un domaine précis.
  2. Création d'un site (possible d'attribuer une URL et un range d'IP).
  3. Type de documents :
    1. Livre
    2. Revue
    3. Livre électronique
    4. CD
    5. DVD
  4. Catégorie d'utilisateurs : permet de configurer notamment le type de confidentialité, à savoir l'historique d'emprunt (“Contrôle la durée de conservation de l'historique de prêt pour les nouveaux adhérents de cette catégorie. “Jamais” anonymise les prêts au moment du retour, et “Jamais” conserve l'historique de prêt d'un adhérent définitivement.Lorsque c'est fixé à “Par défaut”, la durée de conservation de l'historique est contrôlé par le cronjobbatch_anonymise.pl qui devrait être configuré par votre administrateur”).
  5. Création d'un “adhérant” de type “bibliothécaire”. Difficulté : sur l'écran plus > définir les permission, je n'ai qu'un bouton “enregistrer”, rien d'autre. Discussion sur l'irc (koha-fr), pas vraiment de réponse pour l'instant, sauf à dire qu'il faut utiliser une version stable… - puis une conversation sur l'irc en anglais, mveron me répond, on avance un peu…)
informatique/scinf/koha.txt · Dernière modification: 2018/07/29 09:08 (modification externe)