Guía Paso a Paso: Instalación de Node-RED en PLCnext Usando Podman

Cómo instalar Node-RED en PLCnext con Podman

Desde el firmware 2023.0, Podman (https://podman.io/) ha sido instalado en el sistema operativo PLCnext. Podman cumple la misma función que Docker. Esta implementación garantiza una instalación más simple de Node-RED para el usuario final.

IMPORTANTE: Debido a los cambios que PLCnext experimenta con cada actualización de firmware, estos procedimientos pueden dejar de funcionar en el futuro. Si es el caso, este documento será actualizado.

Creado 05-03-2024

Última modificación 11-03-2024

Requisitos

Controlador: AXC F 1152 - AXC F 2152 - AXC F 3152

Almacenamiento: Memoria SD 2GB o superior para AXC F 1152 / 2152

Firmware: 2023.0 LTS o superior

1. Pasos de instalación:

1.1. Acceso vía cliente SSH:

• Debe acceder usando Putty o su cliente SSH favorito usando la IP de su PLC. Recuerde que la IP por defecto es 192.168.1.10.

• Inicie sesión con el nombre de usuario admin y la contraseña de su PLCnext.

1.2. Acceso como usuario root:

• Una vez que haya iniciado sesión en el PLCnext, necesita acceder como usuario root usando el comando su

su

• Si no ha creado una contraseña root aún, créela con el comando sudo passwd root

sudo passwd root

NOTA: Los usuarios admin y root son diferentes. Establecer una contraseña diferente para el usuario root no afectará al usuario "admin".

1.3. Instalación de Node-RED:

• Una vez que haya iniciado sesión como usuario root, puede instalar la imagen oficial de Node-RED en su versión 2.2.2 usando el siguiente comando:

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

1.4. Instalación de Ejemplos:

• He creado contenedores Node-RED para PLCnext AXC F 1152 / 2152 que incluyen librerías para trabajar con PLCnext. Estos contenedores también incluyen ejemplos de envío de alarmas, lectura y escritura usando OPC UA. Para instalar cualquiera de estos ejemplos, use los siguientes comandos:

• Para instalar el ejemplo "Envío de Alarmas":

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

• Para instalar el ejemplo "Lectura y escritura OPC UA":

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

1.5. Acceso a Node-RED:

• Una vez terminado, puede empezar a usar Node-RED ingresando IP_PLC:1880 en su navegador web. Por ejemplo, si la dirección IP de su PLC es 192.168.1.10, ingresaría 192.168.1.10:1880.

ADVERTENCIA: A diferencia de Docker, Podman no corre como servicio dentro de PLCnext. Por lo tanto, Node-RED no se iniciará automáticamente cuando el PLC se encienda. Para hacer que Node-RED inicie con el PLC, siga estos pasos:

2. Pasos para iniciar Node-RED automáticamente:

2.1. Cree un script de inicio:

• Use el siguiente comando en su PLC para descargar este proyecto:

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

2.2. Mueva el archivo:

• Mueva el archivo nodered.sh a la ruta /etc/init.d/ usando el siguiente comando:

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

2.3. Cambie permisos del archivo:

• Ejecute el siguiente comando para cambiar los permisos del archivo nodered.sh:

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

2.4. Agregue el script al inicio:

• El método para agregar el script al inicio varía dependiendo de la distribución de Linux que use. En el caso de PLCnext, debe usar el siguiente comando:

update-rc.d nodered.sh defaults

• Siguiendo los pasos anteriores, Node-RED estará listo para iniciar automáticamente cada vez que apague o reinicie el PLCnext.

NOTA: Recuerde siempre realizar estos pasos usando el usuario root.

3. Pasos para instalar librerías en Node-RED:

3.1. Inicie Node-RED y acceda al contenedor:

• Acceda como usuario root y escriba los siguientes comandos:

podman start nodered
podman exec -it nodered /bin/bash
cd /data

3.2. Instale la librería:

• Ahora puede instalar cualquier librería usando comandos npm, por ejemplo:

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

3.3. Salga del contenedor y reinicie Node-RED:

• Una vez terminado, escriba Exit y reinicie node-RED con los siguientes comandos:

podman stop nodered
podman start nodered

4. Errores Comunes

4.1. Error 1: mkdir no such file or directory

• El siguiente error ocurre porque el usuario admin no tiene suficientes privilegios para instalar Node-RED. Para resolver el problema, debe iniciar sesión como usuario root.

4.2. Error 2: Certificado Expirado

• El siguiente error ocurre porque el PLCnext tiene la hora y fecha mal configuradas. Puede verificar la hora y fecha con el comando date.
• Para cambiar la hora en el PLCnext, use el siguiente comando:

date -s "29 FEB 2024 11:25:39"

• Recuerde modificar el comando con la hora y fecha UTC actual: https://time.is/es/UTC

4.3. Error 3: Failed, retrying timeout

• Este error ocurre porque el PLCnext no tiene acceso a internet. Puede verificarlo con el comando ping, por ejemplo:

ping google.cl

• Si dice bad address, debe verificar la configuración de IP, máscara y Gateway del PLCnext. Puede hacer esto desde el servidor web, sección Red.

Más información: https://github.com/Fellipem1/PLCnext_Node-RED