====== Koha ====== ===== Informations générales ===== Koha est un [[wpfr>SIGB|SIGB]] [[wpfr>Logiciel_libre|libre]]. * Site officiel : http://koha-community.org/ * Wiki : http://wiki.koha-community.org/ * Le manuel : http://translate.koha-community.org/manual/master/en/html-desktop/ * Communauté francophone : http://koha-fr.org/ ===== 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 === {{:informatique:scinf:selection_064.png?direct&450|}}{{:informatique:scinf:selection_065.png?direct&450|}}{{:informatique:scinf:selection_066.png?direct&450|}}{{:informatique:scinf:selection_067.png?direct&450|}} 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'; {{:informatique:scinf:selection_068.png?direct&450|}}{{:informatique:scinf:selection_069.png?direct&450|}} {{:informatique:scinf:selection_070.png?direct&450|}}{{:informatique:scinf:selection_071.png?direct&450|}} 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 ! {{:informatique:scinf:koha-installer-settings.png?direct&450|}}{{:informatique:scinf:koha-installer-added.png?direct&450|}} ===== 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 ==== - 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. - Création d'un site (possible d'attribuer une URL et un range d'IP). - Type de documents : - Livre - Revue - Livre électronique - CD - DVD - 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"). - 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...)