Description v3

De Documentation e-comBox
La version 3 de l'e-comBox est disponible sur Linux et sur Windows 10 (Home compris) et la version sur MacOS sortira à l'automne.

L'application ne doit être installée que sur un seul poste (ou serveur), l'interface d'administration et les sites créés sont ensuite accessibles à distance via n'importe quelle machine.

Un setup facilitant cette installation est fourni pour Windows 10 et des scripts sont fournis pour les systèmes Linux (Debian et Ubuntu) et MacOS
L’application est livrée sous la licence CeCILL (Acronyme pour Ce(A)C(nrs)I(NRIA)L(ogiciel)L(ibre)) soumise au droit français et respectant les principes de diffusion des logiciels libres. Vous pouvez utiliser, modifier et/ou redistribuer ce programme sous les conditions de la licence CeCILL telle que diffusée par le CEA, le CNRS et l'INRIA sur le site https://www.cecill.info/

Une vidéo de présentation est disponible : https://www.reseaucerta.org/pgi/e-combox

Pour tout problème rencontré avec l’utilisation de la e-comBox ou son installation vous devez créer un compte sur le support dédié (http://llb.ac-corse.fr/ecomboxsupport/signup_page.php) et ajouter un nouveau ticket. Cela permet notament aux autres utilisateurs de la e-comBox d’avoir accès à la résolution des différents problèmes. Vous trouverez l’aide pour l’utilisation du support ici : http://llb.ac-corse.fr/mw/index.php/Contactez_le_support. Lors de la création de ce ticket, il faut y ajouter les logs qui nous aideront à comprendre les causes de l'incident. Pour savoir où sont stockés les logs, vous pouvez vous référer à la FAQ : http://llb.ac-corse.fr/mw/index.php/FAQ

Nouveautés de la version 3

L'e-comBox a fait peau neuve pour cette nouvelle version et toute l'interface a été rafraîchie.

Outre les diverses optimisations de fonctionnement, une des grandes nouveautés de l'e-comBox v3 est la possibilité de créer ses propres modèles sites. Il est désormais possible de créer un nouveau type de site pour ensuite créer une modèle à partir de ce dernier. Une fois le modèle créé, vous pourrez créer autant de sites que voulu via ce modèle.

Avec la v3 il est également possible de sauvegarder tous ses sites puis de les restaurer (via des scripts).

Fonctionnalités de l’e-comBox

MenuDetailleV3.png

L’application e-comBox est une application Web qui permet de lancer et gérer un certain nombre de sites basés sur les applications suivantes :

  • Prestashop :
    • une instance vierge,
    • une instance personnalisée (site Art Concept Stories) ;
  • WordPress avec WooCommerce :
    • une instance vierge,
    • une instance personnalisée (site Art Concept Stories) ;
  • WordPress sans WooCommerce, mais avec le add-in H5P ;
  • Mautic ;
  • Suite CRM ;
  • Odoo :
    • versions 12, 13 et 14 ;
    • deux instances personnalisées : primeur et surplomb ;
  • Kanboard (gestion de projet) ;
  • HumHub (réseau social).

La gestion de base permet de :

  • lister les types de sites (Wordpress, prestashop, etc.) à partir desquels il est possible de créer un ou plusieurs sites ;
  • créer, démarrer, arrêter ou supprimer un site ;
  • lister les sites créés (avec l’état pour chacun et son URL d’accès au backoffice) ;
  • créer un modèle à partir d'un site créé et personnalisé.

La gestion avancée permet l’accès :

  • SFTP aux sites Prestashop et Wordpress ;
  • via phpMyAdmin aux bases de données des sites Prestashop et Wordpress ;
  • “admin” à l’interface de portainer ;
  • gérer les modèles de sites créés (visualisation et suppression).

Quatre types d'installation pour l'e-comBox

L'installation peut se faire sur :

  • un poste de l'établissement ;
  • un serveur de l'établissement ;
  • un serveur dans le cloud ;
  • le poste personnel du professeur.
Pour une installation sur Linux, c'est le serveur qui est sur Linux, l'ordinateur du professeur peut être sur n'importe quel système d'exploitation. Il accède à l'interface de l'e-comBox à distance avec un navigateur.

Caractéristiques minimum de la machine

L'application nécessite au minimum :

  • Windows 10 64 bits : Professionnel, Entreprise ou Education (OsVersion : 10.0.18363 et WindowsVersion : 1909 ou ultérieure) ou une distribution basée sur Linux 64 bits comme Debian 9/10 ou Ubuntu à partir de la version 18.04 ;
  • la virtualisation activée dans le BIOS (ce qui est fait, en règle générale, par défaut) ;
  • la fonction SLAT supportée au niveau du processeur ;
  • une connexion Internet de qualité ;
  • 8 Go de RAM : plus il y a de RAM, mieux c'est, pour notamment faire démarrer les sites en même temps ;
  • le service Docker avec “docker-compose” (le setup sur Windows et le script se chargent de l’installer) ;
  • l'activation de deux fonctionnalités supplémentaires sur Windows (le setup se charge également de les activer).
l'accès via un navigateur à l'interface de l'e-comBox peut maintenant se faire à distance.

<translate> Note</translate> <translate> Note:</translate> Pour des raisons de commodité, il sera fait l’usage de “git” (le setup et le script l’installe) pour récupérer des fichiers sur les dépôts officiels gitlab de l’application.

8 Go de RAM est réellement un minimum (notamment sur Windows), il ne faudra pas espérer faire tourner plus de 20 sites en même temps et vous risquez de rencontrer certaines lenteurs.


Pour un serveur Linux devant héberger plusieurs sites pour deux classes de 32 élèves, il est conseillé de disposer d'au minimum 16 Go de RAM.

Ports utilisés

Les ports 8880, 8888 et 8800 sont utilisés par défaut pour l'application elle-même. Ils doivent être libres. Si ce n'est pas le cas, vous devrez spécifier d'autres ports lors de l'installation de la e-comBox.

Le pare-feu de la machine doit être configuré pour permettre les connexions sur ces ports (voir ici) ou il doit être désactivé temporairement pendant l'utilisation de l'application.
Si vous utilisiez la v1 de la e-comBox, vous pouvez maintenant fermer la plage de ports qui devait être ouverte auparavant.

E-comBox et VirtualBox

L’application ne peut pas être installée sur une machine Windows 10 virtualisée avec VirtualBox mais, même si cela n’est pas conseillé à cause de lenteurs constatées en production, elle peut en revanche être utilisée sur une machine Debian 9/10 virtualisée avec VirtualBox à condition :

  • d’activer “VT-x/AMD-v imbriqué” au niveau du processeur et de l’accélération (menu système) ;
  • de mettre au moins 8 Go de RAM pour la machine virtuelle sinon le processus de création des sites peut ne pas se finaliser correctement.
En l’état actuel des choses, il n’est pas possible d’utiliser l’application conjointement avec VirtualBox qui n’est pas compatible avec Hyper-V. Un des deux doit être désactivée alternativement.