Stapsgewijze handleiding: Node-RED installeren op PLCnext met Podman

Hoe Node-RED te installeren in PLCnext met Podman

Sinds firmware 2023.0 is Podman (https://podman.io/) geïnstalleerd op het PLCnext-besturingssysteem. Podman vervult dezelfde functie als Docker. Deze implementatie garandeert een eenvoudigere Node-RED-installatie voor de eindgebruiker.

BELANGRIJK: Vanwege de veranderingen die PLCnext ondergaat met elke firmware-update, kunnen deze procedures in de toekomst stoppen met werken. Als dat het geval is, zal dit document bijgewerkt worden.

Aangemaakt 05-03-2024

Laatst gewijzigd 11-03-2024

Vereisten

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

Opslag: SD-geheugen 2GB of hoger voor AXC F 1152 / 2152

Firmware: 2023.0 LTS of hoger

1. Installatiestappen:

1.1. Toegang via SSH-client:

• Je moet toegang krijgen met Putty of je favoriete SSH-client met het IP van je PLC. Onthoud dat het standaard IP 192.168.1.10 is.

• Log in met de gebruikersnaam admin en het wachtwoord van je PLCnext.

1.2. Toegang als root-gebruiker:

• Eenmaal ingelogd op de PLCnext, moet je toegang krijgen als root-gebruiker met het commando su

su 

• Als je nog geen root-wachtwoord hebt aangemaakt, maak het dan met het commando sudo passwd root

sudo passwd root 

LET OP: De admin en root gebruikers zijn verschillend. Een ander wachtwoord instellen voor de root-gebruiker beïnvloedt de "admin"-gebruiker niet.

1.3. Node-RED installeren:

• Eenmaal ingelogd als root-gebruiker, kun je de officiële Node-RED-image in versie 2.2.2 installeren met het volgende commando:

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

1.4. Voorbeelden installeren:

• Ik heb Node-RED-containers gemaakt voor de PLCnext AXC F 1152 / 2152 die bibliotheken bevatten om met PLCnext te werken. Deze containers bevatten ook voorbeelden van het sturen van alarms, lezen en schrijven met OPC UA. Om een van deze voorbeelden te installeren, gebruik de volgende commando's:

• Om het "Alarm sturen"-voorbeeld te installeren:

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

• Om het "Lezen en schrijven OPC UA"-voorbeeld te installeren:

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

1.5. Node-RED benaderen:

• Eenmaal klaar, kun je Node-RED gaan gebruiken door IP_PLC:1880 in je webbrowser in te voeren. Bijvoorbeeld, als het IP-adres van je PLC 192.168.1.10 is, voer je 192.168.1.10:1880 in.

WAARSCHUWING: In tegenstelling tot Docker, draait Podman niet als een service binnen PLCnext. Daarom start Node-RED niet automatisch wanneer de PLC aangezet wordt. Om Node-RED te laten starten met de PLC, volg deze stappen:

2. Stappen om Node-RED automatisch te starten:

2.1. Een opstartscript aanmaken:

• Gebruik het volgende commando op je PLC om dit project te downloaden:

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

2.2. Het bestand verplaatsen:

• Verplaats het nodered.sh bestand naar het /etc/init.d/ pad met het volgende commando:

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

2.3. Bestandsrechten wijzigen:

• Voer het volgende commando uit om de rechten van het nodered.sh bestand te wijzigen:

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

2.4. Het script toevoegen aan opstart:

• De methode om het script toe te voegen aan opstart varieert afhankelijk van de Linux-distributie die je gebruikt. In het geval van PLCnext, moet je het volgende commando gebruiken:

update-rc.d nodered.sh defaults 

• Door de bovenstaande stappen te volgen, is Node-RED klaar om automatisch te starten elke keer dat je de PLCnext uitschakelt of herstart.

LET OP: Vergeet niet om deze stappen altijd als root-gebruiker uit te voeren.

3. Stappen om bibliotheken in Node-RED te installeren:

3.1. Node-RED starten en de container benaderen:

• Log in als root-gebruiker en voer de volgende commando's uit:

podman start nodered 

podman exec -it nodered /bin/bash 

cd /data 

3.2. De bibliotheek installeren:

• Nu kun je elke bibliotheek installeren met npm-commando's, bijvoorbeeld:

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

3.3. De container verlaten en Node-RED herstarten:

• Eenmaal klaar, typ Exit en herstart Node-RED met de volgende commando's:

podman stop nodered 

podman start nodered 

4. Veelvoorkomende fouten

4.1. Fout 1: mkdir no such file or directory

• Deze fout treedt op omdat de admin-gebruiker niet genoeg privileges heeft om Node-RED te installeren. Om het probleem op te lossen, moet je inloggen als root-gebruiker.

4.2. Fout 2: Certificaat verlopen

• Deze fout treedt op omdat de PLCnext de verkeerde tijd en datum geconfigureerd heeft. Je kunt de tijd en datum controleren met het date-commando.
• Om de tijd op de PLCnext te wijzigen, gebruik het volgende commando:

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

• Onthoud om het commando aan te passen met de huidige UTC-tijd en -datum: https://time.is/es/UTC

4.3. Fout 3: Failed, retrying timeout

• Deze fout treedt op omdat de PLCnext geen internettoegang heeft. Je kunt dit controleren met het ping-commando, bijvoorbeeld:

ping google.cl 

• Als het bad address zegt, moet je de IP-, masker- en gateway-configuratie van de PLCnext verifiëren. Je kunt dit doen via de webserver, Netwerk-sectie.

Meer informatie: https://github.com/Fellipem1/PLCnext_Node-RED