FAQ - v3
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> 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" :
- Saisir "Pare-feu" puis sélectionner "Pare-feu Windows" :
- Cliquer sur "Paramètres avancés" :
- Cliquer sur "Règles de trafic entrant" puis sur "Nouvelle règle ":
- Sélectionner "Port" puis cliquer sur "Suivant" :
- Indiquer le numéro de port à autoriser puis cliquer sur "Suivant" :
- Sélectionner "Autoriser la connexion" puis cliquer sur "Suivant" :
- Laisser les cases "Domaine", "Privé" et "Public" cochées puis cliquer sur "Suivant" :
- Spécifier un nom significatif pour la règle puis cliquer sur "Terminer" :
- Renouveler l'opération pour avoir une règle par port et ainsi obtenir un affichage du type :
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).
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.
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.
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 ?
Première démarche
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur si vous n'êtes pas en navigation privée
- Relancer Démarrer e-comBox
Si ça ne fonctionne toujours pas, suivez la deuxième démarche.
Deuxième démarche
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur si vous n'êtes pas en navigation privée
- Lancer Stopper e-comBox
- Lancer Démarrer e-comBox
- Lancer Réinitialiser l'environnement
- 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
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur si vous n'êtes pas en navigation privée
- Lancer Stopper e-comBox
- Lancer Démarrer e-comBox
- Lancer Vérifier et configurer l'environnement
- Relancer Démarrer e-comBox
| 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.
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
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
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 ?
Première démarche
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur (relancer éventuellement ce dernier)
- Relancer l'e-comBox dans le navigateur
Si ça ne fonctionne toujours pas, suivez la deuxième démarche.
Deuxième démarche
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur (relancer éventuellement ce dernier)
- 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
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur (relancer éventuellement ce dernier)
- Lancer en tant qu'administrateur le script configure_application.sh
| 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
Quoi faire si la e-comBox ne répond plus ?
Première démarche
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur (relancer éventuellement ce dernier)
- Relancer l'e-comBox dans le navigateur
Si ça ne fonctionne toujours pas, suivez la deuxième démarche.
Deuxième démarche
- Fermer l'onglet dans lequel l'e-comBox a été ouverte
- Vider le cache de votre navigateur (relancer éventuellement ce dernier)
- 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 : | 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.
- 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.
- Vérifier le pare-feu : les ports utilisés doivent être autorisés.
- Vérifier que le site est bien accessible du poste où est installé e-comBox.
- Vérifier que votre adresse IP est bien accessible par les machines.
- Re-démarrer le site.
- 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).
