Guía del paquete 0.2.13

Guía de instalación del Edge Gateway · OEE Metrix 360

Para quien instala el gateway en la planta: el equipo de TI o de mantenimiento, con una cuenta de administrador del equipo. Cubre Windows (servicio, sin Docker) y Linux (Docker).

Notas de estado de la guíaQué se probó de esta versión y qué falta, con fecha.

Versión 0.1.3: conexión configurable, almacenamiento del buffer y desinstalación con datos pendientes (18/10/26). El asistente del .exe suma la página «Después de instalar», que cuenta cómo se conecta, se registra, se revisa y se desinstala el gateway. Al terminar de instalar, la página nueva «Conexión» deja elegir OEE Metrix 360 (recomendado) u otra dirección que indique TI (host, puerto, ruta base y proxy) y probarla antes de guardarla; en modo silencioso, con /HOST=, /PUERTO=, /RUTA= y /PROXY= (sección 5). La conexión se cambia sin reinstalar: el servicio prueba la nueva con su latido y, si OEE Metrix 360 no lo acepta en 2 minutos, regresa a la anterior. La ventana OEE Gateway suma las pestañas «Conexión», para probar y cambiar la conexión, y «Almacenamiento y comunicación», con el espacio, los pendientes y la autonomía estimada (secciones 5 y 6). Sin conexión, el buffer guarda lecturas hasta la reserva del disco (2 GB o el 10 %, la mayor) en lugar de un tope de 2 millones de lecturas. Lo ya enviado se conserva 2 h y lo pendiente nunca se borra por antigüedad (secciones 3 y 6). Al actualizar, lo pendiente se respalda si hay espacio y se queda en la PC, el instalador espera el latido del servicio y, si algo falla, regresa al programa anterior. Para pasar de una versión anterior, corre el .exe 0.1.3 encima: el gateway conserva su registro y su conexión (sección 8). Desinstalar ofrece «Quitar solo el programa» (por omisión) o «Quitar también los datos»; si quedan datos sin enviar, dice cuántos y desde cuándo, y ofrece «Respaldar primero y después borrar» (sección 10). Instalar ya no pide revisar a mano el archivo descargado: el .exe comprueba que llegó completo y los scripts revisan cada archivo del paquete antes de cambiar nada (sección 4). Estado: armado y probado en Linux, en el CI: las pruebas del gateway, del instalador y de los scripts. La prueba en Windows es .github/workflows/gateway-validar.yml (antes, gateway-windows.yml): en una máquina Windows de GitHub Actions y con una API de imitación, instala, registra como TI y con el QR (la ventana en modo de prueba, sin pantalla), cambia la conexión en caliente a HTTPS, actualiza con el .exe con datos pendientes y desinstala conservando y borrando los datos. .github/workflows/gateway-publicar.yml solo publica si esa prueba pasa con el commit que publica. Las páginas nuevas del .exe y del desinstalador solo se compilaron, y «Respaldar primero y después borrar» no se probó en Windows: falta abrirlas en una PC con pantalla y validarlo en planta. El .exe todavía no lleva firma de código.

Versión 0.1.2: registro con QR, hora automática y búsqueda en la red (18/10/26). Al terminar de instalar, el .exe abre la ventana OEE Gateway (también está en Inicio > OEE Gateway). La PC muestra un QR y un código de 8 caracteres; el Administrador de empresa lo escanea con su celular, compara el código, elige la planta y aprueba en OEE Metrix 360 (sección 5). Ya no hay que pasar un código secreto por chat ni escribirlo en una consola. La ventana también revisa la salida HTTPS, el proxy, la inspección TLS y la hora, y corrige la hora sola si está corrida 5 s o más (sección 3). Si el gateway fue revocado, lo dice y ofrece registrarlo de nuevo sin borrar nada (sección 11). Desde OEE Metrix 360, el gateway identifica un equipo por su IP («Detectar») y busca equipos en sus redes con permiso de TI («Buscar equipos en la red», sección 7); nunca lee ni escribe tags para eso. El código de 32 caracteres sigue igual para TI: instalación silenciosa, scripts del zip y Linux. Estado: probado en un Windows real de GitHub Actions (Windows Server) con una API de imitación: el zip y el .exe se arman ahí, con el NSIS 3.09 oficial; se instala, se registra como TI con enrolar.ps1 y con el QR (la ventana en modo de prueba, sin pantalla), arranca el servicio, late, se actualiza con el .exe (/S /HORA=no) y se desinstala (.github/workflows/gateway-windows.yml). En ese Windows también se midió la hora y se revisó que el gateway ve las redes de la PC. El ajuste real de la hora, «Detectar» y «Buscar equipos en la red» se probaron en Linux, con Windows y equipos simulados. Falta abrir la ventana con pantalla en una PC y validarlo en planta.

Primera PC real y versión 0.1.1 (16/10/26). En la primera PC del piloto el servicio no arrancaba (error 1053): la 0.1.0 dejaba pythonservice.exe en la raíz del entorno y desde ahí Python no carga los paquetes del gateway. La 0.1.1 lo deja en entorno\Scripts, junto a python.exe, y antes de dar de alta el servicio comprueba que arranca Python con esos paquetes. La prueba en Windows encontró la falla que venía justo después: el servicio arrancaba y caía al iniciar su ciclo, porque el bucle de asyncio corría en el hilo que da el administrador de servicios; la 0.1.1 lo corre en un hilo propio. Además, al registrarlo con el código de 32 caracteres, Ctrl+V ya pega el código (antes llegaba vacío) y un código incompleto se avisa sin gastarlo. Para pasar de la 0.1.0 basta correr el .exe nuevo encima (sección 8): el gateway conserva su identidad. Estado: probado en un Windows real de GitHub Actions (Windows Server) con una API de imitación: instalar con los scripts, registrar con enrolar.ps1, arrancar el servicio, latir, actualizar con el .exe en modo /S y desinstalar (.github/workflows/gateway-windows.yml). Falta validarlo en planta, en la PC del piloto, con la nube real. Lo que dicen las notas de abajo sobre «no probado en Windows» vale ahora solo para lo que esa prueba no cubre: las ventanas del .exe, estado.ps1, el respaldo, las credenciales de PLC y la lectura de PLC.

Estado (CI-F14, 14/10/26). El instalador de Windows está implementado, no probado en Windows: sus pruebas corrieron en Linux con pywin32 y kernel32 simulados, y los scripts de PowerShell pasaron reglas estáticas y, desde el 16/10/26, el analizador de PowerShell 7 en Linux (no el de Windows PowerShell 5.1). Lo mismo vale para la medición de CPU y RAM en Windows y para la espera al apagar Windows. La primera prueba real es la PC del piloto (CI-D03), siguiendo esta guía. El script de Linux se probó con un Docker simulado; la imagen del gateway se construyó con Docker real.

Endurecimiento para el piloto (14/10/26). El servicio corre con su cuenta virtual NT SERVICE\OEEGateway, ya no como LocalSystem (secciones 1, 5 y 8), y distingue la hora corrida de una revocación (sección 11). Estado: implementado; probado con mocks; no probado en Windows.

Python dentro del paquete (16/10/26). El zip trae Python 3.12.10 de 64 bits, el paquete oficial de la Python Software Foundation en nuget.org: ya no hay que instalar Python (secciones 3, 5 y 8). Estado: implementado; probado con mocks y con PowerShell 7 en Linux, que extrajo el Python real del paquete (1 322 archivos, todos idénticos); no probado en Windows: falta ver en la PC del piloto la revisión de la firma digital y el entorno creado con ese Python.

Instalador de un clic (16/10/26). oee-gateway-setup-0.1.1.exe lleva este mismo paquete y lo instala o actualiza con solo aceptar: prepara la PC, instala sin registrar, comprueba y deja accesos en el menú Inicio y la entrada de Configuración > Aplicaciones (secciones 5, 8 y 10). Estado: implementado; probado con mocks y con PowerShell 7 en Linux, y armado con NSIS en Linux, que da el mismo .exe cada vez; no probado en Windows. No lleva firma de código.

1. Qué se instala y qué no

El gateway lee los PLC de su red (solo lectura: no tiene ninguna función de escritura) y envía a la nube lo que pide la configuración aprobada. Solo hace conexiones de salida: HTTPS (443) a api.oeemetrix360.com, o a la dirección que indique TI (sección 5), y lectura hacia los PLC. No abre puertos de entrada y el instalador no crea reglas de firewall.

Windows (servicio)Linux (Docker)
ProgramaC:\Program Files\OEE Gateway (Python del paquete, entorno y scripts)Imagen oee-gateway:0.1.3
Datos: identidad, llave cifrada, conexión, bufferC:\ProgramData\OEE Gateway\datosVolumen datos (/var/lib/oee-gateway)
Credenciales de PLCC:\ProgramData\OEE Gateway\credenciales/run/secrets (secretos de Docker)
Clave que cifra la llaveC:\ProgramData\OEE Gateway\clave, protegida con DPAPI de la PCsecretos/clave_llave (0600)
RegistroC:\ProgramData\OEE Gateway\registros\gateway.log y Visor de eventosdocker compose logs
Quién lo correServicio OEEGateway con su cuenta virtual NT SERVICE\OEEGateway, sin sesión iniciadaContenedor sin root (usuario 10001)

La cuenta del servicio. NT SERVICE\OEEGateway es una cuenta virtual: existe mientras exista el servicio, la maneja Windows, no tiene contraseña y nadie inicia sesión con ella. El proceso del gateway corre con un solo privilegio, SeChangeNotifyPrivilege. Si alguien tomara ese proceso, no tendría los privilegios de SYSTEM.

En Windows, las carpetas quedan sin permisos heredados y nadie más entra:

CarpetaSYSTEM y AdministradoresCuenta del servicio
C:\ProgramData\OEE Gateway, con clave y credencialesControl totalSolo leer
C:\ProgramData\OEE Gateway\datos y registrosControl totalLeer, escribir y borrar (buffer, conexión y registro)
C:\Program Files\OEE GatewayControl totalLeer y ejecutar
Respaldos de respaldar.ps1Control totalNada

Lo que crea el servicio (el buffer y el registro) queda a su nombre, pero el servicio no puede cambiarle los permisos: una entrada de OWNER RIGHTS de solo lectura le quita al propietario ese derecho. La clave de la llave se guarda cifrada con DPAPI de la máquina: no sirve fuera de esta PC. Dentro de la PC la protege el permiso del archivo, que solo leen la cuenta del servicio, SYSTEM y Administradores. Por eso un respaldo solo se restaura en esta misma instalación (sección 9).

2. Lo que hace falta

  • Un Administrador de empresa de OEE Metrix 360 a la mano, con su celular o su computadora, para aprobar el registro. Con el .exe no hace falta ningún código antes de instalar: la PC muestra el suyo (sección 5).
  • Solo para instalar sin ventanas (/S), con los scripts del zip o en Linux: el código de registro de 32 caracteres. El Administrador de empresa lo genera en OEE Metrix 360, en Conectividad > Gateways > Registrar gateway, como «Código para TI (instalación silenciosa)». Sirve una sola vez, vence en 24 h y se muestra una sola vez: si se pierde, se revoca el gateway y se registra de nuevo. Pásalo por un canal privado. Nunca lo escribas en un correo, un ticket o un archivo.
  • El instalador oee-gateway-setup-0.1.3.exe o el paquete oee-gateway-windows-0.1.3.zip (Windows), o la imagen del gateway (Linux). Los dos se bajan sin cuenta de https://oeemetrix360.com/descargas/. No hay que comparar ningún SHA-256: el .exe revisa por sí mismo que llegó completo y los scripts del zip revisan cada archivo del paquete (sección 4).
  • Una cuenta de administrador del equipo.
  • Salida HTTPS (443) a api.oeemetrix360.com, o a la dirección que indique TI si publica un proxy inverso hacia OEE Metrix 360. Es lo único que el gateway necesita hacia afuera. No necesita Internet general: en Windows, Python y sus paquetes vienen dentro del zip. Si la red sale por un proxy, se escribe al instalar, en la página «Conexión» (sección 5).

No hace falta instalar Python ni Docker en Windows.

3. Preparar la PC con Windows

Windows 10 u 11, o Windows Server 2016 o posterior, de 64 bits (x64). Revisa cada punto antes de instalar.

  • No es la PC del HMI o del SCADA, salvo con permiso escrito de su administrador. El gateway agrega lecturas al PLC y cambios al equipo; en una PC de operación eso se coordina primero.

  • Siempre encendida y sin suspensión. En una consola de administrador:

    PowerShell
    powercfg /change standby-timeout-ac 0
    powercfg /change hibernate-timeout-ac 0
    powercfg /hibernate off

    En Administrador de dispositivos > Adaptadores de red > (la tarjeta de la red de PLC) > Administración de energía, desmarca «Permitir que el equipo apague este dispositivo para ahorrar energía».

    powercfg /hibernate off también apaga el inicio rápido de Windows 10 y 11. Con el inicio rápido, «Apagar» hiberna los servicios en vez de detenerlos, y el gateway no hace su parada ordenada. «Reiniciar» siempre los detiene.

    El instalador de un clic (sección 5) corre los tres powercfg y revisa la casilla de la tarjeta de red sin cambiarla: si está marcada, la deja como aviso.

  • Windows Update en una ventana de mantenimiento. Define las horas activas para que los reinicios caigan fuera de producción. Después de un reinicio, el servicio arranca solo (inicio automático retrasado) y envía lo que quedó en el buffer.

  • Hora sincronizada. La nube rechaza al gateway si su reloj se desvía más de 30 s. El instalador .exe y la ventana OEE Gateway la corrigen solos: miden el desfase contra OEE Metrix 360 y, con 5 s o más, arrancan el servicio de hora de Windows (W32Time) si está detenido y piden w32tm /resync /force. Si sigue corrida y la PC no está en un dominio, le ponen la hora de OEE Metrix 360. En una PC de dominio no cambian nada, porque la hora la manda el dominio: lo dicen y TI la corrige. Si W32Time está deshabilitado, no lo arrancan. Si la PC tiene SCADA o HMI, el ajuste se verá en sus registros como un salto de hora: el aviso dice de cuántos segundos. Para que el .exe no toque la hora: /HORA=no (sección 5). Para revisarla a mano: w32tm /query /status.

  • IP fija en la red de PLC. Lo ideal son dos tarjetas: una en la red de PLC (IP fija y sin puerta de enlace) y otra en la red de oficina, con salida a la API.

  • Sin enrutamiento entre la red de PLC y la de oficina. No actives «Conexión compartida a Internet» ni el enrutamiento de Windows. Revisa que IPEnableRouter siga en 0:

    PowerShell
    Get-ItemProperty HKLM:\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters -Name IPEnableRouter
  • Firewall. No hace falta ninguna regla de entrada. Hacia afuera: solo HTTPS 443 a api.oeemetrix360.com (o a la dirección que indique TI) y, hacia la red de PLC, los puertos de cada protocolo (OPC UA 4840, EtherNet/IP 44818, Modbus TCP 502, Siemens S7 102).

  • UPS recomendado. Un corte no pierde lo leído (el buffer es SQLite con escritura sincrónica), pero sin energía no hay lectura.

  • Disco. Deja al menos 1 GB libre en el disco del sistema para el programa y el buffer. Mejor más: el buffer guarda lo que no se ha enviado mientras no hay Internet.

    Desde la 0.1.3, el buffer deja libre una reserva para Windows y los demás programas: 2 GB o el 10 % del disco, la que sea mayor. Mientras el disco tenga más libre que la reserva, el buffer usa lo que sobra. Al llegar a ella deja de guardar lecturas nuevas hasta que vuelva a haber lugar: lo que lea mientras tanto no se guarda, y lo que ya tiene no se borra. Si el disco ya tiene menos libre que la reserva (por ejemplo, con 1 GB libre), el buffer todavía puede llegar a 256 MB, del orden de los 2 millones de lecturas que guardaba la 0.1.2, mientras queden más de 128 MB libres; el estado del disco pasa entonces a crítico. Con más espacio libre, el gateway aguanta más horas sin conexión: la ventana OEE Gateway muestra la autonomía estimada (sección 6). Lo pendiente nunca se borra por antigüedad ni por espacio; lo que OEE Metrix 360 ya confirmó se guarda 2 h y después se borra. La reserva y ese tiempo se cambian con «Ajustar…» en la ventana (sección 6).

Python: viene en el paquete

No hay que instalar Python. El zip trae Python 3.12.10 de 64 bits: el paquete oficial de la Python Software Foundation en nuget.org, sin modificar. Es la última versión de la serie 3.12 con binarios para Windows.

El instalador lo deja en C:\Program Files\OEE Gateway\python. No corre un instalador de Python, no toca el registro de Windows ni el PATH, y no afecta a otro Python que tenga la PC. Antes de usarlo revisa que python.exe y python312.dll tengan la firma digital de la Python Software Foundation.

Los scripts corren Python como administrador, y el servicio lo usa con la llave del gateway y las credenciales de PLC. Por eso Python va dentro de la carpeta del programa, que solo cambian SYSTEM y Administradores. El instalador lo revisa (revisar-codigo) y se detiene si alguien más puede modificarla.

Si la PC ya tiene un Python instalado, no estorba: el gateway usa el que trae el paquete. Un Python 3.12 instalado para una versión anterior del gateway se puede desinstalar después de actualizar (sección 8), si nada más lo usa.

4. Recibir y preparar el paquete

El instalador .exe no se prepara: no se desbloquea ni se descomprime, y se abre tal cual (sección 5). Al abrirse revisa por sí mismo que llegó completo; si está dañado o incompleto, no instala nada.

Con el zip:

  1. Clic derecho en el zip > Propiedades > marca Desbloquear, o usa Unblock-File .\oee-gateway-windows-0.1.3.zip.
  2. Descomprímelo, por ejemplo en C:\Instaladores\oee-gateway-windows-0.1.3. Adentro están:

    • instalar.ps1 y el resto de los scripts;
    • python\: Python 3.12.10 de 64 bits, el paquete oficial de la Python Software Foundation en nuget.org (sección 3);
    • wheels\ (los paquetes de Python) y requisitos.txt (versiones fijas con SHA-256);
    • THIRD_PARTY_NOTICES.txt: licencias y avisos de los paquetes de terceros, del Python y del pip que trae, y de dónde sale su código fuente;
    • esta guía, LEEME.txt y MANIFIESTO.sha256.

No hay que comparar el SHA-256 del zip: antes de instalar o actualizar, el script revisa cada archivo contra MANIFIESTO.sha256 y, si falta alguno o no coincide, se detiene sin instalar nada (sección 5).

Opcional, para TI: el SHA-256 de cada archivo. No es un paso de la instalación. En https://oeemetrix360.com/descargas/, en Descargar > Recursos técnicos (opcional), están el SHA-256 de cada archivo, su .sha256 y el comando para calcularlo. Sirve si TI quiere revisar un archivo por su cuenta, en PowerShell y en la carpeta de la descarga:

PowerShell
Get-FileHash .\oee-gateway-setup-0.1.3.exe -Algorithm SHA256
Get-FileHash .\oee-gateway-windows-0.1.3.zip -Algorithm SHA256

El SHA-256 se publica en el mismo sitio que el archivo: dice si llegó igual, pero no sustituye la firma digital.

El zip es reproducible. Armado dos veces desde el mismo commit, da el mismo SHA-256 en cualquier máquina, con Linux o con Windows: el CI lo arma en las dos y los compara. LEEME.txt dice de qué commit salió. Así, quien tenga una copia del repositorio puede armarlo de nuevo y comparar su SHA-256 con el publicado, si quiere auditarlo:

Bash
git checkout <commit de LEEME.txt>
cd edge/gateway && uv run python instalador/armar_paquete_windows.py

Lo logra así:

  • todo sale del commit, no de la carpeta de trabajo;
  • el Python, los paquetes de Python, hatchling y sus dependencias tienen versión fija y SHA-256;
  • la fecha de cada archivo es la del commit (SOURCE_DATE_EPOCH), no la del armado;
  • el zip va sin compresión, en orden y con permisos fijos;
  • el orden de los archivos y los fines de línea son los mismos en Linux y en Windows.

El .exe también es reproducible. Desde la 0.1.2, el que se publica se arma en Windows: en una máquina Windows de GitHub Actions, con NSIS 3.09 para Windows (el zip oficial, con SHA-256 fijo), que lo arma dos veces para comprobar que sale igual. En otra máquina Windows se instala y se prueba. Las dos cosas las hace .github/workflows/gateway-validar.yml, en cada PR y en main, cuando cambia el gateway. Lo publica .github/workflows/gateway-publicar.yml, con un tag gateway-v<versión> o a mano: antes corre esa misma validación con el commit que publica, firma el .exe solo si tiene el certificado de firma de código y crea el GitHub Release como versión preliminar (pre-release). Todavía no hay certificado: el .exe se publica sin firma. Para armarlo en otra PC con Windows, con NSIS 3.09 en el PATH y Git sin convertir fines de línea (git config --global core.autocrlf false antes de clonar):

PowerShell
cd edge\gateway; uv run python instalador\armar_instalador_windows.py --paquete dist\oee-gateway-windows-0.1.3.zip

La misma orden lo arma en Linux con NSIS 3 (en Debian y Ubuntu, el paquete nsis). El script revisa el zip contra su MANIFIESTO.sha256 antes de armarlo, y el .exe lleva exactamente esos archivos. Con el mismo zip y el mismo NSIS sale el mismo SHA-256: el .exe no guarda fechas de archivo ni rutas de la máquina que lo arma. El NSIS de Ubuntu y el de Windows son armados distintos de NSIS: cada uno da siempre el mismo .exe, pero no el mismo que el otro. Para comparar con el .exe publicado, ármalo en Windows con NSIS 3.09.

5. Instalar en Windows

Hay dos formas. El instalador de un clic (oee-gateway-setup-0.1.3.exe) es un asistente: explica lo que va a hacer, instala con un clic, deja elegir y probar la conexión y al final abre la ventana OEE Gateway para registrarlo con el QR. Los scripts del zip se corren en PowerShell y registran al final con el código de 32 caracteres. Instalan lo mismo; el .exe deja además accesos en el menú Inicio y la entrada para desinstalar desde Configuración > Aplicaciones.

Con el instalador de un clic

  1. Doble clic en oee-gateway-setup-0.1.3.exe. Como no lleva firma de código, Windows avisa dos veces:

    • SmartScreen, con «Windows protegió su PC»: Más información > Ejecutar de todos modos;
    • el Control de cuentas de usuario, con «Editor: Desconocido»: Sí. Hace falta una cuenta de administrador.
  2. Sigue el asistente con Siguiente. Antes de instalar explica qué se instala, dónde, cómo queda el servicio de Windows, qué conexiones usa y qué pasa después de instalar. Las carpetas son fijas: el programa va en C:\Program Files\OEE Gateway y los datos en C:\ProgramData\OEE Gateway; otro disco para los datos no está implementado en esta versión. Nada cambia en Windows hasta el clic en Instalar (o Actualizar, si ya está instalado).
  3. Al terminar de instalar aparece la página Conexión con OEE Metrix 360. Deja «OEE Metrix 360 (recomendado)», o elige «Otra dirección (TI)» y escribe el host, el puerto y la ruta base que te dé TI. El proxy, solo si la red de la planta lo pide. Probar conexión revisa la dirección, el DNS, la conexión, TLS y la respuesta de OEE Metrix 360. Siguiente la guarda solo si la prueba pasa; si no pasa, puedes seguir sin cambiarla y el gateway se queda con la de antes. Si no cambias nada, no se guarda nada.

Al hacer clic en Instalar, el .exe corre instalacion-automatica.ps1 con el paquete que lleva adentro, en cuatro pasos:

  1. Windows. Revisa que sea Windows 10 u 11, o Windows Server 2016 o posterior, de 64 bits.
  2. Energía y directivas. Corre los tres powercfg de la sección 3. Revisa, sin cambiar nada, el ahorro de energía de las tarjetas de red conectadas y la directiva «Iniciar sesión como servicio» (error 1069, sección 11).
  3. Instalar o actualizar. Si el servicio OEEGateway ya existe, corre actualizar.ps1 (sección 8). Si no, corre instalar.ps1 -SinEnrolar. Si encuentra un programa a medio instalar, sin servicio, antes lo quita con desinstalar.ps1, que conserva los datos.
  4. Comprobar y poner la hora. Revisa el servicio y su cuenta, la versión del programa y la salida HTTPS a la API, y corrige la hora de la PC si está corrida 5 s o más (sección 3).

Lo que haya que corregir queda como aviso y el gateway queda instalado igual: el resumen final lo dice y deja marcada la casilla «Ver el registro de la instalación». Si algo impide instalar, el .exe se detiene y muestra el error, sin crear los accesos ni la entrada de Aplicaciones.

Registrar con la ventana OEE Gateway. En una instalación nueva, el servicio queda dado de alta en Windows y detenido, y la última pantalla del .exe trae marcada la casilla «Abrir OEE Gateway para registrarlo». Si actualiza un gateway ya registrado, lo deja en marcha con su misma identidad y la casilla aparece sin marcar.

  1. Al terminar, se abre la ventana OEE Gateway. También está en Inicio > OEE Gateway > OEE Gateway (pide permiso de administrador).
  2. Arriba dice si el gateway está registrado y si el servicio está en marcha. La pestaña «Registro y revisión» trae el registro y la revisión: servicio, salida HTTPS, hora, proxy, inspección TLS e identidad, cada uno con ✓, ⚠ o ✗ y qué hacer.
  3. Sin registrar, muestra un QR, el código de 8 caracteres en dos grupos (por ejemplo K7QF-M2XP) y cuánto le queda: vence a los 15 min y la ventana pide otro sola.
  4. El Administrador de empresa escanea el QR con la cámara de su celular. Se abre OEE Metrix 360 en Conectividad > Gateways > Registrar, con su sesión, y muestra el código, el nombre de Windows, la IP pública y la huella de la llave de la PC. Compara el código con el de la pantalla de la PC, elige la planta, confirma y toca Registrar. Si no reconoce la PC, toca «No reconozco esta PC» y la ventana lo dice.
  5. Sin celular: «Copiar enlace» en la ventana, o en OEE Metrix 360 Conectividad > Gateways > Registrar con el código de la PC y escribir el código.
  6. La ventana ve sola la aprobación: aplica los permisos, pone el servicio en automático, lo arranca y dice en qué planta y con qué código quedó registrado (por ejemplo, GW-03).

El código de la PC no es secreto: no registra nada por sí solo, porque hace falta que un Administrador de empresa lo apruebe con su sesión, mirando la pantalla de la PC. La PC genera su llave y solo manda la parte pública; la llave privada nunca sale del equipo.

La ventana no dice «Conectado»: eso lo decide la nube con el latido (sección 6). Dice si OEE Metrix 360 aceptó a este gateway.

Cambiar la conexión después. En la ventana OEE Gateway, la pestaña «Conexión» muestra la conexión en uso y su estado, con su nombre, host, puerto, ruta base, dirección de la plataforma y proxy. Probar conexión revisa cada paso: la dirección, el DNS, la conexión TCP, TLS, la respuesta de OEE Metrix 360, la compatibilidad y, si el gateway ya está registrado, su firma y su identidad. Guardar y aplicar solo se puede después de una prueba que pasó con esos mismos valores. El servicio cambia de conexión sin reiniciarse y sin dejar de leer, y la da por buena con el primer latido que OEE Metrix 360 acepta. Si no lo acepta en 2 minutos, o rechaza su firma, el servicio regresa solo a la anterior. Restaurar configuración anterior vuelve a la de antes y la prueba.

Otra dirección solo sirve si TI publica un proxy inverso hacia OEE Metrix 360: su nube atiende solo el puerto 443, y cambiar el puerto aquí no configura ningún servidor. Si el host no es de oeemetrix360.com, la ventana y el .exe piden que TI lo confirme antes de enviarle la firma del gateway. El proxy se escribe como http://host:puerto, sin usuario ni contraseña. La conexión queda en C:\ProgramData\OEE Gateway\datos\conexion.json (la de antes, en conexion.anterior.json), no lleva secretos y manda sobre las variables OEE_GW_API_URL y HTTPS_PROXY del servicio.

Además de lo que dejan los scripts, el .exe deja:

DóndeQué
Inicio > OEE Gateway«OEE Gateway» (la ventana: registro, revisión, hora, conexión y almacenamiento) y «Registro de la instalación». Los dos piden permiso de administrador.
Configuración > Aplicaciones«OEE Gateway (Edge Gateway de OEE Metrix 360)», para desinstalar (sección 10).
C:\ProgramData\OEE Gateway\registros\instalacion.logLo que mostró cada instalación, actualización o desinstalación, una tras otra. Si la instalación falla antes de crear esa carpeta, el registro queda en %TEMP% y el .exe dice dónde.

Para TI, sin ventanas: oee-gateway-setup-0.1.3.exe /S, desde una consola de administrador. Termina en 0 si quedó instalado, con avisos o sin ellos (quedan en el registro), y en 2 si no se instaló. No abre la ventana: en una instalación nueva el gateway queda sin registrar, y se registra después con la ventana o con enrolar.ps1 y el código de 32 caracteres (sección 2). Con /HORA=no no toca la hora de la PC.

Con /HOST=, /PUERTO=, /RUTA= y /PROXY= prueba esa conexión y la guarda si pasa. Lo que no indiques queda como estaba (con otro host, puerto 443 y sin ruta base), y /RUTA= o /PROXY= vacíos quitan la ruta base o el proxy. Un host fuera de oeemetrix360.com se da por confirmado, porque lo escribió TI. Si esa conexión no pasa la prueba, el gateway queda instalado con la de antes y el .exe termina en 3. Si un valor lleva caracteres que no van en esa opción (por ejemplo, https:// en /HOST=), o el puerto no es un número de 1 a 65535, no instala nada y termina en 2:

PowerShell
(Start-Process .\oee-gateway-setup-0.1.3.exe -ArgumentList '/S' -Wait -PassThru).ExitCode
(Start-Process .\oee-gateway-setup-0.1.3.exe -ArgumentList '/S','/HORA=no' -Wait -PassThru).ExitCode
(Start-Process .\oee-gateway-setup-0.1.3.exe -ArgumentList '/S','/PROXY=http://proxy.planta.local:8080' -Wait -PassThru).ExitCode
(Start-Process .\oee-gateway-setup-0.1.3.exe -ArgumentList '/S','/HOST=oee.tuempresa.com','/RUTA=/oee' -Wait -PassThru).ExitCode

Con los scripts del zip

Abre Windows PowerShell como administrador (clic derecho > Ejecutar como administrador; la de 64 bits, no la «x86») y corre:

PowerShell
cd C:\Instaladores\oee-gateway-windows-0.1.3
powershell -NoProfile -ExecutionPolicy Bypass -File .\instalar.ps1

-ExecutionPolicy Bypass solo vale para ese proceso: no cambia la política del equipo. El script avanza en ocho pasos:

  1. Paquete. Revisa cada archivo contra MANIFIESTO.sha256.
  2. Python. Extrae el Python del paquete en C:\Program Files\OEE Gateway\python y revisa su firma digital (Python Software Foundation) y que sea 3.12 de 64 bits. No instala nada en Windows: no toca el registro ni el PATH.
  3. Entorno. Crea C:\Program Files\OEE Gateway\entorno e instala los paquetes del zip sin conexión, con versión fija y SHA-256 (pip --no-index --require-hashes). Tarda uno o dos minutos.
  4. Carpetas y clave. Crea C:\ProgramData\OEE Gateway con los permisos de la sección 1 y la clave de la llave cifrada con DPAPI.
  5. Servicio. Deja la carpeta del programa para SYSTEM y Administradores (el servicio solo la lee y ejecuta) y revisa que nadie más pueda cambiar Python ni el entorno. Después registra OEEGateway:

    • cuenta virtual NT SERVICE\OEEGateway, solo con SeChangeNotifyPrivilege;
    • origen OEEGateway en el Visor de eventos. Lo registra el instalador, porque la cuenta del servicio no puede escribir esa parte del registro de Windows;
    • inicio automático retrasado y reinicio ante fallas (al minuto, al minuto y luego cada 5 minutos). Un rechazo de la nube no cuenta como falla (sección 11).

    Al apagar Windows, el servicio recibe el aviso de preapagado y tiene hasta 30 s para la parada ordenada.

  6. Salida y hora. Consulta https://api.oeemetrix360.com/health: comprueba firewall, DNS e inspección TLS, y mide el desfase del reloj.
  7. Registro. Pide el código de 32 caracteres (sección 2), oculto: no se ve en pantalla y no queda en el historial, en los argumentos de ningún proceso ni en los registros. Llega a oee-gateway enrolar --codigo - por la entrada estándar. El gateway genera su llave y la nube solo guarda la pública.
  8. Arranque y estado. Arranca el servicio y muestra su estado, la cuenta con la que corre, que el proceso no escucha en ningún puerto, los permisos y las últimas líneas del registro. Si Windows no deja arrancar el servicio con su cuenta (error 1069), el instalador lo dice: ver la sección 11.

Opciones:

OpciónPara qué
-SinEnrolarInstala y da de alta el servicio sin registrar el gateway; luego se registra con la ventana OEE Gateway (QR) o con enrolar.ps1.
-Python C:\ruta\python.exeSolo si el Python del paquete no sirve en esta PC: otro Python 3.12 de 64 bits, instalado para todos los usuarios (C:\Program Files\Python312).
-ApiUrl https://...Solo laboratorio o preproducción: otra API. Queda en la configuración del servicio. Si ya hay conexion.json (por ejemplo, al reinstalar con los datos de antes), manda ese archivo.

Si la salida a la API o la hora fallan, el instalador no registra el gateway (así no gasta el código) y deja el servicio dado de alta y detenido. Corrige el problema y corre enrolar.ps1, o abre la ventana OEE Gateway, que corrige la hora sola. Si la red sale por un proxy, o por el proxy inverso de TI, guarda antes esa conexión en la pestaña «Conexión» o con conexion aplicar (abajo): el registro usa la conexión que quedó.

Esta guía y THIRD_PARTY_NOTICES.txt quedan en C:\Program Files\OEE Gateway. Los scripts quedan copiados en C:\Program Files\OEE Gateway\scripts, para usarlos sin el zip:

ScriptPara qué
estado.ps1Servicio, identidad, buffer y almacenamiento, puertos, permisos y últimas líneas del registro
ventana.ps1La ventana OEE Gateway: registro con QR, revisión, hora, conexión y almacenamiento
enrolar.ps1Registrar con el código de 32 caracteres si la instalación terminó sin registrar
credencial-plc.ps1 -Ref <ref>Guardar el usuario y la contraseña de un PLC
respaldar.ps1 -Destino <carpeta>Respaldar la carpeta de datos
restaurar-respaldo.ps1 -Origen <carpeta>Restaurar un respaldo (sección 9)
desinstalar.ps1Desinstalar (sección 10)
instalacion-automatica.ps1Lo que corre el .exe al instalar y al desinstalar; no hace falta correrlo a mano

Todos se corren igual: powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Program Files\OEE Gateway\scripts\estado.ps1".

La conexión desde la consola (TI). Son las órdenes que usa la ventana. En una consola de administrador ven lo mismo que el servicio: su conexion.json o, si no hay, las variables de su clave del registro.

PowerShell
$py = "C:\Program Files\OEE Gateway\entorno\Scripts\python.exe"
& $py -I -m oee_gateway.servicio_windows conexion mostrar
& $py -I -m oee_gateway.servicio_windows conexion probar --host oee.tuempresa.com --ruta-base /oee
& $py -I -m oee_gateway.servicio_windows conexion aplicar --host api.oeemetrix360.com --proxy http://proxy.planta.local:8080
& $py -I -m oee_gateway.servicio_windows conexion restaurar

probar no guarda nada. aplicar prueba y solo guarda si pasa. Guarda la conexión completa: lo que no escribas queda por omisión (puerto 443, sin ruta base y sin proxy). Con un host fuera de oeemetrix360.com, aplicar pide además --confirmar-host-externo, solo si TI confirma que es su proxy inverso hacia OEE Metrix 360. restaurar vuelve a la conexión anterior y la prueba.

6. Comprobar el registro y el latido

En OEE Metrix 360, en Conectividad > Gateways, el gateway aparece «Conectado», con su versión (0.1.3) y el último latido (cada 30 s). Si pasan más de 90 s sin recibir su latido, aparece «Sin Conexión»: revisa energía, red y la sección 11. Registrado con el QR, antes de su primer latido dice «Sin Conexión aún»; con el código de 32 caracteres, «Por registrar» hasta que la PC lo usa. La columna CPU / RAM muestra el uso de la PC. En Windows lo mide con GetSystemTimes y GlobalMemoryStatusEx (probado en el Windows de CI, falta en planta): si muestra «—», anótalo (sección 11).

Desde la PC, estado.ps1 muestra lo mismo del lado del equipo: código y nombre del gateway, API, lo pendiente de enviar y desde cuándo, numeración de lotes, el almacenamiento y la comunicación con OEE Metrix 360. Nunca muestra secretos.

El almacenamiento. La pestaña «Almacenamiento y comunicación» de la ventana OEE Gateway muestra el disco de los datos (capacidad, libre, reserva y lo que puede usar el gateway), lo pendiente de enviar y desde cuándo, cuánto se guarda lo ya enviado, la autonomía estimada y el estado del disco: normal, aviso, crítico o lleno. La autonomía es una estimación, con lo que el gateway escribió en el buffer en los últimos 15 minutos y 2 horas: cuántas horas podría seguir guardando sin conexión. Con menos de 10 minutos de datos dice «Estimación no disponible». La pestaña también dice si OEE Metrix 360 recibe lo que envía y cuál fue la última interrupción. «Ajustar…» cambia la reserva, el tiempo que se guarda lo ya enviado, una cuota opcional y los umbrales de aviso y de crítico. Un valor fuera de rango no se guarda. El servicio toma los valores nuevos solo, en unos segundos, sin reiniciar. Lo mismo, en una consola de administrador:

PowerShell
& "C:\Program Files\OEE Gateway\entorno\Scripts\oee-gateway.exe" almacenamiento mostrar
& "C:\Program Files\OEE Gateway\entorno\Scripts\oee-gateway.exe" almacenamiento ajustar --reserva-gb 4

Los valores quedan en C:\ProgramData\OEE Gateway\datos\almacenamiento.json.

La cuenta del servicio. estado.ps1 muestra cuenta NT SERVICE\OEEGateway y avisa si el servicio corre con otra. También se puede ver así, en una consola de administrador:

PowerShell
sc.exe qc OEEGateway        # SERVICE_START_NAME: NT SERVICE\OEEGateway
sc.exe qprivs OEEGateway    # PRIVILEGES: SeChangeNotifyPrivilege
sc.exe showsid OEEGateway   # SID S-1-5-80-1580687812-963777367-993479665-2757946564-3260688565

Ese SID es el que reciben los permisos de las carpetas. Windows lo calcula a partir del nombre del servicio, así que es el mismo en cualquier PC.

7. Encontrar los PLC, credenciales y certificado OPC UA

Detectar y Buscar equipos en la red

Desde la versión 0.1.2, el gateway ayuda a encontrar los PLC. Las dos cosas se piden desde OEE Metrix 360, nunca desde la PC, y quedan en la bitácora del gateway:

  • Detectar, en Conectar un PLC > Datos de conexión: escribes la IP del equipo (y su puerto, si lo sabes) y el gateway le pregunta, solo a esa IP, quién es. Prueba EtherNet/IP (44818), OPC UA (4840), Modbus TCP (502) y S7 (102), y llena el protocolo, el driver, el fabricante, el modelo, el firmware y la ranura o el endpoint con lo que el equipo responde.
  • Buscar equipos en la red, en la ficha del gateway: hace falta marcar «Tengo permiso de TI o del responsable de la red» cada vez. El gateway revisa solo las redes privadas de sus propias tarjetas, hasta 256 direcciones por red (/24), o un rango privado que escribas de ese tamaño o menor; nunca IP públicas. Va con calma: una conexión a la vez por equipo, 1 s por intento y un solo intento, y como máximo una búsqueda cada 10 min. La lista dice qué equipo ya está conectado y ofrece «Usar este equipo».

Para eso solo pide la identidad: ListIdentity de EtherNet/IP (una difusión por red y una pregunta a cada equipo con el 44818 abierto), GetEndpoints de OPC UA, la función 43 de Modbus y, en S7, solo si el puerto 102 está abierto. Nunca lee ni escribe tags, nunca recorre las variables y no cambia nada en los equipos. Aun así, para un sistema de detección de intrusos de la red de PLC la búsqueda se parece a un escaneo: avisa a TI antes de usarla. Detectar y Buscar necesitan el gateway 0.1.2 o posterior; con uno anterior, OEE Metrix 360 pide actualizarlo (sección 8).

Credenciales de PLC

Cada dispositivo configurado en la nube con una credencial_ref necesita su credencial en el equipo. Usa un usuario del PLC de solo lectura.

PowerShell
powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Program Files\OEE Gateway\scripts\credencial-plc.ps1" -Ref plc-llenadora
Restart-Service OEEGateway

El usuario se escribe a la vista; la contraseña, oculta. Las dos llegan a Python por la entrada estándar y quedan en C:\ProgramData\OEE Gateway\credenciales\plc-llenadora: las cambian SYSTEM y Administradores y el servicio solo las lee. Nunca salen del equipo.

Certificado OPC UA

Para OPC UA con seguridad («Firmar y cifrar»), el gateway necesita su propio certificado de cliente.

Desde la 0.2.7 no hace falta la consola: en la primera prueba de conexión con seguridad, si no existe, el gateway lo crea en C:\ProgramData\OEE Gateway\datos\opcua (la llave privada queda en esa carpeta, protegida para SYSTEM, Administradores y el servicio). A la nube manda solo la parte pública: en «Conectar PLC» › paso 4, Descargar certificado del gateway entrega el .der y los pasos para registrarlo como confiable en el servidor OPC UA (en un S7-1500, en TIA Portal: Administrador de certificados y «Clientes de confianza» del servidor OPC UA de la CPU). El nombre por omisión es opcua-cliente.

Si prefieres crearlo a mano (o con una versión anterior a la 0.2.7):

PowerShell
& "C:\Program Files\OEE Gateway\entorno\Scripts\oee-gateway.exe" certificado-opcua --nombre opcua-cliente --equipo PC-PLANTA

Desde la 0.2.7 el gateway lo usa desde datos\opcua; con una versión anterior, cópialo también a la carpeta de credenciales:

PowerShell
Copy-Item "C:\ProgramData\OEE Gateway\datos\opcua\opcua-cliente.*" "C:\ProgramData\OEE Gateway\credenciales\"

Registra el certificado como confiable en el servidor OPC UA. En la nube, usa opcua-cliente como «Certificado del gateway».

8. Actualizar a una versión nueva

Con el .exe nuevo: ábrelo como en la sección 5. Si encuentra el servicio, la última página antes de empezar dice «Listo para actualizar»; con el clic en Actualizar corre actualizar.ps1, que hace lo de abajo. Al terminar, la página «Conexión» muestra la conexión que ya usaba el gateway. Para TI, sin ventanas: /S y, solo si hay que cambiar la conexión, /HOST= y las demás (sección 5).

De una versión anterior a la 0.1.3: corre el .exe 0.1.3 encima. El gateway conserva su registro y su conexión: la que usaba (la de siempre, la de -ApiUrl o el proxy del servicio) queda en C:\ProgramData\OEE Gateway\datos\conexion.json.

De la 0.1.1 a la 0.1.2: corre el .exe 0.1.2 encima. El gateway conserva su registro y sigue en marcha. En Inicio > OEE Gateway quedan «OEE Gateway» y «Registro de la instalación»: se quitan «Enrolar el gateway» y «Estado del gateway», y enrolar.ps1 y estado.ps1 siguen en C:\Program Files\OEE Gateway\scripts.

Con los scripts: desbloquea el zip nuevo, descomprímelo en otra carpeta (sección 4) y, como administrador:

PowerShell
cd C:\Instaladores\oee-gateway-windows-<versión nueva>
powershell -NoProfile -ExecutionPolicy Bypass -File .\actualizar.ps1

El script avanza en ocho pasos:

  1. Paquete. Revisa cada archivo del paquete contra MANIFIESTO.sha256.
  2. Python. Extrae el Python del paquete nuevo junto al actual (python.nuevo) y revisa su firma, antes de detener nada.
  3. Detener el servicio. Lo detiene con la parada ordenada: lo pendiente queda en el buffer. Dice cuánto quedó pendiente.
  4. Respaldo del buffer. Lo copia en C:\ProgramData\OEE Gateway\datos\respaldos\actualizacion-<fecha>, solo si cabe sin bajar de la reserva del disco (sección 3), y deja solo la copia más reciente. Si no cabe, lo avisa y sigue.
  5. Entorno nuevo. Aparta el Python, el entorno y los scripts actuales (python.anterior, entorno.anterior y scripts.anterior), pone el Python nuevo en su lugar y crea un entorno nuevo. Aplica los permisos para la cuenta del servicio y registra de nuevo el servicio.
  6. Buffer y conexión. Lleva el buffer a su esquema nuevo, que solo agrega tablas: lo pendiente sigue igual. Pasa la conexión que usaba el servicio a conexion.json, sin borrarla del registro de Windows.
  7. Arranque y latido. Arranca el servicio y espera hasta 90 s a que OEE Metrix 360 acepte un latido. Si no llega (sin red, o la API no responde), solo lo avisa: el servicio sigue y envía lo pendiente cuando haya conexión. Un gateway sin registrar queda detenido hasta registrarlo.
  8. Estado. Muestra el estado (sección 6).

Si algo falla, o el servicio se detiene después de arrancar, vuelve solo a la versión anterior (su Python, su entorno y sus scripts) y la arranca. La identidad, la llave, el buffer y las credenciales se quedan donde están, y la versión anterior sigue leyendo el buffer: no hace falta registrarlo de nuevo. Si en el paso 6 cuenta menos pendientes que antes, lo avisa y, si hubo copia en el paso 4, dice dónde quedó: «El respaldo del buffer está en …, como estaba antes de actualizar: no lo borres.» Mientras el servicio está detenido, el PLC no se lee; elige un momento sin producción crítica.

Desde una instalación con Python aparte (la de antes del 16/10/26, con Python 3.12 instalado en C:\Program Files\Python312), actualizar.ps1 pasa al Python del paquete sin que haya que hacer nada. Aquel Python queda instalado: si nada más lo usa, se puede desinstalar desde Configuración > Aplicaciones («Python 3.12.10 (64-bit)»), después de que estado.ps1 muestre el servicio en marcha.

Desde una instalación que corre como LocalSystem (la de antes del 14/10/26), actualizar.ps1 también pasa el servicio a la cuenta virtual. No hay que hacer nada a mano:

  • primero da a NT SERVICE\OEEGateway los permisos de la sección 1 y después le cambia la cuenta al servicio;
  • la clave de la llave no cambia: la llave abre igual y el gateway sigue con la misma identidad;
  • si algo falla, además de volver al entorno anterior, le devuelve LocalSystem y los permisos de antes. Si el motivo fue el error 1069 (sección 11), corrígelo y vuelve a correr actualizar.ps1;
  • al terminar, estado.ps1 muestra cuenta NT SERVICE\OEEGateway, sin avisos.

9. Respaldo y restauración

Respaldar (con el servicio en marcha):

PowerShell
powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Program Files\OEE Gateway\scripts\respaldar.ps1" -Destino D:\Respaldos

Crea D:\Respaldos\oee-gateway-<código>-<fecha> con la identidad, la llave cifrada, el buffer (copiado con la API de respaldo de SQLite), los certificados OPC UA y, si la hay, la conexión (conexion.json y la anterior). La carpeta queda solo para SYSTEM y Administradores. Cópiala fuera de la PC y guárdala con acceso restringido. Las credenciales de PLC no entran al respaldo. Tampoco entran los valores de «Ajustar…» (almacenamiento.json): después de restaurar, ajústalos de nuevo si los habías cambiado (sección 6). La copia del buffer que deja actualizar.ps1 en datos\respaldos (sección 8) es otra cosa: solo trae el buffer de antes de actualizar.

La clave que abre la llave queda en esta PC, cifrada con DPAPI de la máquina. Por eso el respaldo solo sirve en esta misma instalación: después de un disco dañado, de un borrado o de una reinstalación que no borró los datos (sin -BorrarDatos ni «Quitar también los datos», sección 10). Si la PC se pierde o se reinstala Windows, revoca el gateway en la nube y registra uno nuevo.

Restaurar un respaldo del buffer es siempre, en este orden:

  1. detener el servicio;
  2. restaurar la carpeta de datos;
  3. correr oee-gateway marcar-restaurado;
  4. arrancar.

restaurar-respaldo.ps1 hace exactamente eso, después de revisar que el respaldo abra con la clave de esta instalación:

PowerShell
powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Program Files\OEE Gateway\scripts\restaurar-respaldo.ps1" -Origen D:\Respaldos\oee-gateway-GW-01-20261014-120000

Con marcar-restaurado, al arrancar los lotes se renumeran por encima del último que la nube ya recibió: nada se pierde y lo repetido no se duplica. La carpeta de datos que había no se borra: queda como datos.reemplazado-<fecha>. Si marcar-restaurado falla, no arranques el servicio: córrelo a mano y luego Start-Service OEEGateway.

PowerShell
Stop-Service OEEGateway
& "C:\Program Files\OEE Gateway\entorno\Scripts\oee-gateway.exe" marcar-restaurado
Start-Service OEEGateway

Nunca dos gateways con la misma identidad. Si un respaldo se restaura en un equipo, el original no puede seguir corriendo: detenlo y desinstálalo antes. Dos equipos con la misma identidad numeran lotes por separado y la nube los rechazaría o los mezclaría.

10. Desinstalar

Si se instaló con el .exe: Configuración > Aplicaciones > OEE Gateway > Desinstalar. El desinstalador pregunta qué quitar, y nada cambia hasta el clic en Desinstalar:

  • Quitar solo el programa (recomendado). Quita el servicio, C:\Program Files\OEE Gateway, los accesos de Inicio y la entrada de Aplicaciones. Conserva en C:\ProgramData\OEE Gateway la identidad, la llave, la conexión, el buffer y las credenciales de PLC.
  • Quitar también los datos. Antes detiene el servicio y revisa si queda algo sin enviar a OEE Metrix 360. Si no queda nada, pide confirmar y borra también los datos. Si queda algo, dice cuántos datos y desde cuándo; si no lo puede saber, lo trata como si quedara. Ofrece entonces «Conservar los datos y quitar solo el programa (recomendado)», «Respaldar primero y después borrar» o «Borrar sin respaldo», que pide confirmar porque lo pendiente se pierde. Mientras decides, el servicio queda detenido; si cancelas, vuelve a arrancar.

«Respaldar primero y después borrar» pide una carpeta (mejor otro disco o una memoria USB) y corre respaldar.ps1 (sección 9) antes de borrar. El desinstalador lo dice: «La clave que abre la llave se queda en esta PC y se borra con los datos: el respaldo conserva una copia de lo pendiente, pero este gateway ya no podrá enviarlo.» El respaldo lleva la identidad del gateway: cópialo fuera de la PC y guárdalo con acceso restringido.

Para TI, sin ventanas: & "C:\Program Files\OEE Gateway\desinstalar-oee-gateway.exe" /S quita solo el programa. Con /BORRARDATOS=si borra también los datos, pero solo si no queda nada sin enviar: si queda, no quita nada, deja el servicio como estaba y termina en 3. Con /BORRARDATOS=si /PERDERPENDIENTES=si los borra aunque quede algo sin enviar, y eso se pierde. El desinstalador sigue desde una copia en %TEMP%, así que la consola no espera a que termine. Para esperarlo y leer su código de salida, corre una copia con _?= y la carpeta del programa al final, sin comillas, y al terminar borra la copia:

PowerShell
Copy-Item "C:\Program Files\OEE Gateway\desinstalar-oee-gateway.exe" "$env:TEMP\desinstalar-oee-gateway.exe"
(Start-Process "$env:TEMP\desinstalar-oee-gateway.exe" -ArgumentList '/S /BORRARDATOS=si _?=C:\Program Files\OEE Gateway' -Wait -PassThru).ExitCode

Con el script, desde C:\ (no desde la carpeta que se borra), como administrador:

PowerShell
cd C:\
powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Program Files\OEE Gateway\scripts\desinstalar.ps1"

El script detiene el servicio con la parada ordenada, lo da de baja y borra C:\Program Files\OEE Gateway, con el Python del paquete. Conserva C:\ProgramData\OEE Gateway: si reinstalas en esta PC, el gateway sigue con la misma identidad y la misma conexión y envía lo pendiente, sin registrarlo de nuevo. Al desinstalar, con el .exe o con el script, lo que se puso a mano en la clave de registro del servicio, como SSL_CERT_FILE (sección 11), se va con el servicio: si reinstalas, ponlo de nuevo.

Para dejar de usarlo del todo, revócalo primero en la nube (Conectividad > Gateways > Revocar) y quita también los datos: «Quitar también los datos», /BORRARDATOS=si o el script con -BorrarDatos. Se borran la identidad, la llave, la conexión, el buffer y las credenciales de PLC. Antes revisa si queda algo sin enviar: si queda, o no se puede saber, no quita nada y el script termina en 3; con -PerderPendientes lo borra de todos modos, y lo pendiente se pierde. Para que lo pendiente llegue a OEE Metrix 360, espera a que el gateway lo envíe antes de borrar: un respaldo guarda una copia, pero después de borrar los datos este gateway ya no puede enviarla. El script pide confirmación; -Confirm:$false la omite.

11. Problemas frecuentes

SíntomaQué revisar
«La ejecución de scripts está deshabilitada»Corre los scripts con powershell -NoProfile -ExecutionPolicy Bypass -File .... Si una directiva de grupo exige scripts firmados (AllSigned), TI debe autorizarlos: hoy no están firmados.
«Windows protegió su PC» al abrir el .exeSmartScreen avisa porque el .exe no lleva firma de código: Más información > Ejecutar de todos modos. No hay que comparar su SHA-256: el .exe revisa por sí mismo que llegó completo. Si TI bloquea los programas sin firma, instala con los scripts del zip (sección 5).
El .exe termina con «PowerShell no pudo correr instalacion-automatica.ps1»Una directiva de grupo fija la política de ejecución de PowerShell, y pesa más que el -ExecutionPolicy Bypass del .exe: Get-ExecutionPolicy -List muestra AllSigned o Restricted en MachinePolicy o UserPolicy. Los scripts no están firmados: TI debe autorizarlos en esta PC.
El .exe terminó «con avisos»El gateway quedó instalado. Cada aviso dice qué corregir (tarjeta de red, «Iniciar sesión como servicio», salida HTTPS, hora o conexión) y queda en Inicio > OEE Gateway > Registro de la instalación.
«Abre PowerShell como administrador» o «de 64 bits»Clic derecho > Ejecutar como administrador, en «Windows PowerShell» (no «x86»).
«python.exe no tiene una firma digital válida» o «no lo firmó la Python Software Foundation»El Python del paquete está alterado: no lo uses. Vuelve a descargar o copiar el zip, desbloquéalo y descomprímelo de nuevo (sección 4).
Aviso: «firma de la Python Software Foundation, pero esta PC no pudo comprobar su cadena»Suele pasar en equipos sin Internet: les falta un certificado raíz de Microsoft. El instalador sigue, porque el SHA-256 del Python ya coincidió con el del paquete. Para que Windows compruebe la firma completa, TI puede actualizar los certificados raíz de la PC.
«… no respondió como Python 3.12» al instalarEl Python del paquete no arrancó en esta PC. Anota el mensaje completo y la versión de Windows (winver); si instalaste con el .exe, guarda también el registro de la instalación (sección 5). Mientras tanto, se puede instalar con otro Python 3.12 de 64 bits instalado para todos los usuarios: -Python "C:\Program Files\Python312\python.exe" (sección 5).
PROBLEMA: ... puede modificarlaLa carpeta del programa (con su Python), o el Python de -Python, se pueden modificar sin ser administrador. Instala sin -Python, con el Python del paquete. Si usas -Python, que sea uno instalado «para todos los usuarios» en C:\Program Files\Python312.
«El paquete está incompleto o alterado»Falta un archivo del paquete o no coincide con MANIFIESTO.sha256, y el script se detuvo sin instalar nada. Vuelve a descargar o copiar el zip, desbloquéalo y descomprímelo de nuevo (sección 4).
«Sin salida HTTPS»Probar conexión, en la pestaña «Conexión» de la ventana OEE Gateway, dice en qué paso falla: DNS, conexión, TLS o la respuesta de OEE Metrix 360. A mano: Test-NetConnection api.oeemetrix360.com -Port 443 (o el host que indicó TI). Revisa firewall, DNS y proxy.
Proxy corporativoLa ventana OEE Gateway lo revisa: si la salida directa falla y por el proxy de Windows funciona, ofrece «Usar el proxy de Windows para el servicio», que lo prueba y lo guarda en la conexión del gateway. A mano: en la pestaña «Conexión», o con conexion aplicar --proxy (sección 5). El proxy va sin usuario ni contraseña: el gateway no usa un proxy que los pida. Con conexion.json, la variable HTTPS_PROXY del servicio ya no cuenta.
Inspección TLS («certificate verify failed»; la ventana OEE Gateway lo marca, sin cambiar nada)Lo mejor: excluir de la inspección api.oeemetrix360.com (o el host que indicó TI). Si no se puede, agrega SSL_CERT_FILE=C:\ProgramData\OEE Gateway\credenciales\ca-corporativa.pem al servicio (ver abajo). Deja el certificado en esa carpeta: es donde la cuenta del servicio puede leerlo.
La pestaña «Conexión» dice «… se volvió a la conexión anterior»OEE Metrix 360 no aceptó un latido por la conexión nueva en 2 minutos, o rechazó la firma del gateway. El servicio regresó solo a la anterior, sin reiniciarse. El mensaje dice el último error: revisa con TI el host, la ruta base y el proxy inverso, y prueba otra vez.
El .exe con /S termina en 3El gateway quedó instalado, pero la conexión de /HOST=, /PUERTO=, /RUTA= o /PROXY= no pasó la prueba: sigue la de antes. El registro de la instalación dice qué paso falló (sección 5). Corrígela y pruébala en la pestaña «Conexión» o con conexion aplicar.
La pestaña «Almacenamiento y comunicación» dice «Estado del disco: lleno» o «disco lleno»El buffer dejó de guardar lecturas nuevas: lo que lea mientras tanto no se guarda, y lo que ya tiene no se borra. Libera espacio en el disco de la PC; si pusiste una cuota en «Ajustar…», súbela. Cuando vuelve a haber lugar, sigue guardando solo.
Advertencia en el Visor de eventos: «El reloj de este equipo va … s adelantado (o atrasado) respecto de la nube: la nube rechaza la firma del gateway»La hora de la PC se corrió. Ver Reloj corrido, debajo de esta tabla.
«Reloj desfasado» al instalar o al registrarLa ventana OEE Gateway y el .exe la corrigen solos (sección 3). Si la PC está en un dominio o W32Time está deshabilitado, no la tocan: TI corre w32tm /resync y revisa la fuente de hora (w32tm /query /source).
«El servicio se detuvo al arrancar»gateway.log y el Visor de eventos (Registros de Windows > Aplicación, origen OEEGateway).
Error en el Visor de eventos: «Ya hay otro proceso del gateway en marcha con la carpeta de datos de este servicio…»; el servicio queda detenidoSolo puede correr un gateway con esos datos, y el servicio no se reinicia solo por esto; lo pendiente sigue en el buffer. Cierra el otro, por ejemplo un oee-gateway ejecutar o un pythonservice.exe -debug abierto en una consola, y arranca con Start-Service OEEGateway.
Error en el Visor de eventos: «La nube rechazó a este gateway (…)», con la hora bien o sin poder medirla; el servicio queda detenidoLa nube rechazó la firma y no fue por la hora: lo más probable es que el gateway haya sido revocado. El servicio se detiene y no se reinicia solo, porque reiniciarlo no lo arregla. Revisa en Conectividad > Gateways, o abre la ventana OEE Gateway: si fue revocado, dice «Este gateway fue revocado en OEE Metrix 360» y ofrece Registrar de nuevo (ver abajo). Si no, revisa la hora y arranca con Start-Service OEEGateway.
Error 1069 al arrancar el servicio (error de inicio de sesión)La cuenta virtual no tiene el derecho «Iniciar sesión como servicio». Ver Error 1069, debajo de esta tabla.
estado.ps1 avisa: «El servicio corre con LocalSystem y no con su cuenta virtual»Es una instalación de antes del 14/10/26. Corre actualizar.ps1 desde el paquete nuevo (sección 8).
«Acceso denegado» o PermissionError en gateway.logLa cuenta del servicio no puede leer o escribir algo que necesita: vuelve a aplicar los permisos con proteger (fila de abajo). Un archivo que el servicio tenga que leer, como el certificado de SSL_CERT_FILE, va dentro de C:\ProgramData\OEE Gateway\credenciales: en otra carpeta la cuenta del servicio no tiene permiso.
«Está la llave del gateway ..., pero falta su clave»Se borró C:\ProgramData\OEE Gateway\clave: la llave ya no abre y lo pendiente ya no se puede enviar. Revoca el gateway, desinstala con -BorrarDatos -PerderPendientes y registra uno nuevo.
Aviso «Permisos de C:\ProgramData\OEE Gateway fuera de lo esperado» en el Visor de eventos, o PROBLEMA: en estado.ps1Alguien cambió los permisos, o faltan los de la cuenta del servicio. Vuelve a aplicarlos, como administrador: & "C:\Program Files\OEE Gateway\entorno\Scripts\python.exe" -I -m oee_gateway.servicio_windows proteger.
Los eventos de OEEGateway salen sin texto («No se encuentra la descripción del Id. de evento»)No quedó registrado el origen del Visor de eventos (el instalador lo avisa). Los eventos se escriben igual. Para registrarlo, vuelve a correr actualizar.ps1 desde el mismo paquete.
La parada tardaEl servicio cierra la lectura y guarda lo pendiente antes de detenerse; con la red caída puede tardar más. Los scripts esperan hasta 2 minutos. Al apagar Windows, la espera es de hasta 30 s: si no alcanza, Windows corta el proceso y lo pendiente queda en el buffer, que sigue consistente.
Al apagar, gateway.log no muestra la paradaRevisa el inicio rápido de Windows: si está activo, «Apagar» hiberna los servicios en vez de detenerlos. Desactívalo con powercfg /hibernate off (sección 3).
CPU / RAM «—» en la pantalla GatewaysLa medición de Windows no funcionó en esta PC. El gateway lee y envía igual. Anota la versión de Windows (winver) y guarda gateway.log.
En el celular: «Ese código no existe o ya venció. Revisa el que muestra la PC.»El código vence a los 15 min y la ventana pide otro sola. Escanea el QR que se ve ahora en la PC.
En el celular: «Solo el Administrador de empresa registra gateways»Pídele el registro a un Administrador de empresa de tu empresa.
La ventana dice que el registro se rechazóAlguien tocó «No reconozco esta PC» en OEE Metrix 360. Si la PC es tuya, pide un código nuevo en la ventana y avisa a quien aprueba.
La ventana o el celular dicen «Falta aplicar en la base el ajuste para registrar gateways con QR»La nube todavía no tiene el registro con QR. No se cambió nada. Mientras, registra con el código de 32 caracteres (sección 2).
OEE Metrix 360 dice «Este gateway tiene la versión … actualízalo a la 0.1.2 para usar Detectar y Buscar equipos»Corre encima el .exe de la versión más reciente (sección 8): conserva su registro y su conexión.
«Ya hay una búsqueda en curso» o que hay que esperar para buscar otra vezEl gateway busca una vez a la vez y como máximo una vez cada 10 min. Espera a que termine la que está en curso.

Reloj corrido. La nube rechaza la firma del gateway si la hora de la PC se aleja más de unos 30 s de la suya. Entonces el servicio sigue en marcha, pero no lee los PLC ni envía hasta que la hora se corrija; lo que ya está en el buffer se conserva. Vuelve a probar solo, al minuto, a los 5 min y luego cada 15 min: con la hora corregida, sigue sin que nadie lo arranque. Mientras tanto:

  • en el Visor de eventos (Registros de Windows > Aplicación, origen OEEGateway) queda una advertencia al empezar y luego una por hora, con el desfase medido y qué hacer;
  • gateway.log anota cada intento;
  • en la nube, el gateway pasa a «Sin Conexión».

Para corregirlo, abre la ventana OEE Gateway, que la corrige sola (sección 3). A mano, en una consola de administrador: w32tm /resync (si responde que el servicio no está iniciado, antes Start-Service w32time), y revisa con w32tm /query /status y w32tm /query /source. Para que el gateway pruebe enseguida: Restart-Service OEEGateway. Cuando la nube lo acepta de nuevo, queda un evento informativo: «El gateway volvió a conectarse con la nube». Si la hora se vuelve a correr, la PC no está sincronizando: TI le configura un servidor NTP (sección 3).

Registrar de nuevo un gateway revocado. Un gateway revocado no se reactiva. En la ventana OEE Gateway, Registrar de nuevo: detiene el servicio, aparta la identidad, la llave y el buffer en C:\ProgramData\OEE Gateway\datos\archivo\revocado-<fecha> (no borra nada, y lo hace solo si la nube confirma que está revocado) y muestra un QR nuevo para registrarlo con otro código de gateway. Las credenciales de PLC, los certificados OPC UA y la conexión se quedan donde están. Lo que estaba en el buffer sin enviar no se envía con el gateway nuevo.

Error 1069 (inicio de sesión del servicio). Para arrancar, la cuenta virtual necesita el derecho «Iniciar sesión como servicio» (SeServiceLogonRight). Normalmente lo tiene por NT SERVICE\ALL SERVICES (SID S-1-5-80-0), que Windows trae en esa directiva. Algunas guías de endurecimiento, como CIS nivel 2, la dejan en «Nadie», y entonces Windows no arranca el servicio: error 1069, y el motivo queda en el Visor de eventos, en Registros de Windows > Sistema. Para ver qué tiene esta PC, en una consola de administrador:

PowerShell
secedit /export /areas USER_RIGHTS /cfg "$env:TEMP\derechos.inf"
Select-String SeServiceLogonRight "$env:TEMP\derechos.inf"
Remove-Item "$env:TEMP\derechos.inf"

La línea debe incluir *S-1-5-80-0 o el SID de la cuenta del servicio (sección 6). Si no lo incluye, TI agrega NT SERVICE\ALL SERVICES o NT SERVICE\OEEGateway en la directiva que corresponda: Configuración del equipo > Configuración de Windows > Configuración de seguridad > Directivas locales > Asignación de derechos de usuario > Iniciar sesión como servicio. Si la directiva viene del dominio, el cambio se hace en el dominio, porque uno local se pierde en la próxima actualización de directivas. Después: Start-Service OEEGateway, o de nuevo actualizar.ps1 si la actualización volvió a la versión anterior. No le cambies la cuenta al servicio a mano (por ejemplo, a LocalSystem): el gateway funcionaría, pero sin este endurecimiento.

Certificado solo para el servicio. Las variables del servicio van en el valor Environment de su clave de registro. Este ejemplo agrega SSL_CERT_FILE y conserva las que ya hubiera, como OEE_GW_API_URL en laboratorio:

PowerShell
$clave = 'HKLM:\SYSTEM\CurrentControlSet\Services\OEEGateway'
$otras = @(@((Get-Item $clave).GetValue('Environment')) | Where-Object { $_ -and $_ -notlike 'SSL_CERT_FILE=*' })
Set-ItemProperty $clave -Name Environment -Type MultiString -Value ($otras + 'SSL_CERT_FILE=C:\ProgramData\OEE Gateway\credenciales\ca-corporativa.pem')
Restart-Service OEEGateway

El proxy ya no va aquí: va en la conexión del gateway, en la pestaña «Conexión» o con conexion aplicar --proxy (sección 5). Con conexion.json, las variables HTTPS_PROXY y OEE_GW_API_URL del servicio ya no cuentan. Estas variables se van con el servicio al desinstalar (sección 10).

Ver qué pasa en primer plano. Detén el servicio y córrelo en la consola con & "C:\Program Files\OEE Gateway\entorno\Scripts\pythonservice.exe" -debug OEEGateway. Corre con tu usuario de administrador y no con la cuenta del servicio: así no se ve un problema de permisos de NT SERVICE\OEEGateway. Si el servicio sigue en marcha, el de la consola no arranca: dice que otro proceso del gateway ya está en marcha con esa carpeta de datos. Se detiene con Ctrl+C. Al terminar, Start-Service OEEGateway.

12. Linux con Docker

Requisitos: Docker Engine con Docker Compose v2, salida HTTPS 443 a la API y acceso de lectura a la red de PLC. Mismas reglas de red que en Windows: sin puertos de entrada y sin enrutamiento entre redes.

Desde edge/gateway, donde está docker-compose.yml:

Bash
sudo instalador/linux/instalar.sh --extras "opcua modbus"             # construye la imagen con esos protocolos
sudo instalador/linux/instalar.sh --imagen oee-gateway-0.1.3.tar      # o carga una imagen entregada (docker save)

El script hace esto:

  1. Revisa Docker y Docker Compose v2.
  2. Carga o construye la imagen.
  3. Crea secretos/clave_llave si no existe: 0600, del usuario 10001 del contenedor.
  4. Pide el código de registro de 32 caracteres (sección 2), oculto, y lo pasa por la entrada estándar a docker compose run --rm -T gateway enrolar --codigo -.
  5. Arranca con docker compose up -d y muestra el estado.

Volver a correrlo, por ejemplo con una imagen nueva, conserva la clave y la identidad. Con --sin-enrolar instala sin registrar.

  • Estado: sudo docker compose run --rm gateway estado; registro: sudo docker compose logs -f gateway.
  • Conexión y almacenamiento: sudo docker compose run --rm gateway conexion mostrar y sudo docker compose run --rm gateway almacenamiento mostrar. Las órdenes conexion probar, conexion aplicar, conexion restaurar y almacenamiento ajustar son las de las secciones 5 y 6. La conexión queda en conexion.json, en el volumen de datos, y manda sobre OEE_GW_API_URL de docker-compose.yml.
  • Credenciales de PLC: cada una es un archivo secretos/<credencial_ref> con {"usuario": "...", "contrasena": "..."}, 0600 y del usuario 10001. Se declara como secreto del servicio en un docker-compose.override.yml:

    YAML
    services:
      gateway:
        secrets: [clave_llave, plc-llenadora]
    secrets:
      plc-llenadora:
        file: ./secretos/plc-llenadora
  • Respaldo: secretos/clave_llave y el volumen de datos. Sin la clave, la llave no abre.
  • Restaurar el buffer: el mismo procedimiento. docker compose down, restaurar el volumen de datos, docker compose run --rm gateway marcar-restaurado y docker compose up -d. Nunca dos gateways con la misma identidad.
  • Desinstalar: docker compose down conserva el volumen y la clave. Para borrarlo todo, primero revoca el gateway en la nube, luego docker compose down -v y borra secretos/.
  • Licencias de terceros: la imagen lleva /usr/share/doc/oee-gateway/THIRD_PARTY_NOTICES.txt, armado al construirla con lo que quedó instalado. Para leerlo: sudo docker compose run --rm --entrypoint cat gateway /usr/share/doc/oee-gateway/THIRD_PARTY_NOTICES.txt.

Volver al contenido · ¿Necesitas ayuda?