5. Commandes
5.1 Principe
Il est possible d'envoyer des commandes à la WebdynSun PM. Elles permettent d'exécuter des tâches à
distance à des fins de configuration, de pilotage ou de surveillance. Par exemple : lancer une recherche
d'équipements, obtenir la configuration courante, déclencher une connexion au SI, etc... Le même
mécanisme permet également d'invoquer une fonction d'un script installé sur le concentrateur.
5.2 Fonctionnement
Une commande peut être envoyée via trois méthodes distinctes :
• Un fichier de commande déposé sur le serveur (FTP, SFTP ou WebDAV) qui sera récupéré par
le concentrateur lors de la connexion SI.
• Un message MQTT posté sur le topic de contrôle de la WebdynSun PM.
• Un SMS envoyé à la carte SIM de la WebdynSun PM.
5.2.1 Fichier de commande
Lors d'une connexion FTP, SFTP ou WebDAV, la WebdynSun PM vérifie la présence d'un fichier de
commande dans le répertoire configuré à cet effet (/CMD par défaut). Ce fichier doit être nommé
<uid>_cmd.json où <uid> est l'identifiant de la passerelle. Les commandes incluses dans celui-ci sont
au format JSON décrit ci-dessous et sont exécutées dans l'ordre. L'invocation des fonctions de script est
également prise en charge. Le fichier est supprimé après import de façon à ne pas traiter deux fois une
même commande.
Les résultats de commandes sont également écrits dans des fichiers qui seront déposés lors de la
connexion SI suivante. Un fichier peut contenir un ou plusieurs résultats. Ceux-ci sont nommés selon le
modèle <uid>_ACK_<timestamp>.json.
Pour une connexion FTP, SFTP ou WebDAV, les commandes fonctionnement uniquement sur le
serveur 1 ; les commandes déposées dans le répertoire « /CMD » sur un serveur 2 (backup) ne sont pas
prises en compte par le concentrateur.
176
V2.05 sous réserve de modifications | Webdyn © par Flexitron Group
contact@webdyn.com |
webdyn.com