Guide étape par étape :Installation de Node-RED sur PLCnext à l'aide de Podman

Comment installer Node-RED dans 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 Node-RED plus simple pour l'utilisateur final.

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

Créé le 03/05/2024

Dernière modification le 11-03-2024

Exigences

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

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

Micrologiciel : 2023.0 LTS ou version ultérieure

1. Étapes d'installation :

1.1. Accès via le client SSH :

• Vous devez accéder en utilisant Putty ou votre SSH client préféré en utilisant l'IP de votre automate. N'oubliez pas que l'adresse 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é à PLCnext, vous devez y accéder en tant qu'utilisateur root à l'aide de 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

REMARQUE : Le admin et root les utilisateurs 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 à l'aide de la commande suivante :

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

1.4. Exemples d'installation :

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

• Pour installer l'exemple "Envoi d'alarme":

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

• Pour installer l'exemple "Lecture et écriture d'OPC UA" :

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

1.5. Accéder à Node-RED :

• Une fois que vous avez terminé, vous pouvez commencer à utiliser Node-RED en saisissant IP_PLC:1880 dans votre navigateur Internet. Par exemple, si l'adresse IP de votre automate est 192.168.1.10, vous saisirez 192.168.1.10:1880 .

AVERTISSEMENT : Contrairement à Docker, Podman ne fonctionne pas en tant que service au sein de PLCnext. Par conséquent, Node-RED ne démarrera pas automatiquement à la mise sous tension de l'automate. Pour faire démarrer Node-RED avec l'automate, suivez ces étapes :

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

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

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

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

2.2. Déplacez le fichier :

• Déplacez le nodered.sh fichier vers le /etc/init.d/ chemin à l'aide de la commande suivante :

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

2.3. Modifier les autorisations du fichier :

• Exécutez la commande suivante pour modifier les autorisations du nodered.sh fichier :

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

2.4. Ajoutez le script au démarrage :

• La méthode d'ajout du script au démarrage varie en fonction de 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.

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

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

3.1. Démarrez Node-RED et accédez au conteneur :

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

podman start nodered

podman exec -it nodered /bin/bash

cd /data

3.2. Installez la bibliothèque :

• Vous pouvez désormais installer n'importe quelle bibliothèque à l'aide des commandes npm, par exemple :

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

3.3. Quittez le conteneur et redémarrez 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 aucun fichier ou répertoire de ce type

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

4.2. Erreur 2 :Certificat expiré

• L'erreur suivante se produit car la date et l'heure configurées sur le PLCnext sont incorrectes. Vous pouvez vérifier l'heure et la date avec le date commande.
• Pour modifier 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 :Échec, nouvelle tentative d'expiration du délai

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

ping google.cl

• S'il est écrit 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