Dans mon précédent Retex, j’ai décrit comment on pouvait configurer la sauvegarde via Samba, dans celui-ci, je vais configurer la sauvegarde via NFS.

J’ai eu quelques déconnexions de Samba que je ne m’explique pas encore et sur un réseau local, si NFS est bien configuré, c’est un outil simple qui ne nécessite pas de créer d’utilisateur, je ne garderai ainsi qu’un utilisateur protégé par une double authentification sur mon NAS.

Je configure le dossier de sauvegarde sur le NAS

Dans le panneau de configuration puis Dossier partagé, je crée un dossier partagé.

Mon dossier de sauvegarde s’appelle Sauvegardes_HA 

Dans les propriétés du dossier partagé Sauvegardes_Ha, je vais configurer les Autorisations NFS

192.168.1.200 est mon Home Assistant et je relève tout en bas le chemin d’accès /volume1/Sauvegardes_HA

Vieux réflexe, je limite le nb d’utilisateurs à avoir accès à ce dossier, je ne garde que l’utilisateur qui correspond à mon PC pour vérifier les sauvegardes de temps en temps :

Le dossier est prêt, comme j’ai autorisé l’utilisateur de mon PC, je le vois depuis l’ordinateur également :

Je configure le stockage de Home Assistant

Je vais dans Paramètres / Système / Stockage

J’ajoute un stockage réseau

Quand je valide, je vois bien mon dossier sauvegarde enregistré :

Et à ce stade, il est légitime de se demander comment expliquer à Home Assistant qu’il faut maintenant utiliser ce nouveau stockage réseau pour les sauvegardes, et bien non, il a compris tout seul. Le fait d’avoir coché « Sauvegarde » à la création du stockage réseau va automatiquement rediriger toutes les sauvegardes vers ce dossier. HA a toujours une petite part de magie qui lui donne une avance systématique devant tous les systèmes concurrents.

J’automatise la sauvegarde

Il faut bien demander à Ha de réaliser les sauvegardes, une toute simple automatisation fera cela très bien.

alias: Sauvegarde - Toutes les nuits
description: ""
trigger:
  - platform: time
    at: "01:50:00"
condition: []
action:
  - service: hassio.backup_full
    data:
      compressed: true
mode: single

Je regarde le résultat

Je vais donc abandonner mes sauvegardes via Samba Backup. Elles fonctionnaient parfaitement mais nécessitaient l’installation du module complémentaire Samba Backup, je peux maintenant le désinstaller et supprimer mon Retex sur sa configuration.

• Mise à jour de Décembre 2023 : J’ai eu quelques soucis avec Samba, j’ai basculé ma sauvegarde HA via NFS

Je configure le dossier de sauvegarde sur le NAS

Dans le panneau de configuration puis Dossier partagé, je crée un dossier partagé.

Mon dossier de sauvegarde s’appelle Sauvegardes_Jeedom car c’est historiquement au même endroit que je stocke mes backup de Jeedom.

Vieux réflexe, je limite le nb d’utilisateurs à avoir accès à ce dossier :

Le dossier est prêt, comme j’ai autorisé l’utilisateur de mon PC, je le vois depuis l’ordinateur également :

Je configure le stockage de Home Assistant

Je vais dans Paramètres / Système / Stockage

J’ajoute un stockage réseau

Pour la sauvegarde, il faut cocher la radio « Sauvegarde », mettre l’ip du NAS, choisir CIFS puis le chemin vers le dossier de sauvegarde, Sauvegardes_Jeedom/HA chez moi. Je mets enfin l’utilisateur HA (utilisateur déclaré dans le NAS) et son mot de passe.

Quand je valide, je vois bien mon dossier sauvegarde enregistré :

Et à ce stade, il est légitime de se demander comment expliquer à Home Assistant qu’il faut maintenant utiliser ce nouveau stockage réseau pour les sauvegardes, et bien non, il a compris tout seul. Le fait d’avoir coché « Sauvegarde » à la création du stockage réseau va automatiquement rediriger toutes les sauvegardes vers ce dossier. HA a toujours une petite part de magie qui lui donne une avance systématique devant tous les systèmes concurrents.

J’automatise la sauvegarde

Il faut bien demander à Ha de réaliser les sauvegardes, une toute simple automatisation fera cela très bien.

alias: Sauvegarde - Toutes les nuits
description: ""
trigger:
  - platform: time
    at: "01:50:00"
condition: []
action:
  - service: hassio.backup_full
    data:
      compressed: true
mode: single

Je regarde le résultat

J’ai attendu quelques jours pour poster ce résultat, je vois bien que les sauvegardes jusqu’au 09/06 ont été réalisé via le module complémentaire Samba_Backup, depuis la nouvelle version et le configuration ci-dessus, tout se déroule parfaitement dans ce dossier réseau.

Souci « it is not empty »

Comme beaucoup visiblement, je me suis rendu compte que mes sauvegardes ne partaient plus sur mon NAS.

J’avais le message Network storage cannot be mounted at xxxxxxx because it is not empty

Ce souci est connu et beaucoup ont la même chose :

• https://github.com/home-assistant/supervisor/issues/4358

J’ai supprimé le lien Samba et tout refait, c’est reparti, mais il faut être vigilant au moindre message d’erreur de stockage pour ne pas perdre ce lien.

Je ne vais pas m’attarder sur l’intégration Jeedom.

Le pilotage des équipements Synology se réalise grâce au plugin Synology-API qui est un de mes plugins.

Toute la documentation est disponible sur ce blog.

Intégration dans Home Assistant

Les synology sont détectés.

Si on regarde bien la documentation, il faut distinguer les Routeurs et les NAS

• Doc des routeurs (SRM) : https://www.home-assistant.io/integrations/synology_srm/
• Doc des NAS (DSM) : https://www.home-assistant.io/integrations/synology_dsm

Les NAS sont visiblement bien reconnus et simples à intégrer, pour les routeurs, c’est visiblement une autre histoire, au moment où j’écris ces lignes, je ne suis pas encore arrivé à les intégrer.

Dans la liste ci dessus, je n’ai qu’un NAS, c’est le NAS 192.168.1.2, je vais commencer par lui

Intégration d’un NAS Synology dans Home Assistant

Avant toute intégration, il faut en premier s’occuper du User qui aura accès au NAS.

Il est plus que conseillé d’avoir activé sur NAS l’identification en deux étapes (2FA), surtout pour les administrateurs et il sera nécessaire d’utiliser un User avec le rôle d’administrateur, c’est obligatoire.

J’ai créé un User : « ha » avec un profil qui est le plus restreint possible (mais administrateur quand même), à noter que je lui donne un accès aux caméras pour pouvoir les récupérer depuis Surveillance Station.

Je ne mets rien dans port, il va le détecter tout seul.

Dès que je valide, il me remonte automatiquement la liste de tous les appareils, je leur affecte une pièce et je valide.

Je remarque également la création d’une autre intégration :

C’est terminé, toutes mes caméras sont apparues et les informations de mon NAS sont disponibles :

Intégration d’un Routeur Synology dans Home Assistant

Au moment où j’écris ces lignes, je ne suis pas encore à intégrer les serveurs Syno détectés.

• 192.168.1.1 est le routeur « Maitre », un RT2600ac
• 192.168.0.10 est le même routeur mais côté du lien avec la Freebox
• 192.168.1.253 est un MR2200AC qui couvre le wifi jardin et la piscine
• 192.168.1.254 est un MR2200AC qui couvre le wifi de l’étage

Si j’arrive à les intégrer, je reviens ici expliquer.

L’explication est sur cette page : https://www.home-assistant.io/integrations/synology_srm/

Conclusion

Voici donc mes notes pour créer cette VM

Sur le Synology, on utilise Virtual Machine Manager

• La création de la VM est très simple

Puis on suit ce tuto très bien fait.

Une fois lancé, on fait un grand grand ménage pour supprimer tout ce qui est inutile, il suffit de lire le paragraphe optimisation du tuto Réinstaller Windows 10

• On télécharge puis installe Setup.Microsoft.powerAutomate.exe
• Pour l’autolog de la session windows (puisqu’il faut impérativement un mot de passe), voici le tuto de microsoft

Si les services UIFlowService et UIFlowAgentLauncherService ne se lance pas, faire un petit bat avec :

• Net start UIFlowService 
• Net start UIFlowAgentLauncherService 

et le lancer au démarrage de la VM

• Article de Domo-blog
• Article de Maison et Domotique

J’ai choisi d’utiliser l’application SynologyVirtual Machine Manager

Installation de la dernière version de Jeedom sur le VM

Voici, dans l’ordre les écrans et ce que j’ai choisi d’utiliser

C’est sur l’écran suivant, que j’ai choisi d’envoyer l’image de Jeedom.

Il faut télécharger le fichier iso le plus récent dans :

• https://images.jeedom.com/x86-64/

Le copier sur un dossier du NAS et aller le chercher dans le champs « Fichier ISO de démarrage ».
A ce stade, je laisse Périphérique USB démonté, je le monterai plus tard.

Sur l’écran suivant, donner les droits à vos utilisateurs Syno puis valider l’installation

Cliquer sur le bouton « Connecter »

L’écran d’installation apparait :

On laisse tourner…

Récupération de l’adresse IP et première connexion

Une fois l’installation terminée, il faut trouver l’IP dans le routeur, le DHCP va lui donner une adresse.

Par habitude, une fois la VM détectée je fige l’adresse sur 192.168.1.180

Ensuite, on peut accéder à Jeedom par l’ip dans le navigateur

Et envoyer des commandes en ligne de commande :

Ce tuto a pour objectif d’utiliser le prétexte de reproduire une tuile correspondante au conseiller de sécurité Synology sur Jeedom pour expliquer comment utiliser le plugin Synology-API.

Important : Ce tuto est en deux parties

En fonction de ce que vous souhaitez faire et/ou comprendre de l’utilisation des API de Synology et du fonctionnement du plugin Synology-API, vous avez deux options :

• Soit vous lisez la 1ere partie qui vous explique, pas à pas de manière la plus pédagogique possible ce que vous faites
• Soit vous lisez directement la 2ème partie qui vous fournira, clé en main la tuile de votre équipement, avec les commandes et les infos déja programmées

Matériel, logiciels

• Tous les équipements Synology sont équipés d’un Conseiller de sécurité, c’est celui-ci qui sera utilisé :

• Coté Jeedom, il vous faut le lien Jeedom-Synology qui s’appelle Synology-API

1ère partie : Explication complète à vertu pédagogique, pas à pas

Envoyer des ordres au Syno

Trouver les commandes à envoyer au routeur

Dans le Tuto Activer/Désactiver WIFI de mon réseau avec Jeedom, il est expliqué comment trouver les commandes à envoyer.

Pour ce tuto, la commande à envoyer pour lancer l’analyse dans le conseiller de sécurité est :

• Nom de l’API : Core.SecurityScan.Operation
• Méthode à utiliser : start

Et comme paramètre :

• &items=ALL

Ajout de cette commande à Jeedom

Pour envoyer un ordre du Syno, il faut ajouter une commande action dans le plugin Synology-API.

• Lancer Synology-API et cliquer sur le + pour lancer l’assistant

• Dans API à utiliser, sélectionner Core.SecurityScan.Operation
• Dans Méthode à utiliser, sélectionner Start
• Dans autres paramètres, ajouter &items=ALL
• Attention à ne pas oublier le & au début.
• cliquer sur Lancer la requête.

L’assistant répond « Requête envoyée et exécutée avec succès ! » c’est qu’elle a fonctionné et que le Syno a répondu que la requête était exécutée.

Juste en dessous, l’assistant propose d’enregistrer cette commande pour pouvoir la réutiliser directement ou via un scénario. Remplissez le formulaire et valider l’ajout de la commande

Récupérer des infos du Syno

Sur le principe des requêtes précédentes, on peut questionner le Syno pour obtenir des informations. Pour respecter le langage Jeedom, nous qualifierons ces requêtes de « commandes info ».

Dans la continuité de l’exemple en cours, nous allons questionner le Syno pour récupérer le résultat de l’analyse du conseiller de sécurité.

La manipulation pour trouver ces informations sont identiques à l’explication précédente.

Voici l’API qu’il faut utiliser  :

• API : SYNO.Core.SecurityScan.Status
• Méthode à utiliser : System Get
  

Cette demande renvoie la réponse suivante :

Cocher :

• toutes les cases failSeverity de chaque section
• lastScanTime
• sysProgress

Après avoir ajouté le nouveau device Jeedom qui inclus toutes les commandes, on peut renommer les commandes pour une meilleure compréhension.

A noter qu’il est utile d’utiliser la case « calcul » pour transformer l’information donnée par l’API en date/heure.

Par exemple : date(‘d-m-Y H:i’,#value#)

Améliorer le Widget (v1)

Le champ failSeverity donne une information sous la format d’un mot correspondant à un état : par exemple Safe, Risk, outOfDate, …

Il faudra créer un widget Jeedom pour transformer cet état en logo, voici ce que je propose de créer un Widget :

J’ai choisi de faire trois tests :

• #value#== »safe » qui affiche fas fa-check-circle icon_green
• #value#== »risk » qui affiche fas fa-exclamation-circle icon_red
• #value#== »outOfDate » qui affiche fas fa-exclamation-circle icon_orange
• #value#== »warning » qui affiche fas fa-exclamation-circle icon_orange
• #value#== »info » qui affiche fas fa-exclamation-circle icon_blue

Ce widget est donc affecté à toutes les valeurs failSeverity 

Améliorer le Widget (v2)

J’ai laissé le paragraphe précédent car il a une vertu pédagogique pour expliquer les widgets mais depuis, j’ai intégré le widget au sein du plugin.

Ainsi, il suffit tout simplement de choisir le widget Synologyapi/Safe_Risk à chaque commande info :

Fusionner les deux devices en un seul

Le plugin Synology-API est capable de fusionner deux devices pour avoir sur le même device Jeedom les commandes et les infos.

Il suffit pour cela de suivre l’assistant de fusion

Bonus : Avoir l’actualisation en temps réel du résultat du conseiller de sécurité

La commande Lance une analyse demande au Synology de déclencher l’analyse.

Juste après le lancement de cette commande, il faut ajouter le lancement d’un refresh pour actualiser la tuile, cela se fait en cliquant sur l’engrenage à droite au bout de la commande

puis Onglet Configuration, ajouter le Refresh

Cela lancera le premier Refresh, pour la suite, il faut utiliser un scénario.

Le Scénario sera :

Ce scénario sera déclenché par :

Le contenu du scénario sera :

Résultat

2ème partie : Importation direct d’un modèle de Device

Si vous n’avez pas l’âme d’un informaticien et que vous ne souhaitez pas comprendre ce que vous faites, utilisez directement cette seconde partie qui vous donne directement le modèle de Device.

Vous aurez ainsi directement les commandes et les infos qui seront préprogrammées, même les widgets sont inclus vous proposant ainsi une tuile propre et utilisable immédiatement.

Importer un modèle d’équipement

Le plugin Synology-API a intégré une fonctionnalité d’import, il vous suffit juste de cliquer sur le bouton Importer un Modèle, juste sous le nom de l’équipement Synology concerné :

Pour ce device « Wifi », voici le fichier JSON à importer

• http://jeedom.sigalou-domotique.fr/documentssigalou/Conseiller_de_securite.json
• ou au format zip : http://jeedom.sigalou-domotique.fr/documentssigalou/Conseiller_de_securite.zip

Une fois le widget importé, il est opérationnel.

Pour que le widget se mette à jour, il faut y ajouter le bonus de la 1ere partie, suivez ce lien pour ajouter l’automatisation du rafraichissement de la tuile.