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.
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
Et on installe Koha :
$ sudo aptitude install koha-common
$ sudo a2enmod rewrite $ sudo a2enmod cgi $ sudo apachectl graceful
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]
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.
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
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.
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 !
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]
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
Cette partie correspond à un test que j'ai réalisé.
Marc21
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.