Guide étape par étape : Installation de Node-RED sur PLCnext avec Podman

Comment installer Node-RED sur PLCnext avec Podman

Depuis le firmware 2023.0, Podman (https://podman.io/) est installé sur le système d'exploitation PLCnext. Podman remplit la même fonction que Docker. Cette implémentation garantit une installation plus simple de Node-RED pour l'utilisateur final.

IMPORTANT : En raison des changements que subit PLCnext à chaque mise à jour de firmware, ces procédures peuvent cesser de fonctionner à l'avenir. Si c'est le cas, ce document sera mis à jour.

Créé le 05-03-2024

Dernière modification le 11-03-2024

Exigences

Contrôleur : AXC F 1152 - AXC F 2152 - AXC F 3152

Stockage : Carte mémoire SD 2 Go ou plus pour AXC F 1152 / 2152

Firmware : 2023.0 LTS ou supérieur

1. Étapes d'installation :

1.1. Accès via client SSH :

• Vous devez accéder en utilisant Putty ou votre client SSH préféré en utilisant l'IP de votre PLC. Rappelez-vous que l'IP par défaut est 192.168.1.10.

• Connectez-vous avec le nom d'utilisateur admin et le mot de passe de votre PLCnext.

1.2. Accès en tant qu'utilisateur root :

• Une fois connecté au PLCnext, vous devez accéder en tant qu'utilisateur root en utilisant la commande su

su 

• Si vous n'avez pas encore créé de mot de passe root, créez-le avec la commande sudo passwd root

sudo passwd root 

NOTE : Les utilisateurs admin et root sont différents. Définir un mot de passe différent pour l'utilisateur root n'affectera pas l'utilisateur « admin ».

1.3. Installation de Node-RED :

• Une fois connecté en tant qu'utilisateur root, vous pouvez installer l'image officielle Node-RED dans sa version 2.2.2 en utilisant la commande suivante :

podman run -d -p 1880:1880 --name nodered --restart always docker.io/nodered/node-red:2.2.2 

1.4. Installation d'exemples :

• J'ai créé des conteneurs Node-RED pour PLCnext AXC F 1152 / 2152 qui incluent des bibliothèques pour travailler avec PLCnext. Ces conteneurs incluent également des exemples d'envoi d'alarmes, de lecture et d'écriture via OPC UA. Pour installer l'un de ces exemples, utilisez les commandes suivantes :

• Pour installer l'exemple « Envoi d'alarmes » :

podman run -d -p 1880:1880 --name nodered --restart always docker.io/fellipem/noderedpxc:alarms 

• Pour installer l'exemple « Lecture et écriture OPC UA » :

podman run -d -p 1880:1880 --name nodered --restart always docker.io/fellipem/noderedpxc:opcua 

1.5. Accès à Node-RED :

• Une fois terminé, vous pouvez commencer à utiliser Node-RED en entrant IP_PLC:1880 dans votre navigateur web. Par exemple, si l'adresse IP de votre PLC est 192.168.1.10, vous entrerez 192.168.1.10:1880.

AVERTISSEMENT : Contrairement à Docker, Podman ne s'exécute pas en tant que service dans PLCnext. Par conséquent, Node-RED ne démarrera pas automatiquement lorsque le PLC est allumé. Pour faire démarrer Node-RED avec le PLC, suivez ces étapes :

2. Étapes pour démarrer Node-RED automatiquement :

2.1. Créer un script de démarrage :

• Utilisez la commande suivante sur votre PLC pour télécharger ce projet :

git clone https://github.com/Fellipem1/PLCnext_Node-RED.git 

2.2. Déplacer le fichier :

• Déplacez le fichier nodered.sh vers le chemin /etc/init.d/ en utilisant la commande suivante :

mv /opt/plcnext/PLCnext_Node-RED/nodered.sh /etc/init.d/ 

2.3. Changer les permissions du fichier :

• Exécutez la commande suivante pour changer les permissions du fichier nodered.sh :

chmod +x /etc/init.d/nodered.sh 

2.4. Ajouter le script au démarrage :

• La méthode pour ajouter le script au démarrage varie selon la distribution Linux que vous utilisez. Dans le cas de PLCnext, vous devez utiliser la commande suivante :

update-rc.d nodered.sh defaults 

• En suivant les étapes ci-dessus, Node-RED sera prêt à démarrer automatiquement à chaque fois que vous éteignez ou redémarrez le PLCnext.

NOTE : N'oubliez pas d'effectuer ces étapes en utilisant toujours l'utilisateur root.

3. Étapes pour installer des bibliothèques dans Node-RED :

3.1. Démarrer Node-RED et accéder au conteneur :

• Accédez en tant qu'utilisateur root et tapez les commandes suivantes :

podman start nodered 

podman exec -it nodered /bin/bash 

cd /data 

3.2. Installer la bibliothèque :

• Maintenant, vous pouvez installer n'importe quelle bibliothèque en utilisant des commandes npm, par exemple :

npm i node-red-contrib-iiot-opcua@3.11.1-4 

3.3. Quitter le conteneur et redémarrer Node-RED :

• Une fois terminé, tapez Exit et redémarrez node-RED avec les commandes suivantes :

podman stop nodered 

podman start nodered 

4. Erreurs courantes

4.1. Erreur 1 : mkdir no such file or directory

• L'erreur suivante se produit car l'utilisateur admin n'a pas assez de privilèges pour installer Node-RED. Pour résoudre le problème, vous devez vous connecter en tant qu'utilisateur root.

4.2. Erreur 2 : Certificat expiré

• L'erreur suivante se produit car le PLCnext a une date et heure incorrectes configurées. Vous pouvez vérifier la date et l'heure avec la commande date.
• Pour changer l'heure sur le PLCnext, utilisez la commande suivante :

date -s “29 FEB 2024 11:25:39” 

• N'oubliez pas de modifier la commande avec l'heure et la date UTC actuelles : https://time.is/es/UTC

4.3. Erreur 3 : Failed, retrying timeout

• Cette erreur se produit car le PLCnext n'a pas accès à Internet. Vous pouvez vérifier cela avec la commande ping, par exemple :

ping google.cl 

• Si cela dit bad address, vous devez vérifier la configuration IP, masque et Passerelle du PLCnext. Vous pouvez le faire depuis le serveur web, section Réseau.

Plus d'informations : https://github.com/Fellipem1/PLCnext_Node-RED