FAQ - v3 - Historique des versions

Aporaf : /* Configuration sur Windows */

2023-04-21T17:12:25Z

Configuration sur Windows

Aporaf : /* Où se trouvent les identifiants de connexion ? */

2023-04-21T16:43:22Z

Où se trouvent les identifiants de connexion ?

◂ Version précédente		Version du 21 avril 2023 à 16:43
Ligne 221 :		Ligne 221 :
	<br>		<br>

	{{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).}}		{{Warning/fr\|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 ? ===		=== Est-ce que je peux accéder à l'e-comBox en-dehors de mon ordinateur ? ===

Aporaf : /* Utilisation de l'e-comBox */

2023-04-21T16:42:56Z

Utilisation de l'e-comBox

◂ Version précédente		Version du 21 avril 2023 à 16:42
Ligne 227 :		Ligne 227 :

	=== Que faire si j'ai une page blanche ou si l'e-comBox devient subitement inaccessible ? ===		=== 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.
	~~Consulter~~ la ~~[[Trousse_de_premiers_secours - v3\|trousse des premiers secours]]~~.		# 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).

Aporaf : /* Installation sur Linux */

2023-04-21T16:38:59Z

Installation sur Linux

◂ Version précédente		Version du 21 avril 2023 à 16:38
Ligne 150 :		Ligne 150 :
	<br>		<br>

	== Installation sur Linux ==		== Installation et configuration sur Linux ==

	{{note \| ''Documentation en cours de mise à jour''.}}		{{note \| ''Documentation en cours de mise à jour''.}}
Ligne 190 :		Ligne 190 :
	<br>		<br>
	Si aucune de ces démarches n'a abouti, vous devez [[Contactez_le_support \| 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.		Si aucune de ces démarches n'a abouti, vous devez [[Contactez_le_support \| 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 ==		== Configuration sur MacOS ==

Aporaf le 21 avril 2023 à 16:37

2023-04-21T16:37:33Z

@@ Ligne 1 : / Ligne 1 : @@
-{{note}} Cette page est en cours de mise à jour.
+{{note/fr}} Cette page est en cours de mise à jour.
 == Configuration de l'e-comBox commune à tous les systèmes ==
@@ Ligne 85 : / Ligne 85 : @@
 Voir [[Boite_à_outils_-_v3#Configuration_du_proxy_sur_Windows|ici]] pour le mode opératoire de configuration du proxy.
 === Pourquoi ne puis-je pas utiliser conjointement l'application avec VirtualBox ? ===
@@ Ligne 121 : / Ligne 159 : @@
 * /var/log/ecombox.log
 * /var/log/ecombox-error.log
 == Configuration sur MacOS ==
 {{note | ''Documentation en cours de mise à jour''.}}
 == Utilisation de l'e-comBox ==

Aporaf : /* Comment dois-je configurer le proxy ? */

2022-11-23T17:56:21Z

Comment dois-je configurer le proxy ?

◂ Version précédente		Version du 23 novembre 2022 à 17:56
Ligne 84 :		Ligne 84 :
	** 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).		** 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 [[~~Boite_à_outils~~#Configuration_du_proxy_sur_Windows\|ici]] pour le mode opératoire de configuration du proxy.		Voir [[Boite_à_outils_-_v3#Configuration_du_proxy_sur_Windows\|ici]] pour le mode opératoire de configuration du proxy.

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

Aporaf : 1 version importée : Import des pages présentes sur le serveur LLB

2022-09-29T16:29:30Z

1 version importée : Import des pages présentes sur le serveur LLB

◂ Version précédente	Version du 29 septembre 2022 à 16:29
(Aucune différence)

Aporaf : /* Quand utiliser "Réinitialiser l'environnement" ? */

2021-11-26T20:39:47Z

Quand utiliser "Réinitialiser l'environnement" ?

Nouvelle page

{{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 {{color|red|'''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}} '''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 [[Boite_%C3%A0_outils#Changer_le_mot_de_passe_Admin_de_Portainer|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'' :
<pre>bash /opt/e-comBox/configure_application.sh</pre>

== 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" :
[[File:DocEcomBox-images-imagePF1.png|100px]]

* Saisir "Pare-feu" puis sélectionner "Pare-feu Windows" :
[[File:DocEcomBox-images-imagePF2.png|500px]]

* Cliquer sur "Paramètres avancés" :
[[File:DocEcomBox-images-imagePF3.png|500px]]

* Cliquer sur "Règles de trafic entrant" puis sur "Nouvelle règle ":
[[File:DocEcomBox-images-imagePF4.png|700px]]

* Sélectionner "Port" puis cliquer sur "Suivant" :
[[File:DocEcomBox-images-imagePF5.png|500px]]

* Indiquer le numéro de port à autoriser puis cliquer sur "Suivant" :
[[File:DocEcomBox-images-imagePF7.png|500px]]

* Sélectionner "Autoriser la connexion" puis cliquer sur "Suivant" :
[[File:DocEcomBox-images-imagePF6.png|500px]]

* Laisser les cases "Domaine", "Privé" et "Public" cochées puis cliquer sur "Suivant" :
[[File:DocEcomBox-images-imagePF8.png|500px]]

* Spécifier un nom significatif pour la règle puis cliquer sur "Terminer" :
[[File:DocEcomBox-images-imagePF9.png|500px]]

* Renouveler l'opération pour avoir une règle par port et ainsi obtenir un affichage du type :
[[File:DocEcomBox-images-imagePF10.png|500px]]

{{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).
[[File:DocEcomBox-images-imagePF11.png|500px]]

{{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.

{{note | 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.

{{note | 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 [[Boite_à_outils#Configuration_du_proxy_sur_Windows|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.

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

[[File:DocEcomBox/images/image20.jpg|500px]]

{{note|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 [[Installation_sur_Windows#D.C3.A9sinstallation_de_l.27e-comBox|ici]].
<br>

== Installation sur Linux ==

{{note | ''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 ==

{{note | ''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.
<br>

{{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_de_premiers_secours - v3|trousse des premiers secours]].

◂ Version précédente		Version du 21 avril 2023 à 17:12
Ligne 57 :		Ligne 57 :
	[[File:DocEcomBox-images-imagePF10.png\|500px]]		[[File:DocEcomBox-images-imagePF10.png\|500px]]

	{{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).		{{Warning/fr}} 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).
	[[File:DocEcomBox-images-imagePF11.png\|500px]]		[[File:DocEcomBox-images-imagePF11.png\|500px]]

	{{note}} Le pare-feu peut également être désactivé temporairement pendant l'utilisation de l'application, mais ce n'est pas conseillé.		{{note/fr}} Le pare-feu peut également être désactivé temporairement pendant l'utilisation de l'application, mais ce n'est pas conseillé.


Ligne 67 :		Ligne 67 :
	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.		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.

	{{note \| Ce menu doit aussi être utilisé pour mettre à jour l'application.}}		{{note/fr \| Ce menu doit aussi être utilisé pour mettre à jour l'application.}}

	=== Quand utiliser "Vérifier et configurer l'environnement" ? ===		=== Quand utiliser "Vérifier et configurer l'environnement" ? ===
Ligne 73 :		Ligne 73 :
	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.		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.

	{{note \| Ce menu ne devrait être utilisé qu'en cas de problème.}}		{{note/fr \| Ce menu ne devrait être utilisé qu'en cas de problème.}}

	=== Comment dois-je configurer le proxy ? ===		=== Comment dois-je configurer le proxy ? ===
Ligne 88 :		Ligne 88 :
	=== Quoi faire si la e-comBox ne répond plus ? ===		=== Quoi faire si la e-comBox ne répond plus ? ===
	<br>		<br>
	{{note \| 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.}}		{{note/fr \| 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'''		'''Première démarche'''
Ligne 130 :		Ligne 130 :
	C’est donc à cause de cette limitation technique qu’il n’est pas possible d’utiliser conjointement l'e-comBox et VirtualBox.		C’est donc à cause de cette limitation technique qu’il n’est pas possible d’utiliser conjointement l'e-comBox et VirtualBox.

	{{note \| 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.}}		{{note/fr \| 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 ? ===		=== Comment faire pour pouvoir utiliser VirtualBox ? ===
Ligne 140 :		Ligne 140 :
	[[File:DocEcomBox/images/image20.jpg\|500px]]		[[File:DocEcomBox/images/image20.jpg\|500px]]

	{{note\|Il faut faire la démarche inverse pour réactiver "Hyper-V" et pouvoir de nouveau utiliser l'e-comBox.}}		{{note/fr\|Il faut faire la démarche inverse pour réactiver "Hyper-V" et pouvoir de nouveau utiliser l'e-comBox.}}

	=== Où trouver les logs ? ===		=== Où trouver les logs ? ===

FAQ - v3 - Historique des versions

Aporaf : /* Configuration sur Windows */

Aporaf : /* Où se trouvent les identifiants de connexion ? */

Aporaf : /* Utilisation de l'e-comBox */

Aporaf : /* Installation sur Linux */