Provisionnement des disques durs de plusieurs serveurs Kolibri¶

Ce didacticiel est conçu pour vous accompagner dans la mise en place de Kolibri impliquant l’installation et le provisionnement de plusieurs appareils serveurs Kolibri avec les mêmes chaînes de contenu.

Le provisionnement de plusieurs serveurs en logiciels et en contenu va prendre un certain temps, quelle que soit la procédure choisie.

Vous aurez besoin d’une connexion Internet active uniquement pour précharger les chaînes de contenu sur le premier appareil serveur. Le provisionnement des autres serveurs peut être effectué hors ligne ou simplement au sein du réseau local.

Matériel requis¶

Des ordinateurs portables et/ou autres appareils pour héberger les serveurs Kolibri.
Pour le provisionnement, il est possible d’utiliser :
- De(s) support(s) de stockage externe(s) rapide(s) USB 3.0. L’USB 2.0 peut aussi fonctionner, mais nous recommandons l’usage de plus d’un support USB 3.0 pour obtenir des résultats plus rapides.
  
  OU
- Un réseau local opérationnel (il est préférable d’utiliser un câble plutôt que du sans fil, idéalement via un routeur supportant l’Ethernet Gigabit).
Une connexion Internet active pour télécharger l’installateur et précharger les chaînes de contenu sur le premier serveur ( dit « maître »).

Nous vous recommandons d’installer et de précharger les chaînes de contenu sur un serveur (appelé maître pour les besoins de cette procédure), puis de copier la structure de dossiers requise sur les autres appareils.

Bien qu’il soit plus rapide de copier les dossiers de contenu du disque dur du serveur maître vers d’autres dossiers au moyen d’un support USB 3.0, il est possible de copier les dossiers (du maître vers plusieurs autres serveurs en même temps) via le réseau local en parallèle. Si vous avez accès tant à une connexion câblée au réseau local et qu’à des supports externes USB, vous pouvez combiner ces deux options pour accélérer au maximum la procédure.

Provisionner le serveur maître¶

Installez Kolibri sur le serveur maître en suivant les étapes correspondant à la plateforme sélectionnée.
Procédez à la Configuration initiale de l’institut sur le serveur maître.
Importez le contenu souhaité pour le précharger sur le serveur maître.

Arborescence des dossiers Kolibri¶

À ce stade de la procédure, le serveur maître est configuré et préchargé avec du contenu. Avant de copier le contenu et la base de données sur les autres appareils serveurs, familiarisez-vous avec l’arborescence des dossiers Kolibri.

Sous Windows, la base de données du serveur principal et tous les fichiers liés au contenu sont stockés dans le dossier nommé .kolibri, situé dans C:/Users/<username>/.kolibri/ (si votre disque dur principal est C:).

<username> correspond au nom d’utilisateur sous lequel vous avez installé Kolibri tel qu’expliqué ci-dessus. Dans l’exemple ci-dessous, l’utilisateur ayant installé Kolibri se nomme IEUser.

Trouvez le dossier .kolibri sous Windows.
Avec Linux, le dossier .kolibri est situé dans votre répertoire utilisateur personnel.

Trouvez le dossier .kolibri sous Linux.

Le contenu du dossier .kolibri est le même pour toutes les plateformes. Vous y trouverez le fichier de base de données principal db.sqlite3, et le sous-dossier nommé content, qui renferme 2 sous-dossiers : databases, qui contient les bases de données spécifiques à chacune des chaînes de contenu importées dans Kolibri, et storage, qui regroupe tous les fichiers de contenu et les ressources.

Trouvez les bases de données et le dossier de contenu de la chaîne.

Préparer le dossier `.kolibri` afin de le copier¶

Avant de copier le dossier .kolibri du disque dur du serveur maître (qui contient déjà des chaînes de contenu), vers les autres appareils serveurs pour le déploiement, il est nécessaire de déprovisionner (c’est-à-dire vider) la base de données utilisateurs.

Avertissement

Ceci est une étape critique afin de s’assurer qu’un ID d’établissement (et un nom) unique est associé à chaque serveur de destination.

Ouvrez le Terminal sur Linux ou l’invite de commande sur Windows.
Arrêtez le serveur Kolibri avec la commande suivante
kolibri stop
Exécutez ensuite la commande pour vider la base de données utilisateurs.
kolibri manage deprovision
Vous devrez confirmer deux fois en saisissant yes et en appuyant sur la touche Entrée.

Copier le contenu sur d’autres appareils serveurs¶

Avertissement

Indépendamment de la procédure de copie que vous décidez d’utiliser, il est essentiel de procéder d’abord à l’installation de Kolibri sur chacun des appareils de destination, en suivant les mêmes étapes que pour le serveur maître, sans toutefois devoir effectuer la configuration initiale.
Après l’installation, il vous faudra arrêter Kolibri sur l’appareil de destination, avant de procéder à la copie du contenu.
- Sous Windows, faites un clic droit sur l’icône de Kolibri dans la barre des tâches (située généralement en bas à droite, près de l’horloge), et sélectionner Quitter. Vous serez invité à confirmer votre choix, suite à quoi Kolibri s’arrêtera.
Arrêtez Kolibri à partir des options de la barre des tâches.
- Sous Linux, exécutez kolibri stop ou sudo service kolibri stop (si vous avez installé Kolibri pour qu’il fonctionne comme service système).

Copier le contenu à l’aide d’un support externe USB¶

Copiez-collez le dossier .kolibri du disque dur du serveur maître au support externe USB.
Copiez-collez le dossier .kolibri du support externe USB au disque dur de l’appareil de destination.

Note

Sous Windows, il vous faudra copier le dossier .kolibri vers le dossier C:/Users/<username>/, où le <username> correspond au nom du compte sous lequel vous avez installé Kolibri sur l’appareil de destination (il peut être différent du compte sur le serveur maître). Sous Linux, copiez le dossier dans le répertoire personnel de l’utilisateur qui a installé Kolibri, ou qui est le propriétaire du service système Kolibri.

Avertissement

Un message d’alerte devrait apparaître pour indiquer qu’un dossier .kolibri existe déjà sur l’appareil de destination : sélectionnez l’option pour l’écraser.

Copier le contenu à l’aide d’une connexion câblée à un réseau local¶

Connectez tous les appareils, le serveur maître et les autres sur lesquels vous devez copier le contenu, au même réseau local (LAN).
Configurez les paramètres réseau du serveur maître pour que les autres appareils puissent :
- Le voir dans la liste des emplacements réseau de l’Explorateur Windows
- L’ouvrir et parcourir librement ses dossiers partagés (le dossier .kolibri doit être partagé)
Utilisez l’Explorateur Windows ou de fichiers sur chaque appareil de destination pour copier-coller le dossier » .kolibri » du disque dur du serveur maître au disque dur de l’appareil de destination.

Note

Sous Windows, il vous faudra copier le dossier .kolibri vers le dossier C:/Users/<username>/, où le <username> correspond au nom du compte sous lequel vous avez installé Kolibri sur l’appareil de destination (il peut être différent du compte sur le serveur maître). Sous Linux, copiez le dossier dans le répertoire personnel de l’utilisateur qui a installé Kolibri, ou qui est le propriétaire du service système Kolibri.

Avertissement

Un message d’alerte devrait apparaître pour indiquer qu’un dossier .kolibri existe déjà sur l’appareil de destination : sélectionnez l’option pour l’écraser.
Vous devriez pouvoir accéder au serveur maître à partir de plusieurs autres serveurs de destination via le réseau local, et y copier en même temps le dossier .kolibri.

Redémarrer les serveurs Kolibri sur les appareils de destination¶

Sous Windows, double-cliquez sur le raccourci du bureau pour démarrer Kolibri après avoir copié le contenu. Vous verrez s’afficher le message Kolibri démarre, veuillez patienter…. Une fois la notification suivante Kolibri est en cours d’exécution… apparue, Kolibri s’ouvrira dans le navigateur à l’URL http://127.0.0.1:8080.
Sous Linux, ouvrez le Terminal et lancez kolibri start ou sudo service kolibri start (si vous avez installé Kolibri pour qu’il s’exécute en tant que service système).

Puisque la commande de déprovision a vidé la base de données utilisateurs sur le serveur maître, vous devrez procéder à la Configuration initiale de chaque appareil de destination pour définir leur nom d”établissement et le compte super admin. Le nom d’établissement pourrait être le nom du centre d’apprentissage ou de l’école dans lequel le serveur respectif sera déployé.