FAQ - v3

De Documentation 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.

<translate> Warning</translate> <translate> Warning:</translate> 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

Avertissement Avertissement : 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.

Quoi faire si la e-comBox ne répond plus ?


Vérifier au préalable que l'accès à Internet est possible et que le proxy est correctement configuré sur le système et dans Docker.

Première démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur si vous n'êtes pas en navigation privée
  3. Relancer Démarrer e-comBox

Si ça ne fonctionne toujours pas, suivez la deuxième démarche.

Deuxième démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur si vous n'êtes pas en navigation privée
  3. Lancer Stopper e-comBox
  4. Lancer Démarrer e-comBox
  5. Lancer Réinitialiser l'environnement
  6. Relancer Démarrer e-comBox

Si ça ne fonctionne toujours pas, tentez la troisième démarche, après avoir vérifié que :

  • les consignes pour un éventuel proxy soient bien respectées,
  • vous avez bien synchronisé le mot de passe de portainer (si vous l'avez changé bien sûr) avec l'e-comBox

Troisième démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur si vous n'êtes pas en navigation privée
  3. Lancer Stopper e-comBox
  4. Lancer Démarrer e-comBox
  5. Lancer Vérifier et configurer l'environnement
  6. Relancer Démarrer e-comBox
Avertissement Avertissement : Lisez attentivement les informations fournies par le script qui est lancé par le raccourci Vérifier et configurer l'environnement.

Quatrième démarche
Si aucune de ces démarches n'a abouti, vous devez contacter le support sans oublier d'attacher les fichiers de logs au rapport d'anomalie.


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) :

Fichier: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 et configuration 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

Quoi faire si la e-comBox ne répond plus ?


Vérifier au préalable que l'accès à Internet est possible et que le proxy est correctement configuré sur le système et dans Docker.

Première démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur (relancer éventuellement ce dernier)
  3. Relancer l'e-comBox dans le navigateur

Si ça ne fonctionne toujours pas, suivez la deuxième démarche.

Deuxième démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur (relancer éventuellement ce dernier)
  3. Lancer en tant qu'administrateur le script change_config_ip.sh

Si ça ne fonctionne toujours pas, tentez la troisième démarche, après avoir vérifié que :

  • les paramètres que vous saisissez sont bien les bons (adresse IP, éventuel proxy) ;
  • vous avez bien synchronisé le mot de passe de portainer (si vous l'avez changé bien sûr) avec l'e-comBox

Troisième démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur (relancer éventuellement ce dernier)
  3. Lancer en tant qu'administrateur le script configure_application.sh
Avertissement Avertissement : Le script va réinitialiser l'application (sans supprimer les sites déjà créés bien sûr), il faudra ensuite si nécessaire configurer de nouveau l'authentification à l'interface de l'e-comBox et modifier le mot de passe de Portainer.

Quatrième démarche
Si aucune de ces démarches n'a abouti, vous devez contacter le support sans oublier d'attacher les fichiers de logs (/var/log/ecombox.log et /var/log/ecombox-error.log) au rapport d'anomalie.

Configuration sur MacOS

Documentation en cours de mise à jour.

Quoi faire si la e-comBox ne répond plus ?

Première démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur (relancer éventuellement ce dernier)
  3. Relancer l'e-comBox dans le navigateur

Si ça ne fonctionne toujours pas, suivez la deuxième démarche.

Deuxième démarche

  1. Fermer l'onglet dans lequel l'e-comBox a été ouverte
  2. Vider le cache de votre navigateur (relancer éventuellement ce dernier)
  3. Ouvrir le terminal et exécuter la commande suivante :
    bash /Applications/configure_application.sh

Troisième démarche
Si aucune de ces démarches n'a abouti, vous devez contacter le support sans oublier d'attacher les fichiers de logs (/Applications/log/ecombox.log et /Applications/log/errorEcomBox.log) au rapport d'anomalie.

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.


Avertissement Avertissement : 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 ?

Le sites sont créés mais l'accès à ceux-ci engendre un dysfonctionnement, page blanche par exemple.

  1. Vérifier les valeurs du proxy et que vous avez bien exclus du passage du proxy les éléments relatifs à votre réseau local et au réseau dans lequel se trouve le proxy.
  2. Vérifier le pare-feu : les ports utilisés doivent être autorisés.
  3. Vérifier que le site est bien accessible du poste où est installé e-comBox.
  4. Vérifier que votre adresse IP est bien accessible par les machines.
  5. Re-démarrer le site.
  6. Si le site peut être supprimé, le supprimer et le recréer (un problème de réseau a peut-être engendré un dysfonctionnement lors de la création initiale).