Introduction au processus d’installation de Koha

Ceci est le manuel d’installation de Koha pour la version 17.11.

Le processus d’installation du système de gestion de bibliothèque Koka utilise les deux outils suivants :

  • Installateur Web
  • Outil d’intégration

Cette documentation décrira ces deux outils.

Qu’est-ce que l’installateur Web de Koha?

L’installateur Web crée les tables de la base de données dans lesquelles sont stockées toutes les données avec lesquelles vous travaillez dans Koha, comme les bibliothèques, les usagers et les exemplaires.

L’installation Web débute avec un écran de connexion où vous pourrez entrer les informations de votre compte d’administrateur de base de données.

L’installateur créera ensuite les tables et y ajoutera des données. La prochaine étape du processus sera de définir des paramètres de base obligatoire via l’outil d’intégration.

Qu’est-ce que l’outil d’intégration de Koha?

L’outil d’intégration s’assure que vous avez au moins une bibliothèque, une catégorie d’utilisateurs, un utilisateur, un type de document et une règle de circulation dans votre système avant de commencer.

Si vous avez installé un échantillon de données pour les bibliothèques, catégories d’utilisateurs et/ou types de document, l’outil d’intégration ne vous présentera pas de formulaire pour les créer.

Par contre, vous devrez tout de même créer un utilisateur (pour se connecter à l’interface professionnelle à la fin du processus d’installation) et une règle de circulation.

Installateur Web

Connexion à l’installateur Web

Connexion à l’installateur Web

Cet écran de connexion est le premier à apparaître lors de l’installation de Koha.

image1152

Connexion à l’installateur Web

  1. Koha version name: This will display whatever Koha version number you are installing.
  2. Username: This is database administrator username which is koha_kohadev by default.
  3. Password: This is the database administrator password which is password by default.
  4. Log in: Select this button to login

Sélecteur de langue

Écran de démarrage de l’installeur

Ceci est le premier écran de l’installeur Web.

image1166

Écran de démarrage de l’installeur Web

  1. Language picker dropdown box: This is specifying the language you want Koha to be in.

Note

L’installation de langues supplémentaires pour l’installateur (DE ou FR, par exemple) permettra d’utiliser ces langues dans l’installateur Web.

  1. Cliquez le bouton Passer à la prochaine étape pour afficher le prochain écran de l’installateur Web.

Les modules Perl de l’installateur installés

Cet écran vous indique que l’installateur a toutes les dépendances requises pour créer la base de donnée dans le prochain écran.

image1167

Modules Perl installés

Cliquez le bouton Passer à la prochaine étape pour afficher le prochain écran de l’installateur Web.

Paramètres de la base de données

Cet écran vous indique les paramètres de la base de données et vous demande de les confirmer en cliquant sur le bouton Passer à la prochaine étape.

Note

For the majority of users these settings should be correct, if not then you should contact your support provider.

image1168

Paramètres de la base de données

  1. Database Settings: Check these database settings are correct.
  2. Cliquez sur le bouton Passer à l’étape suivante pour confirmer les paramètres de la base de données.

Connexion établie

After you click the Next button the database connection is confirmed:

image1169

Connexion à la base de données établie

  1. Message Connexion établie : Ce message vous informe que la base de données a bien été créée.
  2. Cliquez le bouton Passer à la prochaine étape pour afficher le prochain écran

Note

Si vous éprouvez des difficultés à établir une connexion avec la base de données, l’installateur ne pourra pas continuer. Vérifiez les informations de connexion dans le fichier de configuration koha-conf.xml, et assurez-vous que les permissions et les identifiants dans la base de données sont exacts.

Prêt à insérer des données dans les tables

Cet écran vous indique que tout est prêt pour la création des tables de la base de données, au prochain écran.

image1170

Base de données prête pour les données

Cliquez le bouton Passer à la prochaine étape pour afficher le prochain écran

Note

Cette étape peut prendre du temps. Veuillez patienter.

Tables de la base de données créées

image1171

Tables de la base de données créées

Cliquez sur le bouton Passer à l’étape suivante

Prêt pour les configurations de base

This screen leads onto installing basic configurations necessary to use Koha.

image1172

Prêt pour les configurations de base

Cliquez sur le bouton Passer à l’étape suivante

Sélectionner le format MARC

You must choose your MARC flavour (format you want the bibliographic (catalog) records to be stored in the database) on this screen:

image1173

Sélectionner le format MARC

  1. Unimarc: This is frequently used in European countries (except for the UK) such as Italy.
  2. MARC21: Selected by default, as it is more commonly used globally than UNIMARC.
  3. Cliquez le bouton Passer à la prochaine étape pour confirmer vos choix.

Paramétrage MARC21 et UNIMARC

Note

Dans l’écran précédent, vous avez choisit soit MARC21 ou UNIMARC comme version MARC. Cette page présente les deux options.

Paramétrage MARC21

image1174

Paramétrage MARC21

  1. Types d’autorités par défaut du standard MARC21 : Un type d’autorité est un modèle de notice d’autorité (stocke les champs de recherche pour la recherche dans un catalogue d’institution). Cette option installera un échantillon de types d’autorités.
  2. Default MARC21 bibliographic framework: Following on from the MARC21 selection in the previous screen selecting this checkbox (and the Import button) will actually setup the MARC21 bibliographic framework as the desired MARC flavour.
  3. Règles de concordance sélectionnées pour les notices bibliographiques MARC21 : Les règles de concordance MARC21 sont utilisées pour trouver toutes les informations sur des notices bibliographiques spécifiques en utilisant les champs de recherche des types d’autorités.
  4. « FA » (pour « Fast Add »), une grille bibliographique MARC21 minimaliste, adaptée aux PEB ou pour le catalogage à la volée : La grille bibliographique MARC FA affiche moins de champs et permet un catalogage à la volée plus rapide. Cochez cette case pour installer cette grille minimaliste.
  5. Sample MARC21 bibliographic frameworks for some common types of bibliographic material: This installs the template you will use to create items.
  6. Default Koha system authorised values: This installs mandatory authorised values that every Koha installation needs.
  7. Default classification sources and filling rules: This will insert several common library classification sources such as dewey decimal.
  8. Defines default message transports for email and sms: This provides the option to the user of being able to change how the library contacts them. They can choose from the following: email address, printed message, sms, or phone call. Notices will not work without these.
  9. Patron attributes: This does not install any data, and it needs to be removed.
  10. Sample frequencies for subscriptions: For items that arrive on a regular and predictable basis (e.g. monthly magazines), installing sample frequencies is useful because you can simply select a pre-installed sample frequency when you create the item.
  11. Sample notices: This inserts sample notices into the database, meaning all you have to do is customize these sample notices before you use them. Creating these by hand can be very time consuming and error prone.
  12. Defines default messages for the enhanced messaging configuration: The enhanced messaging configuration lets the user choose what messages they receive from the institution. Selecting this will insert sample message types for the Due, Predue, and Advance notice message types.
  13. Defines default message transports for sending item due messages and advance notice messages through email and SMS: This inserts the SMS and email transport types. Mandatory if you want to send notices by email or SMS.
  14. Échantillon de modèles de numérotation pour les abonnements aux périodiques : Cette option installera un échantillon de modèles de numérotation de magazines et d’autres périodiques afin de vous éviter de les saisir manuellement.
  15. Valeurs autorisées de base pour les localisations, statuts « perdu », etc. Vous pourrez changer ces valeurs après l’installation : Cette option installe des valeurs autorisées, qui permettent de contrôler la saisie, afin de s’assurer qu’elles répondent à certains critères avant qu’une bibliothèque ou un autre objet ne soit créé.
  16. Modèles CSV : Vous pouvez exporter des données avec Koha. Les modèles CSV vous permettent de définir le format de l’exportation. Les exportations CSV ou tabulée ne fonctionneront pas sans ceux-ci.
  17. Valeurs codées conformes à la norme Z39.71-2006 *holdings statements for bibliographic items* : Ceci n’est pas nécessaire au fonctionnement de Koha. Une mention de fonds indique à un usager si la bibliothèque a un exemplaire spécifique et où celui-ci se trouve. Un échantillon de valeurs codées pour les exemplaires dans les mentions de fonds sera installé si cette case est cochée.
  18. MARC code list for relators: Not required to use Koha. A relator is a person who was involved in the development of the item (e.g. author). Selecting this will insert sample relator records into the database.
  19. Devises de base pour le module ACQ, avec le dollar américain comme défaut : Cette option permet d’installer le dollar américain, la livre britannique, le dollar canadien et l’euro comme devises. Cette option paramètre également le dollar américain comme devise d’acquisition par défaut. Si vous choisissez de ne pas installer ces devises de base, vous devrez manuellement définir une devise pour pouvoir utiliser le module d’Acquisitions.
  20. Useful patron attribute types: Not required to use Koha. Patrons have a barcode which identifies them. By clicking this checkbox you are making sure that this patron barcode is displayed on the patron summary screen.
  21. Échantillon de type d’utilisateurs et de catégories : Ceci n’est pas nécessaire au fonctionnement de Koha. Cocher cette case permet d’ajouter un échantillon de catégories d’utilisateurs dans la base de données. Cela fera en sorte que l’outil d’intégration passera l’étape de création de catégories d’utilisateurs.
  22. Échantillon de données pour les étiquettes et les cartes d’usagers : Ceci n’est pas nécessaire au fonctionnement de Koha, mais est recommandé pour la plupart des nouvelles installations. Cocher cette case permet d’ajouter un échantillon de données pour les étiquettes et les cartes d’usagers et facilitera la création d’étiquettes et de cartes d’usagers plus tard.
  23. Sample holidays: Sunday, Christmas, New Year’s Not required to use Koha. Selecting this will insert sample repeatable public holidays (e.g. Christmas) into the database.
  24. ** Un ensemble de types de documents par défaut: ** Non requis pour Koha. En sélectionnant cette option, vous insérerez des exemples de type de document dans la base de données, ce qui signifie que l’étape Créer un type de document dans l’outil de configuration sera ignorée
  25. ** Exemples de bibliothèques: ** Non requis pour Koha. En sélectionnant cette option, vous insérerez des exemples de bibliothèques dans la base de données. Les développeurs le veulent souvent à des fins de démonstration ou de développement. Si vous sélectionnez cette option, l’étape Créer une bibliothèque dans l’outil de configuration sera ignorée.
  26. ** Exemples de nouveaux documents: ** Non requis pour Koha. En sélectionnant cette option, vous insérerez des exemples de nouveaux documents dans la base de données qui seront affichés à l’OPAC (Online Public Access Catalog) et à l’interface professionnelle.
  27. Sample patrons: Not required for Koha. Patrons are the people who use the Koha Library Management System, for example: library users and staff. Selecting this will insert a number of sample patrons into the database. Developers will often want this for demo or development purposes.
  28. Sample quotes: Not required for Koha. Quotes of the day can be displayed to library users on the OPAC (Online Public Access Catalog) interface. Selecting this will install a few library related sample quotes.
  29. Allow access to the following servers to search and download record information: Not required to use Koha, but recommended for most new installs. Selecting this configures Koha to allow access to a selection of Z39.50 targets, which allow searching the target servers for MARC21 records to import them into your Koha instance. This can avoid the need to manually input all record information manually, or greatly speed up the process.
  30. Cliquer sur le bouton Importer afin d’installer les données par défaut et celles qui ont été sélectionnées.

Configuration unimarc

Il n’y a que deux valeurs de données unique à UNIMARC dans le paramétrage avancé :

  • Structure d’autoritées pour UNIMARC en anglais
  • Grille bibliographique UNIMARC par défaut en anglais

Note

Les valeurs optionnelles sont les mêmes pour UNIMARC et MARC21, leurs définitions ne seront pas répétées ici.

image1175

Configuration unimarc

  1. Structure d’autorités pour UNIMARC en anglais : Les notices d’autorités stockent des termes de recherche utilisés pour trouver des exemplaires dans la base de données. Contrairement au MARC21, si on utilise UNIMARC, la structure d’autorité doit être compatible avec UNIMARC. Cocher cette case permet de rendre la structure compatible.
  2. Grille bibliographique UNIMARC par défaut en anglais : Dans l’écran précédent, vous avez choisi d’utiliser UNIMARC. En sélectionnant cette option, vous confirmez que vous voulez utiliser cette grille.
  3. Cliquez le bouton Importation pour installer les échantillons de données.

Les données sélectionnées ont été ajoutées

After you have clicked the Import button in either the MARC21 or UNIMARC setup screen this screen will appear. It shows you if the selected/default data values were successfully inserted into the database.

image1176

Les données sélectionnées ont été ajoutées

  1. Optional data added: If you selected an optional data value then it will be displayed here. If you did not choose any optional data value then the optional data added title will not be displayed.
  2. Mysql data added: These data values will always be installed and consequently displayed on this screen.
  3. Données obligatoires ajoutées : Même remarque que précédemment.
  4. Installation message: Tells you if the Koha database was successfully created ready for you to use the onboarding tool.
  5. Click the Set up some of Koha’s basic requirements button to go to a redirection screen, which in turn will take you to the onboarding tool.

Redirige vers l’outil de configuration

If you wait for around 10 seconds this screen should redirect you to the onboarding tool start screen.

image1177

Redirige vers l’outil de configuration

Note

Si vous n’êtes pas automatiquement redirigé après la période d’attente, cliquez sur le lien indiqué par la flèche dans la capture d’écran ci-dessus.

Outil d’intégration

Créer une bibliothèque

L’installateur demandera de créer une première bibliothèque ou succursale si l’échantillon de bibliothèques n’a pas été installé.

Dans Koha, une bibliothèque est une représentation numérique d’un endroit « physique ». Plus de bibliothèques peuvent être ajoutées plus tard en allant dans Administration -> Sites et groupes.

image1153

Créer une bibliothèque

  1. Code de la bibliothèque : code d’un maximum de 10 lettres
  2. Nom : Le nom officiel ou commun de la bibliothèque.
  3. Create more libraries: If more libraries are required, or changes need to be made to this freshly created library, go to Administration->Libraries and groups
  4. Cliquez sur le bouton Valider pour créer un site.

Par exemple :

image1154

Créer un exemple de site

Library code: The regular expression that filters the acceptable inputs for library code only accepts up to 10 letters.

Créer une catégorie d’adhérent

All patrons in Koha must have a patron category. The patron category is like a jelly mold; multiple individual patron accounts can share common characteristics, such as circulation rules, notice frequency, holds allowed, and much more. Koha requires at least one patron category in order to add patrons.

Une catégorie d’adhérent est requise :

  • Code catégorie
  • Description
  • Message de retard demandé
  • Type de catégorie
  • Vie privée par défaut
  • Durée d’inscription : En mois OU jusqu’au

image1155

Créer une catégorie d’adhérent

  1. Library creation message: Indicates whether the library was created successfully.
  2. Code de catégorie : Code d’un maximum de 10 lettres.
  3. Description : Une phrase décrivant cette catégorie d’utilisateurs.
  4. Menu déroulant Message de retard requis : « Non » est sélectionné par défaut. Ceci indique si vous voulez que ces usagers recoivent des avis de retard.
  5. Type de catégorie : Ceci fait en sorte que la catégorie est applicable au personnel.
  6. Vie privée par défaut : La valeur « Par défaut » est sélectionnée par défaut. La vie privée par défaut contrôle la durée de conservation de l’historique de lecture d’un usager.
  7. Enrolment period-In months: This is the number of months that the patrons created from this patron category are enrolled for.
  8. Enrolment period-Until date: Select a date from the interactive datepicker calendar icon which appears when you click on this input box. The date you choose will be the enrolment end date for patrons created from this patron category.
  9. Path to create patron category: More patron categories can be created or altered by going to Administration -> Patron categories.
  10. Click the Submit button to create the patron category.

Par exemple :

image1156

Créer un adhérent

A superlibrarian patron user is required to log into the Koha staff interface, once the onboarding process has been completed.

Note

It is very important to document the username and password created here as they are the account credentials required to login as an administrator (superlibrarian) of Koha.

You will need to input/select:

  • Nom de famille

  • Prénom

  • Numéro de carte

  • Site

  • Catégorie utilisateur

  • Identifiant

  • Mot de passe

    image1157

    Créer un adhérent

  1. Message création catégorie d’adhérents : Indique si la catégorie d’adhérents a bien été créée.
  2. Surname: Surname, or something descriptive
  3. First name: First name, or something descriptive
  4. Card Number: This number must be unique
  5. Library dropdown box: If a library has been created using this onboarding tool, it will be the only option. Otherwise select a random library from the sample libraries installed by the web installer.
  6. Patron category dropdown box: If a patron category was created using this onboarding tool, it will be the only option. Otherwise select the Staff patron category.
  7. Superlibrarian permission: This non-editable setting allows access to all librarian and web based Koha administration tasks in the staff interface. This user is the most powerful user in any Koha, so protect the credentials well.
  8. Username: The username to log into the staff interface and OPAC (Online Patron Access Catalogue) with.
  9. Password: A password consisting of letters, numbers, and spaces only which is greater than 8 characters.
  10. Confirm password: Repeat the above password again
  11. Cliquer sur « Soumettre » pour créer le compte utilisateur.
  12. Path to create patron: Patron’s can be created or altered by going to Patrons->New patron
  13. Assign patron permissions: After creating a patron go More->Set permissions to assign permissions.

Par exemple :

image1158

Créer un exemple d’adhérent

Créer un type de document

If you did not install sample item types in the web installer then this screen will be displayed.

As with the patron category the item type is basically a template which you use to make multiple items with common characteristics.

You need to input:

  • Code du type de document

  • Description

    image1159

    Créer un type de document

  1. Message de création de compte administrateur : Indique si le compte administrateur a bien été créé.
  2. Item type code: Code consisting of up to 10 letters
  3. Description : Description du type d’exemplaire.
  4. Path to create item type: Item types can be created or altered by going to Administrator->Item types
  5. Cliquez sur Soumettre pour créer le type d’exemplaire.

Par exemple :

image1160

Crée un exemple de type d’exemplaire

Note

The regular expression filtering Item Type code input will only accept letters.

Créer une règle de circulation

This screen will always be displayed no matter what sample data you installed with the web installer.

Here you are creating a rule which applies the pre-defined organisational decisions of your library as to what restrictions you place on patrons borrowing items.

image1161

Create circulation rule

Note

Numbers are the only valid input for all input fields in this form.

  1. Message création de type d’exemplaire : Indique si le type d’exemplaire a bien été créé.
  2. Library branch dropdown box: This is the library (or libraries) you want to apply the circulation rule to. By default it is set to All, however you can select a singular library to apply the rule to from the dropdown box.
  3. Patron categories dropdown box: This is the patron categories you want to apply the circulation rule to. As with Library branch it is set to All by default but more options are avaliable.
  4. Item type dropdown box: This is the item types that you want the circulation rule to apply to. Again more options are avaliable than the default selected All option.
  5. Current checkouts allowed: This is the number of items allowed from the selected library, for selected patron categories and of the selected item type. Set to 50 by default.
  6. Loan period: Number of days or hours that an item is allowed out for. Set to 14 by default.
  7. Units dropdown box: Set by default to Days, the unit selecting in this field is applied to the numerical values written into Loan Period and Renewals Period
  8. Renewals Allowed: Number of times a item can be renewed. Set to 10 by default.
  9. Renewals Period: Number of days or hours that a renewal lasts for. Set to 14 by default.
  10. On shelf holds allowed dropdown box: If items can be held whilst they are on the shelf.
  11. Path to create circulation rule: Circulation rules can be created or altered by going to Administration -> Circulation and fines rules
  12. Click the Submit button to create the circulation rule.

Outil d’intégration complet

This page tells you if the circulation rule was created successfully, and that the Koha installation is complete

image1162
  1. Web installer message: Indicates if the web installation is complete
  2. Circulation rule creation message: Indicates if the circulation rule was created successfully.
  3. Start using Koha: Click to login to Koha using the Koha administrator account you created using the onboarding tool.

Login to access staff interface

You have now finished using the onboarding tool and can log into the staff interface using the patron account credentials you created in the onboarding tool

image1163

Écran de connexion

  1. Username: Enter the username you created for the patron
  2. Password: Enter the password you created
  3. Library: This is the library staff interface you want to log into. The options are either: My library or the library you installed/created. Leaving the default selected option of My library is fine to log in with first time.
  4. Click the Login button to access the staff interface

Par exemple :

image1164

Login example

Staff interface

The staff interface should now appear

image1165

Staff interface

Voir aussi

For more information about how to use the staff interface, please visit https://koha-community.org/documentation/