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/) está instalado en el sistema operativo PLCnext. Podman cumple la misma función que Docker. Esta implementación garantiza una instalación de Node-RED más sencilla para el usuario final.

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

Creado el 03-05-2024

Última modificación 11-03-2024

Requisitos

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

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

Firmware: 2023.0 LTS o superior

1. Pasos de instalación:

1.1. Accediendo mediante cliente SSH:

• Debes acceder usando Putty o tu SSH client favorito utilizando la IP de su PLC. Recuerda 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. Accediendo como usuario root:

• Una vez que haya iniciado sesión en PLCnext, deberá acceder como usuario root utilizando el comando su

su

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

sudo passwd root

NOTA: El admin y root Los usuarios 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. Ejemplos de instalación:

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

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

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

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

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

1.5. Accediendo a Node-RED:

• Una vez que haya terminado, puede comenzar 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 se ejecuta como un servicio dentro de PLCnext. Por lo tanto, Node-RED no se iniciará automáticamente cuando se encienda el PLC. Para hacer que Node-RED inicie con el PLC, siga estos pasos:

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

2.1. Crea un script de inicio:

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

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

2.2. Mover el archivo:

• Mover el nodered.sh archivo al /etc/init.d/ ruta usando el siguiente comando:

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

2.3. Cambiar permisos de archivos:

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

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 según la distribución de Linux que esté utilizando. En el caso de PLCnext, deberás utilizar el siguiente comando:

update-rc.d nodered.sh defaults

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

NOTA: Recuerda realizar siempre estos pasos utilizando el usuario root.

3. Pasos para instalar bibliotecas 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. Instalar la biblioteca:

• Ahora puedes instalar cualquier biblioteca 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 Salir y reinicie node-RED con los siguientes comandos:

podman stop nodered

podman start nodered

4. Errores comunes

4.1. Error 1:mkdir no existe tal archivo o directorio

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

4.2. Error 2:Certificado caducado

• El siguiente error se produce porque PLCnext tiene configurada la fecha y la hora incorrectas. Puedes consultar la hora y la fecha con el date comando.
• Para cambiar la hora en el PLCnext, utilice el siguiente comando:

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

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

4.3. Error 3:error, reintento del tiempo de espera

• Este error se produce porque PLCnext no tiene acceso a Internet. Puedes comprobar esto con el ping comando, por ejemplo:

ping google.cl

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

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