Weld your way.

C-Gate IoT HubPrimeros pasos

C-Gate IoT Hub se suministra como software en formato contenedor. Se recomienda instalar C-Gate IoT Hub en un servidor central por empresa. Alternativamente, también es posible la instalación en un PC estándar.

Requisitos del sistema

  • Entorno de ejecución de contenedores (por ejemplo, Docker, Kubernetes, OpenShift, Podman, ...)
  • 8 GB RAM
  • 128 GB de espacio en disco duro
  • Procesador de 64 bits (se recomiendan 4 núcleos)
  • Conexión a Internet (durante la instalación y actualización)
Si se conectan más de 25 controladores, los requisitos pueden ser mayores.

C-Gate IoT Hub Contenedor

CLOOS proporciona el contenedor C-Gate IoT Hub en el Registro Docker. Recibirá los datos de acceso necesarios al comprar un C-Gate IoT Hub .

URL de registro e imagen

docker.cloos.de/cgate

Ejemplo de entorno de prueba con Docker

docker run -d --name cgate -p 80:8080 -p 4840:4840 docker.cloos.de/cgate

Ejemplo de entorno productivo con Docker Compose

version: "3"
services:
  cgate:
    container_name: cgate
    image: docker.cloos.de/cgate:latest
    restart: always
    ports:
      - "80:8080"
      - "4840:4840"
      - "5000:5000/tcp"
      - "5000:5000/udp"
      - "5005:5005"
      - "5010:5010"
      - "5679:5679"
    environment:
      - APP_MAX_DATA_SIZE_GB=64
    volumes:
      - data:/data
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
volumes:
  data:

Volúmenes

C-Gate almacena todas las configuraciones y datos en el directorio /data. Se debe utilizar un volumen para este directorio para persistir los datos.

Puertos expuestos

  • 4840 (OPC UA Server)
  • 5000/tcp (Comunicación entre robots hasta V6)
  • 5000/udp (Comunicación entre robots hasta V6)
  • 5005 (Comunicación entre robots hasta V6)
  • 5010 (Comunicación entre robots hasta V6)
  • 5679 (IoT Connector RPC)
  • 8080 (Web Interface)

Variables

APP_ADMIN_PASSWORD

Fuerza una contraseña para el usuario admin.

Valor por defecto: Vacío

APP_MAX_DATA_SIZE

Establece el tamaño máximo de los datos totales almacenados por C-Gate en GB.

Valor por defecto: 32

Guía paso a paso

Si aún no utiliza un entorno de ejecución de contenedores, las siguientes instrucciones le guiarán por los pasos necesarios para un entorno de ejecución de contenedores básico con C-Gate. En este caso, le recomendamos que, no obstante, se familiarice con el entorno de su contenedor para poder manejarlo con seguridad.

  1. Instale Docker para su distribución de Linux.
  2. Ejecute los siguientes comandos para instalar e iniciar C-Gate: 
    sudo mkdir -p /opt/cloos/cgate
cd /opt/cloos/cgate/
sudo curl -L https://c-gate.cloos.de/static/install/docker-compose.yml -o docker-compose.yml
sudo docker login docker.cloos.de
# Introduzca aquí los datos de acceso que ha recibido de CLOOS.
sudo docker compose up -d
# Espere unos segundos a que se inicie la aplicación.
# Lea la contraseña generada para el usuario admin con el siguiente comando:
sudo docker logs cgate | grep UserInitializer

Recomendamos una instalación en un sistema operativo Linux, ya que los contenedores ya están establecidos allí desde hace varios años. En Windows, en cambio, los contenedores son todavía una novedad. Por lo tanto, debe esperar cambios más frecuentes, un consumo de recursos ligeramente superior y más desafíos durante la configuración y el funcionamiento.

  1. Asegúrese de que está instalada la última actualización de Windows. Necesitas al menos Windows 10 a partir del número de versión 2004 (Build 19041) o Windows 11.

    Para mostrar la versión de Windows, se puede ejecutar el siguiente comando en la línea de comandos: 
    winver
  2. Instale WSL (Windows Subsystem for Linux) con los siguientes comandos en la línea de comandos: 
    wsl --set-default-version 2
# A continuación, seleccione cualquier nombre de usuario y contraseña.
# No es necesario introducir aquí los datos de acceso a CLOOS.
wsl --install -d Ubuntu
wsl --set-default Ubuntu
  3. Instale C-Gate con nuestro instaladorC-Gate IoT Hub para Windows.

Después de la instalación

Los pasos siguientes y más información se encuentran en la interfaz web C-Gate. Puede acceder a él tras la instalación en http://localhost en su servidor o PC.

Desde otro ordenador puede acceder a C-Gate en http://[serverip], donde [serverip] debe sustituirse por la IP de su servidor o PC en el que se haya instalado C-Gate.

Preguntas más frecuentes

¿Dónde se almacenan mis datos en C-Gate?

En Docker, los datos suelen almacenarse en los denominados volúmenes. C-Gate utiliza uno de estos volúmenes para el directorio interno /data.

¿Cómo puedo crear una copia de seguridad de mis datos en C-Gate?

Puedes crear una copia de seguridad de tus datos con el siguiente comando. La copia de seguridad se almacena en la carpeta donde se ejecuta el comando.

Linux (Docker): 
# Crear copia de seguridad
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Restaurar copia de seguridad
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"
Windows (WSL Ubuntu Shell): 
# Crear copia de seguridad
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Restaurar copia de seguridad
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"

Para una copia de seguridad diaria, por ejemplo, se puede utilizar una tarea cron (Linux) o una tarea programada (Windows).

Para obtener una copia de seguridad coherente, se recomienda detener brevemente la aplicación (docker stop cgate) y volver a iniciarla después de la copia de seguridad (docker start cgate).

C-Gate me pide los datos de acceso cuando lo inicio. ¿Qué tengo que introducir allí?

Por defecto, se crea un usuario con el nombre admin cuando se instala C-Gate. La contraseña para este usuario se genera la primera vez que se inicia el contenedor Docker y se muestra en la línea de comandos. Puede visualizar la salida del contenedor Docker con el comando docker logs cgate. El siguiente comando le proporciona la salida de la generación de contraseñas:

Linux (Docker): 
sudo docker logs cgate | grep UserInitializer
Windows (WSL Ubuntu Shell): 
podman logs cgate | grep UserInitializer

Con la instalación de Windows, los datos de acceso también se muestran una vez al final de la instalación.

¿Cómo puedo restablecer mi contraseña?

Puede forzar una nueva contraseña de administrador configurando la variable de entorno APP_ADMIN_PASSWORD='NewPassword' para su contenedor C-Gate. Para una instalación Docker con Docker Compose, por ejemplo, puede establecer esta variable en el archivo docker-compose.yml debajo de la línea environment.

Por ejemplo: 

...
  environment:
    - APP_ADMIN_PASSWORD="MySecretPassword"
...

Si ha instalado C-Gate con nuestras instrucciones para Windows, puede establecer la contraseña en el archivo ~/.config/cgate/cgate.conf dentro del WSL introduciendo la siguiente línea:

APP_ADMIN_PASSWORD="MySecretPassword"

¿Cómo conecto mis dispositivos a C-Gate?
  1. En primer lugar, debe existir una conexión física. En el caso de los sistemas robóticos CLOOS, suele tratarse de un cable de red conectado al controlador del robot y a la red de tu empresa. Los equipos de soldadura QINEO pueden conectarse alternativamente a través de Wifi.
  2. A continuación, sus dispositivos necesitan una dirección IP y la configuración de red correspondiente para que se pueda acceder a ellos desde el servidor o PC en el que está instalado C-Gate IoT Hub . Consulte el manual del dispositivo correspondiente para obtener información sobre cómo ajustar la configuración de red. La configuración de red debe asignarse de acuerdo con su política de TI. Puede comprobar la conexión ejecutando un ping en la IP del dispositivo desde el servidor o PC utilizando C-Gate.
  3. Siga las instrucciones de C-Gate en la interfaz web C-Gate para activar su licencia. A continuación, puede configurar sus dispositivos en la vista de dispositivos de C-Gate. Introduzca allí las direcciones IP correspondientes de los dispositivos.

Si todo está configurado correctamente, los dispositivos aparecerán como conectados en la vista de dispositivos de C-Gate.

Si sigue sin poder conectarse, consulte nuestras notas sobre las reglas del cortafuegos.

¿Qué reglas y puertos del cortafuegos deben respetarse?

Los siguientes puertos son relevantes para acceder a C-Gate IoT Hub :

Entrante 80 TCP Interfaz web y API
Entrante 4840 TCP Servidor OPC UA para la conexión de sus sistemas MES y ERP
Entrante 5679 TCP Interfaz RPC para C-Gate IoT Connector

Sin IoT Connector, el C-Gate IoT Hub establece además conexiones con los siguientes puertos:

Saliente 48010 TCP Sistemas robotizados
Saliente 52341 TCP Equipos de soldadura
Saliente 4840 TCP PLC

Con QIROX Legacy Hardware (hardware anterior a V7) se utilizan los siguientes puertos adicionales:

Entrante 5000 TCP
Entrante 5000 UDP
Entrante 5005 TCP
Entrante 5010 TCP

¿Cómo puedo actualizar C-Gate IoT Hub ?

C-Gate puede actualizarse con una nueva imagen de contenedor.

Linux (Docker):

cd /opt/cloos/cgate/
docker compose pull
docker compose up -d

Linux (Docker-Compose):

cd /opt/cloos/cgate/
docker-compose pull
docker-compose up -d
Windows:

En el menú Inicio, en la carpeta C-Gate hay un script de actualización que realiza una actualización a la versión estable actual.

La aplicación migra automáticamente los datos existentes cuando se actualizan. Dependiendo de la cantidad de datos, el proceso de migración puede retrasar unos minutos el inicio de la nueva versión de la aplicación. La aplicación no está disponible durante este tiempo.

¿Qué hay dentro del contenedor C-Gate?

El contenedor C-Gate IoT Hub está basado en una imagen base oficial actual de Ubuntu y contiene los siguientes servicios. Sólo se puede acceder desde fuera del contenedor a los servicios con la especificación de puerto correspondiente. A los servicios sin especificaciones de puerto sólo se puede acceder dentro del contenedor y, por tanto, están protegidos del acceso externo.

  • C-Gate IoT Hub Java Application (Port 4840/tcp, 5000/tcp/udp, 5005/tcp, 5010/tcp)
  • C-Gate IoT Hub NodeJS Graph-Converter Service
  • nginx Webserver (Port 8080/tcp)
  • mongoDB Database

¿Por qué Windows bloquea la ejecución de la instalación de C-Gate?

Los archivos .exe descargados son fácilmente clasificados como una amenaza por Windows. El siguiente comando Powershell se puede utilizar para corregir esta clasificación para el archivo:

cd Downloads
Unblock-File -Confirm:$false '.\C-Gate IoT Hub Setup.exe'

Si la instalación o la ejecución de los archivos de script incluidos sigue bloqueada, instale nuestro certificado Cloos en su sistema e inténtelo de nuevo. Asegúrese de seleccionar "Entidades de certificación raíz de confianza" como ubicación del certificado durante la instalación.

He instalado manualmente C-Gate en Windows utilizando Docker Desktop. ¿Cómo puedo migrar mis datos a la nueva versión con el instalador de C-Gate?

El nuevo instalador de C-Gate para Windows detecta automáticamente una instalación previa con Docker Desktop e importa los datos durante la instalación. Después de la instalación, asegúrese de que su instalación de C-Gate funciona como de costumbre. Después, elimine el contenedor C-Gate de Docker Desktop para que no vuelva a iniciarse automáticamente tras un reinicio.

La actualización de mi instalación C-Gate bajo Windows informa de un error con los datos de acceso. ¿Cómo puedo solucionarlo?

Con una instalación más antigua de C-Gate en Windows, los datos de acceso al repositorio Docker de CLOOS no se almacenaban de forma permanente en parte. Para solucionar el problema, ejecute el siguiente comando en su instalación WSL (Ubuntu) e introduzca los datos de acceso que recibió con su licencia C-Gate:

podman login --authfile=${HOME}/.docker/config.json docker.cloos.de