Une action UniFi Network de Link’nX envoie une commande à la console UniFi : bloquer, débloquer ou reconnecter un client, activer ou désactiver un WLAN, redémarrer un équipement ou couper puis rétablir l’alimentation d’un port PoE. Ajoutée à un scénario, elle s’exécute avec lui.
Destiné aux administrateurs et installateurs. Ces commandes peuvent interrompre des communications : préparez la cible exacte avec le responsable réseau et prévoyez l’opération dans le contexte autorisé. Pour les commandes envoyées depuis le bus KNX, suivez la présence et le tableau KNX UniFi Network.
Avant de commencer
Section intitulée « Avant de commencer »- La console UniFi Network est déclarée dans Link’nX.
- Vous disposez de la cible confirmée pour chaque commande : adresse MAC du client ou de l’équipement, numéro de port PoE ou nom exact du WLAN.
Créer l’action
Section intitulée « Créer l’action »- Sélectionnez le projet et la gateway, puis ouvrez Actions → Ajouter → UniFi Network.
- Renseignez Nom, obligatoire.
- Sélectionnez Contrôleur(s) UniFi Network à contrôler. La liste accepte plusieurs contrôleurs et propose Tout sélectionner. La même cible est utilisée pour chacun : choisissez seulement ceux auxquels elle correspond.
- Dans Cible (MAC du client / ID de l’équipement), saisissez la cible adaptée à la commande, d’après le tableau ci-dessous.
- Choisissez Commande UniFi Network. Ces sept commandes ne demandent pas de champ Valeur.
- Cliquez sur la disquette en bas à droite, attendez Succès !, puis vérifiez la liste.
- Si la commande doit être exécutée par un scénario, ajoutez l’action au scénario approprié et enregistrez-le.
L’enregistrement prépare l’action sans l’exécuter.
Choisir la commande et sa cible
Section intitulée « Choisir la commande et sa cible »| Commande affichée | Cible à préparer | Effet demandé |
|---|---|---|
| Bloquer le client | Adresse MAC du client | Bloquer son accès au réseau |
| Débloquer le client | Adresse MAC du client | Lever ce blocage |
| Reconnecter (kick) le client | Adresse MAC du client | Forcer sa déconnexion pour qu’il se reconnecte ; son retour n’est pas garanti |
| Redémarrer l’équipement | Adresse MAC de l’équipement UniFi | Demander son redémarrage |
| Redémarrer le port PoE | MAC de l’équipement suivie de _ et du numéro de port | Couper puis rétablir l’alimentation PoE du port |
| Activer le WLAN | Nom exact du WLAN/SSID | Demander l’activation de ce WLAN |
| Désactiver le WLAN | Nom exact du WLAN/SSID | Demander sa désactivation |
Exemples entièrement fictifs : 02:00:00:00:00:01 pour une MAC, 02:00:00:00:00:02_3 pour le port PoE 3 d’un équipement, SSID fictif pour un WLAN. Remplacez-les par les valeurs confirmées pour votre installation. Le libellé général Cible couvre plusieurs formats : utilisez celui de la commande choisie, plutôt qu’une IP, un nom convivial d’équipement ou un autre identifiant.
- WLAN : saisissez le nom exact. Si plusieurs WLAN portent le même nom, faites confirmer la cible par le support avant d’utiliser cet automatisme.
- Port PoE : utilisez le numéro positif confirmé par l’installateur, sans déduire la numérotation de l’exemple.
Modifier l’action ou revenir à l’état précédent
Section intitulée « Modifier l’action ou revenir à l’état précédent »Pour modifier ou dupliquer l’action, suivez l’éditeur d’actions. Relisez le nom, les contrôleurs, la cible et la commande avant d’enregistrer.
Supprimer une action laisse le réseau dans son état actuel. Pour lever un blocage ou réactiver un WLAN, créez ou utilisez la commande inverse, Débloquer le client ou Activer le WLAN, dans le contexte autorisé.
Vérifier le résultat
Section intitulée « Vérifier le résultat »- Rouvrez l’action et relisez les contrôleurs, la cible et la commande.
- Vérifiez qu’elle figure dans le bon scénario et que celui-ci est enregistré.
- Après l’exécution, contrôlez le résultat dans la console du réseau concerné : client bloqué ou reconnecté, WLAN, équipement ou port PoE.
En cas de problème
Section intitulée « En cas de problème »- Veuillez indiquer la cible UniFi Network (MAC du client / ID de l’équipement) : renseignez la cible, obligatoire même pour une commande sans champ Valeur.
- L’action est enregistrée, mais sans effet observé : vérifiez le contrôleur et le site de la déclaration, la cible adaptée à la commande, puis l’association au scénario et son exécution. Ne redémarrez pas plusieurs fois l’équipement pour tester le chemin.
- Le nom du WLAN a changé : confirmez le nouveau nom dans la console, puis mettez à jour les actions et associations concernées.
Si ces vérifications sont déjà faites, écrivez à support@can-nx.com en indiquant la commande, le symptôme, l’heure et les essais réalisés. Ne joignez pas de mot de passe.
Interface en anglais : UniFi Network controller(s) to control, Target (client MAC / device ID), UniFi Network command, Block client, Unblock client, Reconnect (kick) client, Restart device, PoE power-cycle port, Enable WLAN et Disable WLAN.