FAQ - v3

De Support e-comBox

Note Note: Cette page est en cours de mise à jour.

Configuration de l'e-comBox commune à tous les systèmes

Pourquoi faut-il créer un mot de passe pour s'authentifier à l'e-comBox ?

L'interface de l'e-comBox est accessible à distance dès lors que l'on connaît l'adresse IP de la machine, il faut donc impérativement protéger l'accès à cette interface.

Pourquoi faut-il modifier le mot de passe "admin" de Portainer ?

L'interface de Portainer est accessible à distance dès lors que l'on connaît l'adresse IP de la machine, il faut donc impérativement protéger l'accès "admin" à cette interface. Le mot de passe par défaut utilisé peut facilement être connu de tous.

Warning Warning: Il est ensuite nécessaire synchroniser le mot de passe de l'utilisateur admin saisi dans Portainer avec la e-combox. Pour cela, voir le mode opératoire ici.


Comment mettre à jour l'e-comBox ?

Sur Windows, il faut réinitialiser l'environnement via l'entrée du menu correspondante.

Sur Linux, il est nécessaire de reconfigurer l'application en exécutant le script configure_application.sh :

bash /opt/e-comBox/configure_application.sh

Configuration sur Windows

Comment autoriser les ports nécessaires à e-comBox sur le pare-feu de windows 10 ?

e-comBox utilise par défaut les ports 8880, 8888 et 8800. Le pare-feu de la machine doit être configuré pour permettre les connexions sur ces ports. Pour cela, la procédure (les numéros de ports sont à adapter en fonction de ceux définis dans e-comBox) est la suivante :

  • Cliquer sur "Windows" puis "paramètres" :

DocEcomBox-images-imagePF1.png

  • Saisir "Pare-feu" puis sélectionner "Pare-feu Windows" :

DocEcomBox-images-imagePF2.png

  • Cliquer sur "Paramètres avancés" :

DocEcomBox-images-imagePF3.png

  • Cliquer sur "Règles de trafic entrant" puis sur "Nouvelle règle ":

DocEcomBox-images-imagePF4.png

  • Sélectionner "Port" puis cliquer sur "Suivant" :

DocEcomBox-images-imagePF5.png

  • Indiquer le numéro de port à autoriser puis cliquer sur "Suivant" :

DocEcomBox-images-imagePF7.png

  • Sélectionner "Autoriser la connexion" puis cliquer sur "Suivant" :

DocEcomBox-images-imagePF6.png

  • Laisser les cases "Domaine", "Privé" et "Public" cochées puis cliquer sur "Suivant" :

DocEcomBox-images-imagePF8.png

  • Spécifier un nom significatif pour la règle puis cliquer sur "Terminer" :

DocEcomBox-images-imagePF9.png

  • Renouveler l'opération pour avoir une règle par port et ainsi obtenir un affichage du type :

DocEcomBox-images-imagePF10.png

Warning Warning: Attention, des règles concernant "Docker Desktop" sont automatiquement ajoutées à l'installation d'e-comBox. Ces dernières doivent obligatoirement être activées (avec l'icône vert). DocEcomBox-images-imagePF11.png

Note Note: Le pare-feu peut également être désactivé temporairement pendant l'utilisation de l'application, mais ce n'est pas conseillé.


Quand utiliser "Réinitialiser l'environnement" ?

La fonctionnalité “Réinitialiser l’environnement” est utile lorsque vous changez d’environnement. Par exemple, vous avez préparé tous vos sites sur votre poste chez vous pour les mettre à disposition de vos étudiants. Lorsque vous allez utiliser sur ce même poste e-comBox dans votre lycée, il sera nécessaire de réinitialiser l’environnement afin que tout fonctionne correctement. Cela va notamment de mettre à jour l’adresse IP des sites afin qu’ils fonctionnent dans le nouvel environnement et prendre en compte un éventuel proxy d'établissement.

Ce menu doit aussi être utilisé pour mettre à jour l'application.

Quand utiliser "Vérifier et configurer l'environnement" ?

Le menu "Vérifier et configurer l'environnement" va, comme le menu "Réinitialiser l’environnement", prendre en considération un changement d'environnement mais de manière plus interactive en permettant d'une part à l'utilisateur de vérifier les paramètres (adresse IP, Prxy, etc.) et en permettant un plus large choix de configuration.

Ce menu ne devrait être utilisé qu'en cas de problème.

Comment dois-je configurer le proxy ?

  • il est nécessaire de configurer le proxy sur le système et sur Docker ;
  • les éléments à exclure du proxy sont très importants, si la configuration à ce niveau n'est pas faite correctement, vous allez rencontrer des lenteurs ;
  • il faut notamment exclure du proxy système et du proxy sur Docker (ByPass) le réseau dans lequel est le serveur d'ecomBox et le réseau dans lequel se trouve le proxy ;
  • au niveau des items d'exclusion :
    • il faut mettre des "," entre deux items sur la configuration du proxy sur Docker,
    • Il faut généralement mettre des ";" entre deux items au niveau du proxy système (les scripts les transforment en "," en tant que de besoin).

Voir ici pour le mode opératoire de configuration du proxy.

Pourquoi ne puis-je pas utiliser conjointement l'application avec VirtualBox ?

L'e-comBox est basée sur la technologie Docker qui utilise la fonctionnalité “Hyper-V” de Windows qui est actuellement incompatible avec VirtualBox.

C’est donc à cause de cette limitation technique qu’il n’est pas possible d’utiliser conjointement l'e-comBox et VirtualBox.

Mais il est tout à fait possible d'alterner l'utilisation en activant/désactivant “Hyper-V”. Les machines virtuelles créées avec VirtualBox comme les sites créés via l'application ne sont, bien sûr, pas supprimés lors de ces activations/désactivations.

Comment faire pour pouvoir utiliser VirtualBox ?

Il est nécessaire de désactiver “Hyper-V” si vous désirez utiliser VirtualBox.

Pour désactiver Hyper-V, il faut utiliser Activer ou désactiver des fonctionnalités Windows et décocher la case relative à "Hyper-V" puis cliquer sur OK (un redémarrage sera nécessaire) :

DocEcomBox/images/image20.jpg

Il faut faire la démarche inverse pour réactiver "Hyper-V" et pouvoir de nouveau utiliser l'e-comBox.

Où trouver les logs ?

Le fichier log ecombox.log se trouve dans un dossier logEcombox lui-même dans le dossier .docker figurant dans le répertoire par défaut de l'utilisateur.

Comment désinstaller e-comBox ?

Voir la procédure ici.

Installation sur Linux

Documentation en cours de mise à jour.

Où trouver les logs ?

Les 2 fichiers logs sur Linux sont :

  • /var/log/ecombox.log
  • /var/log/ecombox-error.log

Configuration sur MacOS

Documentation en cours de mise à jour.

Utilisation de l'e-comBox

Où se trouvent les identifiants de connexion ?

Les identifiants d'accès (ainsi que l'accès administrateur à Portainer) figurent dans le fichier e-comBox_identifiants_acces_applications.pdf qui est installé par le setup et les scripts dans :

  • C:\Programmes\e-combox pour Windows,
  • /opt/e-comBox pour Linux
  • /Applications/e-comBox, là où sont installées toutes les applications sous Mac OS.


Warning Warning: Il n'est pas possible sur Windows et sur MacOS de modifier le mot de passe de Portainer sous peine de voir la e-comBox dysfonctionner. C'est par contre fortement conseillé sur un serveur Linux qui sera accessible de l'extérieur (voir le mode opératoire ici, le mot de passe doit être changé classiquement via l'interface graphique mais il est nécessaire ensuite d'exécuter un script de manière à ce que la e-comBox prenne en compte ce changement).

Est-ce que je peux accéder à l'e-comBox en-dehors de mon ordinateur ?

C'est possible sur tous les systèmes à partir de la version 2.

Que faire si j'ai une page blanche ou si l'e-comBox devient subitement inaccessible ?

Consulter la trousse des premiers secours.