Schritt-für-Schritt-Anleitung: Installation von Node-RED auf PLCnext mit Podman

Node-RED in PLCnext mit Podman installieren

Seit Firmware 2023.0 ist Podman (https://podman.io/) auf dem PLCnext-Betriebssystem installiert. Podman erfüllt dieselbe Funktion wie Docker. Diese Implementierung garantiert eine einfachere Node-RED-Installation für den Endbenutzer.

WICHTIG: Aufgrund der Änderungen, die PLCnext mit jedem Firmware-Update durchläuft, funktionieren diese Prozeduren möglicherweise in der Zukunft nicht mehr. Falls dies der Fall ist, wird dieses Dokument aktualisiert.

Erstellt 05-03-2024

Zuletzt geändert 11-03-2024

Voraussetzungen

Controller: AXC F 1152 - AXC F 2152 - AXC F 3152

Speicher: SD-Speicher 2 GB oder höher für AXC F 1152 / 2152

Firmware: 2023.0 LTS oder höher

1. Installationsschritte:

1.1. Zugriff via SSH-Client:

• Sie müssen mit Putty oder Ihrem bevorzugten SSH-Client unter Verwendung der IP Ihrer SPS zugreifen. Denken Sie daran, dass die Standard-IP 192.168.1.10 ist.

• Melden Sie sich mit dem Benutzernamen admin und dem Passwort Ihrer PLCnext an.

1.2. Als Root-Benutzer anmelden:

• Sobald Sie bei der PLCnext angemeldet sind, müssen Sie als Root-Benutzer mit dem Befehl su zugreifen

su 

• Falls Sie noch kein Root-Passwort erstellt haben, erstellen Sie es mit dem Befehl sudo passwd root

sudo passwd root 

HINWEIS: Die Benutzer admin und root sind unterschiedlich. Das Setzen eines anderen Passworts für den Root-Benutzer beeinflusst den „admin“-Benutzer nicht.

1.3. Node-RED installieren:

• Sobald Sie als Root-Benutzer angemeldet sind, können Sie das offizielle Node-RED-Image in Version 2.2.2 mit dem folgenden Befehl installieren:

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

1.4. Beispiele installieren:

• Ich habe Node-RED-Container für PLCnext AXC F 1152 / 2152 erstellt, die Bibliotheken für die Arbeit mit PLCnext enthalten. Diese Container enthalten auch Beispiele für das Senden von Alarmen, Lesen und Schreiben über OPC UA. Um eines dieser Beispiele zu installieren, verwenden Sie die folgenden Befehle:

• Um das Beispiel „Alarm senden“ zu installieren:

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

• Um das Beispiel „OPC UA Lesen und Schreiben“ zu installieren:

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

1.5. Auf Node-RED zugreifen:

• Nach Abschluss können Sie Node-RED verwenden, indem Sie IP_PLC:1880 in Ihren Webbrowser eingeben. Wenn die IP-Adresse Ihrer SPS beispielsweise 192.168.1.10 ist, geben Sie 192.168.1.10:1880 ein.

WARNUNG: Im Gegensatz zu Docker läuft Podman nicht als Dienst innerhalb von PLCnext. Daher startet Node-RED nicht automatisch, wenn die SPS eingeschaltet wird. Um Node-RED mit der SPS starten zu lassen, folgen Sie diesen Schritten:

2. Schritte zum automatischen Start von Node-RED:

2.1. Startskript erstellen:

• Verwenden Sie den folgenden Befehl auf Ihrer SPS, um dieses Projekt herunterzuladen:

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

2.2. Datei verschieben:

• Verschieben Sie die Datei nodered.sh in den Pfad /etc/init.d/ mit dem folgenden Befehl:

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

2.3. Dateiberechtigungen ändern:

• Führen Sie den folgenden Befehl aus, um die Berechtigungen der Datei nodered.sh zu ändern:

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

2.4. Skript zum Autostart hinzufügen:

• Die Methode zum Hinzufügen des Skripts zum Autostart variiert je nach verwendeter Linux-Distribution. Im Fall von PLCnext sollten Sie den folgenden Befehl verwenden:

update-rc.d nodered.sh defaults 

• Durch Befolgen der obigen Schritte ist Node-RED bereit, bei jedem Ausschalten oder Neustart der PLCnext automatisch zu starten.

HINWEIS: Denken Sie daran, diese Schritte immer als Root-Benutzer durchzuführen.

3. Schritte zur Installation von Bibliotheken in Node-RED:

3.1. Node-RED starten und Container betreten:

• Als Root-Benutzer anmelden und folgende Befehle eingeben:

podman start nodered 

podman exec -it nodered /bin/bash 

cd /data 

3.2. Bibliothek installieren:

• Jetzt können Sie jede Bibliothek mit npm-Befehlen installieren, zum Beispiel:

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

3.3. Container verlassen und Node-RED neu starten:

• Wenn Sie fertig sind, geben Sie Exit ein und starten Sie Node-RED mit den folgenden Befehlen neu:

podman stop nodered 

podman start nodered 

4. Häufige Fehler

4.1. Fehler 1: mkdir no such file or directory

• Der folgende Fehler tritt auf, weil der admin-Benutzer nicht genügend Berechtigungen hat, um Node-RED zu installieren. Um das Problem zu lösen, müssen Sie sich als root-Benutzer anmelden.

4.2. Fehler 2: Zertifikat abgelaufen

• Der folgende Fehler tritt auf, weil die PLCnext die falsche Uhrzeit und das falsche Datum konfiguriert hat. Sie können Uhrzeit und Datum mit dem Befehl date überprüfen.
• Um die Uhrzeit auf der PLCnext zu ändern, verwenden Sie den folgenden Befehl:

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

• Denken Sie daran, den Befehl mit der aktuellen UTC-Zeit und -Datum zu ändern: https://time.is/es/UTC

4.3. Fehler 3: Failed, retrying timeout

• Dieser Fehler tritt auf, weil die PLCnext keinen Internetzugang hat. Sie können dies mit dem ping-Befehl überprüfen, zum Beispiel:

ping google.cl 

• Wenn bad address angezeigt wird, müssen Sie die IP-, Maske- und Gateway-Konfiguration der PLCnext überprüfen. Dies können Sie über den Webserver, Bereich Netzwerk, tun.

Weitere Informationen: https://github.com/Fellipem1/PLCnext_Node-RED