Stapsgewijze handleiding:Node-RED installeren op PLCnext met behulp van Podman

Hoe Node-RED in PLCnext te installeren 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 bij elke firmware-update ondergaat, werken deze procedures in de toekomst mogelijk niet meer. Als dit het geval is, wordt dit document bijgewerkt.

Aangemaakt op 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:

• U moet toegang krijgen via Putty of je favoriete SSH client met behulp van het IP-adres van uw PLC. Houd er rekening mee dat het standaard-IP 192.168.1.10 is .

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

1.2. Toegang als rootgebruiker:

• Zodra u bent ingelogd bij PLCnext, moet u toegang krijgen als rootgebruiker met behulp van het commando su

su

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

sudo passwd root

OPMERKING: De admin en root gebruikers zijn verschillend. Het instellen van een ander wachtwoord voor de rootgebruiker heeft geen invloed op de "admin"-gebruiker.

1.3. Node-RED installeren:

• Zodra u bent ingelogd als rootgebruiker, kunt u de officiële Node-RED-image in versie 2.2.2 installeren met behulp van de volgende opdracht:

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

1.4. Installatievoorbeelden:

• Voor de PLCnext AXC F 1152 / 2152 heb ik Node-RED-containers gemaakt met daarin bibliotheken om met PLCnext te werken. Deze containers bevatten ook voorbeelden van het verzenden van alarmen, schrijven en lezen met OPC UA. Om een van deze voorbeelden te installeren, gebruikt u de volgende opdrachten:

• Om het voorbeeld "Alarm verzenden" te installeren:

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

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

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

1,5. Toegang tot knooppunt-RED:

• Als u klaar bent, kunt u Node-RED gaan gebruiken door IP_PLC:1880 in te voeren in uw webbrowser. Als het IP-adres van uw PLC bijvoorbeeld 192.168.1.10 is, voert u 192.168.1.10:1880 in. .

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

2. Stappen om Node-RED automatisch te starten:

2.1. Maak een opstartscript:

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

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

2.2. Verplaats het bestand:

• Verplaats de nodered.sh bestand naar /etc/init.d/ pad met behulp van de volgende opdracht:

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

2.3. Bestandsrechten wijzigen:

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

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

2.4. Voeg het script toe aan het opstarten:

• De methode voor het toevoegen van het script aan het opstarten varieert afhankelijk van de Linux-distributie die u gebruikt. In het geval van PLCnext gebruikt u het volgende commando:

update-rc.d nodered.sh defaults

• Door de bovenstaande stappen te volgen, is Node-RED klaar om automatisch te starten telkens wanneer u de PLCnext uitschakelt of opnieuw opstart.

OPMERKING: Vergeet niet om deze stappen altijd uit te voeren met de rootgebruiker.

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

3.1. Start Node-RED en open de container:

• Ga naar als rootgebruiker en typ de volgende opdrachten:

podman start nodered

podman exec -it nodered /bin/bash

cd /data

3.2. Installeer de bibliotheek:

• Je kunt nu elke bibliotheek installeren met behulp van npm-opdrachten, bijvoorbeeld:

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

3.3. Verlaat de container en start Node-RED opnieuw:

• Als u klaar bent, typt u Exit en start u node-RED opnieuw met de volgende opdrachten:

podman stop nodered

podman start nodered

4. Veelvoorkomende fouten

4.1. Fout 1:mkdir geen dergelijk bestand of map

• De volgende fout treedt op omdat de admin gebruiker heeft niet voldoende rechten om Node-RED te installeren. Om het probleem op te lossen, moet u inloggen als root gebruiker.

4.2. Fout 2:Certificaat verlopen

• De volgende fout treedt op omdat de PLCnext de verkeerde tijd en datum heeft geconfigureerd. U kunt de tijd en datum controleren met date opdracht.
• Om de tijd op de PLCnext te wijzigen, gebruikt u het volgende commando:

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

• Vergeet niet om de opdracht aan te passen met de huidige UTC-tijd en -datum:https://time.is/es/UTC

4.3. Fout 3:Mislukt, time-out bij opnieuw proberen

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

ping google.cl

• Als er bad address staat moet u de IP-, masker- en gatewayconfiguratie van de PLCnext verifiëren. U kunt dit doen vanaf de webserver, sectie Netwerk.

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