Skip to content

Commit

Permalink
[Jenkins] Updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
Jenkins committed Nov 13, 2023
1 parent a32929b commit 50385e3
Show file tree
Hide file tree
Showing 8 changed files with 96 additions and 122 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

## documentations

- [Access the documentation](https://doc.jeedom.com)
- [Contribute to documentation](https://doc.jeedom.com/en_US/contribute/doc)
- [Accede a la documentación](https://doc.jeedom.com)
- [Contribuir a la documentación](https://doc.jeedom.com/en_US/contribute/doc)

<p align="center">
<img src="https://doc.jeedom.com/img/img_home.png" width="80%">
Expand Down
29 changes: 13 additions & 16 deletions fr_FR/core/4.4/eqAnalyse.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Analyse équipements
**Analyse → Equipements**

La page Analyse d’équipements vous montre de manière centralisée les nombreuses informations relatives aux équipements :
La page Analyse d’équipements vous permet de voir de nombreuses infos relatives aux équipements de manière centralisée :

- L’état de vos piles
- Les modules en alertes
Expand All @@ -11,22 +11,23 @@ La page Analyse d’équipements vous montre de manière centralisée les nombre

## Onglet Batteries

Vous pouvez voir sur cet onglet la liste de vos modules sur pile, leur niveau restant (la couleur de la tuile dépend de ce niveau), le type et le nombre de piles requis pour le module, le type du module ainsi que la date à laquelle l’information du niveau de batterie a été mise à jour. Vous pouvez aussi voir si un seuil manuel a été défini pour le module en particulier (représenté par une icône de main)

Vous pouvez voir sur cet onglet la liste de vos modules sur batterie, leur niveau restant (la couleur de la tuile dépend de ce niveau), le type et le nombre de piles qu’il faut mettre dans le module, le type du module ainsi que la date à laquelle l’information du niveau de batterie a été mise à jour. Vous pouvez aussi voir si un seuil spécifique a été établi pour le module en particulier (représenté par une main)

> **Tip**
>
> Les seuils d’alerte/warning sur les niveaux des piles sont configurables de manière globale dans la configuration de Jeedom (Réglages→Systèmes→Configuration : Equipements), ou par équipement sur la page de configuration avancée de ceux-ci dans l’onglet alertes.
> Les seuils d’alerte/warning sur les niveaux des batteries sont configurables de manière globale dans la configuration de Jeedom (Réglages→Systèmes→Configuration : Equipements), ou par équipement sur la page de configuration avancée de ceux-ci dans l’onglet alertes.
## Onglet Equipements en alerte
## Onglet Modules en alerte

Sur cet onglet vous verrez en temps réel les modules en alerte. Les alertes peuvent être de différents types :

- Timeout (configuré dans l’onglet alertes définies).
- Pile en warning ou en danger.
- Commande en warning ou danger (paramétrable dans les paramètres avancés des commandes).
- Batterie en warning ou en danger.
- Commande en warning ou danger (paramétrable dans les paramètres avancées des commandes).

D’autres types d’alertes pourront éventuellement se retrouver ici.
Chaque alerte sera représentée par une icône dans le titre de la tuile. Le type et la couleur de l'icone seront fonction du type et du niveau d’alerte.
Chaque alerte sera représentée par la couleur de la tuile (le niveau d’alerte) et un logo en haut à gauche (le type d’alerte).

> **Tip**
>
Expand All @@ -36,7 +37,7 @@ Chaque alerte sera représentée par une icône dans le titre de la tuile. Le ty

Cet onglet permet de visualiser les actions définies directement sur une commande. En effet, on peut en mettre sur différentes commandes et il peut être difficile de se rappeler de toutes. Cet onglet est là pour ça et synthétise plusieurs choses :

- Les actions sur état (que l’on retrouve dans les paramètres avancés des commandes infos et permettant de réaliser une ou plusieurs actions sur la valeur d’une commande - de manière immédiate ou après un délai).
- Les actions sur état (que l’on retrouve dans les paramètres avancées des commandes infos et permettant de réaliser une ou plusieurs actions sur la valeur d’une commande - de manière immédiate ou après un délai).
- Les confirmations d’actions (configurable au même endroit sur une commande info et permettant de demander une confirmation pour exécuter une action).
- Les confirmations avec code (même chose que précédemment mais avec la saisie d’un code).
- Les actions pre et post (configurables toujours au même endroit sur une commande action et permettant d’exécuter une ou plusieurs autres actions avant ou après l’action en question).
Expand All @@ -47,24 +48,20 @@ Cet onglet permet de visualiser les actions définies directement sur une comman
## Onglet Alertes définies

Cet onglet permet de voir l’ensemble des alertes définies, vous y retrouverez dans un tableau les infoormations suivantes si elles existent :
Cet onglet permet de voir l’ensemble des alertes définies, vous y retrouverez dans un tableau les infos suivantes si elles existent :

- Les alertes sur délai de communication.
- Les seuils spécifiques de piles définis sur un équipement.
- Les seuils spécifiques de batterie définis sur un équipement.
- Les différentes alertes danger et warning des commandes.

## Push définis

Cet onglet vous permet de visualiser l'ensemble des équiepements et leurs commandes suivies dans la timeline.

## Onglet Commandes orphelines

Cet onglet vous permet de voir en un coup d’œil si vous avez des commandes orphelines utilisées au travers de Jeedom. Une commande orpheline est une commande utilisée quelque part mais qui n’existe plus. On retrouvera ici l’ensemble de ces commandes, comme par exemple :

- Les commandes orphelines utilisées dans le corps d’un scénario.
- Les commandes orphelines utilisée dans le corps d’un scenario.
- Celles utilisées en déclencheur d’un scénario.

Et utilisées à beaucoup d’autres endroits comme (non exhaustif) :
Et utilisées à plein d’autres endroits comme (non exhaustif) :
- Les interactions.
- Les configurations de Jeedom.
- En pre ou post action d’une commande.
Expand Down
46 changes: 22 additions & 24 deletions fr_FR/core/4.4/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,19 @@
**Réglages → Version : FAQ**

### Jeedom nécessite-t-il un abonnement ?
Non, Jeedom est pleinement utilisable sans aucune nécessité de quelque abonnement que ce soit. Cependant, il existe des services proposés pour les sauvegardes ou les appels/SMS, mais qui restent réellement optionnels.
Non, Jeedom est pleinement utilisable sans aucune nécessité de quelque abonnement que ce soit. Cependant, il existe des services proposés pour les sauvegardes ou les appel/SMS, mais qui restent réellement optionnels.

### Jeedom utilise-t-il des serveurs extérieurs pour fonctionner ?
Non, Jeedom n’utilise pas d’infrastructure type "Cloud". Tout se fait en local et vous n’avez pas besoin de nos serveurs pour que votre installation fonctionne. Seuls les services comme le Market, la sauvegarde en ligne ou le DNS Jeedom nécessitent l’utilisation de nos serveurs.

### Y a-t-il une application mobile dédiée ?
Jeedom possède une version mobile adaptée à l’utilisation sur mobile et tablette. Il existe également une application native pour Android et iOS.
Jeedom possède une version mobile adaptée à l’utilisation sur mobile et tablette. Il existe aussi une application native pour Android et iOS.

### Quels sont les identifiants pour me connecter la première fois ?
Lors de votre première connexion à Jeedom, le nom d’utilisateur et le mot de passe par défaut sont admin/admin. A la première connexion, il vous est fortement recommandé de modifier ces identifiants pour plus de sécurité.
Lors de votre première connexion à Jeedom (et même après si vous ne les avez pas modifiés), le nom d’utilisateur et le mot de passe par défaut sont admin/admin. A la première connexion, il vous est fortement recommandé de modifier ces identifiants pour plus de sécurité.

### Je n'arrive plus à me connecter à mon Jeedom
Depuis Jeedom 3.2 il n'est plus possible de se connecter avec admin/admin à distance pour des raisons évidentes de sécurité. Les identifiants admin/admin ne fonctionnent qu'en local. Attention si vous passer par le DNS Jeedom même en local vous êtes forcement identifié comme étant à distance. Autre point par défaut seules les IP sur 192.168.*.* ou 127.0.0.1 sont reconnues comme locales. Cela se configure dans l'administration de Jeedom partie sécurité puis IP "blanche". Si malgré tout çà vous n'arrivez toujours pas à vous connecter il faut utiliser la procédure de remise à zéro de mot de passe, voir [ici](https://doc.jeedom.com/fr_FR/howto/reset.password).
Depuis Jeedom 3.2 il n'est plus possible de se connecter avec admin/admin à distance pour des raisons évidentes de sécurité. Les identifiants admin/admin ne marchent plus qu'en local. Attention si vous passer par le DNS même en local vous êtes forcement identifié comme à distance. Autre point par défaut seules les IP sur 192.168.*.* ou 127.0.0.1 sont reconnues comme locales. Cela se configure dans l'administration de Jeedom partie sécurité puis IP "blanche". Si malgré tout çà vous n'arrivez toujours pas à vous connecter il faut utiliser la procédure de remise à zéro de mot de passe, voir [ici](https://doc.jeedom.com/fr_FR/howto/reset.password).

### Je ne vois pas tous mes équipements sur le Dashboard
Souvent cela est dû au fait que les équipements sont affectés à un objet qui n’est pas le fils ou l’objet lui-même du premier objet sélectionné à gauche dans l’arbre (vous pouvez configurer celui-ci dans votre profil).
Expand Down Expand Up @@ -45,8 +45,7 @@ Oui : Soit vous avez un pack power ou plus, dans ce cas il vous
suffit d’utiliser le [DNS Jeedom](https://jeedom.github.io/documentation/howto/fr_FR/mise_en_place_dns_jeedom). Soit avec un DNS et vous savez mettre en place un certificat valide, dans ce cas c’est une installation standard d’un certificat.

### Comment se connecter en SSH ?
Voila une [documentation](https://www.alsacreations.com/tuto/lire/612-Premiere-connexion-SSH.html), partie "Sous Windows : Putty". Le "hostname" étant l'ip de votre Jeedom.
Les identifiants des images officielles Jeedom ou des box offcielles étant :
Voila une [documentation](https://www.alsacreations.com/tuto/lire/612-Premiere-connexion-SSH.html), partie "Sous Windows : Putty". Le "hostname" étant l'ip de votre Jeedom, les identifiants étant :

- Username : "root", password : "Mjeedom96"
- Username : "jeedom", password : "Mjeedom96"
Expand All @@ -63,8 +62,6 @@ chmod -R 775 /var/www/html
chown -R www-data:www-data /var/www/html
```

OU via le menu **Réglages -> Système -> Configuration** puis dans **OS/DB** et cliquez sur le bouton Rétablissement des droits des dossiers et fichiers.

### Comment mettre à jour Jeedom en SSH ?
En SSH faites :

Expand All @@ -81,13 +78,13 @@ La webapp nécessite un smartphone supportant le HTML5 et le CSS3. Elle n’est
### Sur quelles plateformes Jeedom peut-il fonctionner ?
Pour que Jeedom fonctionne, il faut une plateforme linux avec les droits root ou un système type docker. Il ne fonctionne donc pas sur une plateforme android pure.

### Je ne peux mettre à jour certains plugins "Echec lors du téléchargement du fichier. Veuillez réessayer plus tard (taille inférieure à 100 octets)..." ?
### Je ne peux mettre à jour certain plugin "Echec lors du téléchargement du fichier. Veuillez réessayer plus tard (taille inférieure à 100 octets)..." ?
Cela peut être dû à plusieurs choses, il faut :

- Vérifier que votre Jeedom est toujours connecté au market (dans la page d'administration de Jeedom, partie mise à jour vous avez un bouton de test).
- Vérifier que le compte market a bien acheté le plugin en question.
- Vérifier que vous avez bien la place disque nécessaire sur Jeedom (la page santé vous l'indiquera).
- Vérifier que votre version de Jeedom est bien compatible avec la version requise par le plugin.
- Vérifier que vous avez bien de la place sur Jeedom (la page santé vous l'indiquera).
- Vérifier que votre version de Jeedom est bien compatible avec le plugin.

### J’ai une page blanche
Il faut se connecter en SSH à Jeedom et lancer le script d’auto-diagnostic :
Expand All @@ -113,7 +110,7 @@ sudo chown www-data:www-data core/config/common.config.php
```

### J’ai des \{\{…​\}\} partout
La cause la plus fréquente est l’utilisation d’un plugin en version beta et Jeedom en stable ou l’inverse. Pour avoir le détail de l’erreur, il faut regarder le log http.error (dans /var/www/html/log).
La cause la plus fréquente est l’utilisation d’un plugin en version beta et Jeedom en stable, ou l’inverse. Pour avoir le détail de l’erreur, il faut regarder le log http.error (dans /var/www/html/log).

### Lors d’une commande j’ai une roue qui tourne sans s’arrêter
Encore une fois cela est souvent dû à un plugin en beta alors que Jeedom est en stable. Pour voir l’erreur, il faut faire F12 puis console.
Expand All @@ -133,7 +130,7 @@ Cela est dû à MySQL qui s’est arrêté, ce n’est pas normal, les cas coura

- Manque de place sur le système de fichiers (peut être vérifié en faisant la commande "df -h", en SSH)
- Problème de corruption de fichier(s), ce qui arrive souvent suite à un arrêt non propre de Jeedom (coupure de courant)
- Soucis mémoire, le système manque de mémoire et tue le process le plus consommateur (souvent la base de données). Cela peut se voir dans l'administration de l'OS puis dmesg, vous devez voir un kill par "oom". Si c'est le cas il faut réduire la consommation mémoire de Jeedom en désactivant des plugins.
- Soucis mémoire, le système manque de mémoire et tue le process le plus consommateur (souvent la base de données). Cela peut se voir dans l'administration de l'OS puis dmesg, vous devez voir un kill par "oom". Si c'est le cas il faut réduire la consommation de Jeedom en désactivant des plugins.

Malheureusement, il n’y a pas beaucoup de solution si c’est le deuxième cas, le mieux étant de récupérer une sauvegarde (disponible dans /var/www/html/backup par défaut), de réinstaller Jeedom et de restaurer la sauvegarde. Vous pouvez aussi regarder pourquoi MySQL ne veut pas démarrer depuis une console SSH :
``` {.bash}
Expand Down Expand Up @@ -166,15 +163,15 @@ echo "PrivateTmp=no" >> /etc/systemd/system/apache2.service.d/privatetmp.conf
```

### J'ai un soucis d'heure sur mes historiques
Essayez de vider le cache de votre navigateur, l'affichage des historiques est calculé par rapport à l'heure du navigateur.
Essayez de vider le cache de chrome, l'affichage des historiques est calculé par rapport à l'heure du navigateur.

### J'ai l'erreur "Souci réseaux détecté, redémarrage du réseau"
Jeedom ne trouve pas ou n'arrive pas a pinguer la gateway. En général ca arrive si la box adsl redémarre (en particulier les livebox) et que Jeedom n'a pas redémarré ou a redémarré plus vite que la box. Par sécurité il vous dit donc qu'il a trouvé un soucis et relance le processus de connexion réseau. Vous pouvez désactiver ce mécanisme en allant dans la configuration de Jeedom et en désactivant la gestion du réseau par Jeedom.
### J'ai l'erreur "Souci réseaux détecté, redémarrage du réseaux"
Jeedom ne trouve pas ou n'arrive pas a pinguer la gateway. En général ca arrive si la box adsl redémarre (en particulier les livebox) et que Jeedom n'a pas redémarré ou a redémarré plus vite que la box. Par sécurité il vous dit donc qu'il a trouvé un soucis et relance le processus de connexion réseaux. Vous pouvez désactiver ce mécanisme en allant dans la configuration de Jeedom et en désactivant la gestion du réseaux par Jeedom.

### J'ai le message "Echec durant la sauvegarde de la base de données. Vérifiez que mysqldump est présent."
Ça veut dire que Jeedom n'arrive pas à sauvegarder la base de données ce qui peut laisser penser à un soucis de corruption de base de données et de filesystem. Il n'y a malheureusement pas de commande miracle pour corriger. Le mieux est de lancer une sauvegarde et d'analyser le log de celle-ci. Dans les cas connus de soucis nous avons:
Ça veut dire que Jeedom n'arrive pas a backuper la base de données ce qui peut laisser penser à un soucis de corruption de base de données et de filesystem. Il n'y a malheureusement pas de commande miracle pour corriger. Le mieux est de lancer un backup et d'analyser le log de celui-ci. Dans les cas connus de soucis nous avons:

- une table de la base corrompue => là c'est mal parti il faut voir pour essayer de réparer et si ca ne fonctionne pas repartir de la dernière sauvegarde correcte (si vous êtes sur carte SD c'est le bon moment pour la changer)
- une table de la base corrompue => là c'est mal parti il faut voir pour essayer de réparer et si ca marche pas repartir du dernier bon backup (si vous êtes sur carte SD c'est le bon moment pour la changer)
- pas assez de place sur le filesystem => regarder la page santé celle-ci peut vous l'indiquer

### J'ai des erreurs de type "Class 'eqLogic' not found", des fichiers semblent être manquant ou j'ai une page blanche
Expand Down Expand Up @@ -203,12 +200,12 @@ Il faut :
- aller dans l'onglet OS/DB
- lancer l'administration Système
- cliquer sur Dpkg configure
- attendre 10 minutes
- relancer les dépendances du plugin qui bloque
- attendre 10min
- relancer les dépendances du plugins qui bloque

### J'ai cette erreur sur l'installation des dépendances d'un plugin : "from pip._internal import main"
### J'ai cette erreur sur l'installation des dependances d'un plugin : "from pip._internal import main"

Il faut dans la console système de Jeedom ou en ssh faire
Il faut dans la console systeme de Jeedom ou en ssh faire

````
sudo easy_install pip
Expand All @@ -217,11 +214,12 @@ sudo easy_install3 pip

Puis relancer les dépendances


### Depuis la 4.2, je ne peux plus afficher d'iframe

Le Core 4.2 renforce énormément la sécurité de Jeedom. Si vraiment (en connaissance de cause) vous avez besoin de revenir à une version non sécurisée de votre Jeedom :
Allez dans **Réglages -> Système -> Configuration** puis dans **OS/DB**, lancez la console d'administration système et cliquez sur **Apache non sécurisé**. Un redémarrage de Jeedom est recommandé suite à ce changement.

### Depuis la 4.2, certains plugins ne fonctionnent plus et dans la console du navigateur (touche F12) j'ai des erreurs 403
### Depuis la 4.2, certains plugins ne marchent plus et dans la console du navigateur (touche F12) j'ai des erreurs 403

C'est du à la sécurisation d'Apache qui impose aux développeurs de plugin de mettre les bons fichiers dans les bons répertoires pour limiter la surface d'attaque de Jeedom. Cette sécurisation se fait dans le fichier .htaccess (écrasé à chaque mise à jour du Core). Vous pouvez faire un fichier .htaccess_custom avec vos propres règles qui si il existe sera utilisé à la place du fichier .htaccess du Core.
C'est du a la sécurisation d'Apache qui impose aux développeur de plugin de mettre les bons fichiers dans les bons répertoires pour limiter la surface d'attaque de Jeedom. Cette sécurisation ce fait dans le fichier .htaccess (écrasé à chaque mise à jour du Core). Vous pouvez faire un fichier .htaccess_custom avec vos propre règles qui si il existe sera utilisé à la place du fichier .htaccess du Core.
Loading

0 comments on commit 50385e3

Please sign in to comment.