Il sito C-Gate IoT Hub è fornito come software in formato container. Si consiglia di installare il sito C-Gate IoT Hub su un server centrale per ogni sede aziendale. In alternativa, è possibile anche l'installazione su un PC standard.

Requisiti di sistema

  • Ambiente di runtime per container (ad es. Docker, Kubernetes, OpenShift, Podman, ...)
  • 8 GB DI RAM
  • 128 GB di spazio su disco rigido
  • Processore a 64 bit (consigliati 4 core)
  • Connessione a Internet (durante l'installazione e l'aggiornamento)
Se sono collegati più di 25 controllori, i requisiti possono essere maggiori.

C-Gate IoT Hub Contenitore

Il contenitore C-Gate IoT Hub è fornito nel registro Docker da CLOOS. Riceverete i dati di accesso necessari al momento dell'acquisto di C-Gate IoT Hub .

Registro e URL immagine

docker.cloos.de/cgate

Esempio di ambiente di test con Docker

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

Esempio di ambiente produttivo 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:

Volumi

C-Gate memorizza tutte le configurazioni e i dati nella directory /data. Per questa directory è necessario utilizzare un volume per conservare i dati.

Porte esposte

  • 4840 (OPC UA Server)
  • 5000/tcp (Comunicazione robotica fino a V6)
  • 5000/udp (Comunicazione robotica fino a V6)
  • 5005 (Comunicazione robotica fino a V6)
  • 5010 (Comunicazione robotica fino a V6)
  • 5679 (IoT Connector RPC)
  • 8080 (Web Interface)

Variabili

APP_ADMIN_PASSWORD

Impone una password per l'utente admin.

Valore predefinito: Vuoto

APP_MAX_DATA_SIZE

Imposta la dimensione massima dei dati totali memorizzati da C-Gate in GB.

Valore predefinito: 32

Guida passo passo

Se non si utilizza ancora un ambiente di runtime per container, le istruzioni seguenti guidano l'utente attraverso i passi necessari per un ambiente di runtime per container di base con C-Gate. In questo caso, vi consigliamo comunque di familiarizzare con l'ambiente del container per poterlo utilizzare in modo sicuro.

  1. Installare Docker per la propria distribuzione Linux.
  2. Eseguire i seguenti comandi per installare e avviare 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
    # Inserire qui i dati di accesso ricevuti da CLOOS.
    sudo docker compose up -d
    # Lasciate che l'applicazione si avvii per qualche secondo.
    # Leggere la password generata per l'utente admin con il seguente comando:
    sudo docker logs cgate | grep UserInitializer

Si consiglia l'installazione su un sistema operativo Linux, in quanto i container sono già presenti da diversi anni. In Windows, invece, i container sono ancora una novità. Si devono quindi prevedere modifiche più frequenti, un consumo di risorse leggermente superiore e maggiori difficoltà durante la configurazione e il funzionamento.

  1. Assicurarsi che sia installato l'ultimo aggiornamento di Windows. È necessario almeno Windows 10 a partire dal numero di versione 2004 (Build 19041) o Windows 11.

    Per visualizzare la versione di Windows, è possibile eseguire il seguente comando alla riga di comando:
    winver
  2. Installare WSL (Windows Subsystem for Linux) con i seguenti comandi alla riga di comando:
    wsl --set-default-version 2
    # Di seguito, selezionare un nome utente e una password qualsiasi.
    # Non è necessario inserire qui i dati di accesso CLOOS.
    wsl --install -d Ubuntu
    wsl --set-default Ubuntu
  3. Installate C-Gate con il nostro programma di installazioneC-Gate IoT Hub per Windows.

Dopo l'installazione

I passi successivi e ulteriori informazioni sono disponibili sull'interfaccia web C-Gate. Dopo l'installazione, è possibile accedere a http://localhost sul server o sul PC.

Da un altro computer è possibile raggiungere C-Gate all'indirizzo http://[serverip], dove [serverip] deve essere sostituito dall'IP del vostro server o del PC su cui è stato installato C-Gate.

Domande frequenti

Dove sono conservati i dati di C-Gate?

In Docker, i dati sono solitamente memorizzati nei cosiddetti volumi. C-Gate utilizza uno di questi volumi per la directory interna /data.

Come posso creare un backup dei dati di C-Gate?

È possibile creare un backup dei dati con il seguente comando. Il backup viene memorizzato nella cartella in cui viene eseguito il comando.

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

# Ripristino del backup
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):
# Creare un backup
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

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

Per un backup giornaliero, ad esempio, è possibile utilizzare un cron job (Linux) o un'attività pianificata (Windows).

Per un backup coerente, si consiglia di arrestare brevemente l'applicazione (docker stop cgate) e di riavviarla dopo il backup (docker start cgate).

C-Gate mi chiede i dati di accesso quando lo avvio. Cosa devo inserire lì?

Per impostazione predefinita, quando viene installato C-Gate viene creato un utente con il nome admin. La password per questo utente viene generata al primo avvio del contenitore Docker e viene visualizzata sulla riga di comando. È possibile visualizzare l'output del contenitore Docker con il comando docker logs cgate. Il comando seguente fornisce l'output della generazione della password:

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

Con l'installazione di Windows, anche i dati di accesso vengono visualizzati una volta al termine dell'installazione.

Come posso reimpostare la mia password?

È possibile forzare una nuova password di amministrazione impostando la variabile di ambiente APP_ADMIN_PASSWORD='NewPassword' per il contenitore C-Gate. Per un'installazione Docker con Docker Compose, per esempio, è possibile impostare questa variabile nel file docker-compose.yml sotto la riga environment.

Esempio:

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

Se avete installato C-Gate con le nostre istruzioni per Windows, potete impostare la password nel file ~/.config/cgate/cgate.conf all'interno del WSL inserendo la seguente riga:

APP_ADMIN_PASSWORD="MySecretPassword"

Come si collegano i dispositivi a C-Gate?
  1. Innanzitutto, deve essere disponibile una connessione fisica. Per i sistemi robotici CLOOS, di solito si tratta di un cavo di rete collegato al controller del robot e alla rete aziendale. In alternativa, le unità di saldatura QINEO possono essere collegate via Wifi.
  2. I dispositivi necessitano quindi di un indirizzo IP e delle corrispondenti impostazioni di rete, in modo da poter essere raggiunti dal server o dal PC su cui è installato C-Gate IoT Hub . Per informazioni su come regolare le impostazioni di rete, consultare il manuale del dispositivo in questione. Le impostazioni di rete devono essere assegnate in base alla politica IT. È possibile verificare la connessione eseguendo un ping sull'IP del dispositivo dal server o dal PC con C-Gate.
  3. Seguire le istruzioni di C-Gate sull'interfaccia web di C-Gate per attivare la licenza. È quindi possibile configurare i dispositivi nella vista dispositivi di C-Gate. Inserire gli indirizzi IP corrispondenti dei dispositivi.

Se tutto è stato configurato correttamente, i dispositivi vengono visualizzati come online nella vista dei dispositivi di C-Gate.

Se non riuscite ancora a connettervi, consultate le nostre note sulle regole del firewall.

Quali regole e porte del firewall devono essere rispettate?

Le seguenti porte sono rilevanti per l'accesso a C-Gate IoT Hub :

Inbound 80 TCP Interfaccia web e API
Inbound 4840 TCP Server OPC UA per il collegamento dei vostri sistemi MES ed ERP
Inbound 5679 TCP Interfaccia RPC per C-Gate IoT Connector

Senza IoT Connector, C-Gate IoT Hub stabilisce inoltre connessioni alle seguenti porte:

In uscita 48010 TCP Sistemi robotici
In uscita 52341 TCP Apparecchiature di saldatura
In uscita 4840 TCP PLC

Con l'hardware QIROX Legacy (hardware precedente alla V7) vengono utilizzate le seguenti porte aggiuntive:

Inbound 5000 TCP
Inbound 5000 UDP
Inbound 5005 TCP
Inbound 5010 TCP

Come posso aggiornare C-Gate IoT Hub ?

C-Gate può essere aggiornato con una nuova immagine del contenitore.

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:

Nel menu Start, nella cartella C-Gate, è presente uno script di aggiornamento che esegue l'aggiornamento alla versione stabile corrente.

I dati esistenti vengono migrati automaticamente dall'applicazione quando vengono aggiornati. A seconda della quantità di dati, il processo di migrazione può ritardare di qualche minuto l'avvio della nuova versione dell'applicazione. L'applicazione non è disponibile in questo periodo.

Cosa c'è all'interno del contenitore C-Gate?

Il contenitore C-Gate IoT Hub è basato su un'immagine di base ufficiale di Ubuntu e contiene i seguenti servizi. Solo i servizi con una specifica porta corrispondente possono essere accessibili dall'esterno del contenitore. I servizi senza specifiche di porta possono essere accessibili solo all'interno del contenitore e sono quindi protetti dall'accesso esterno.

  • 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

Perché Windows blocca l'esecuzione dell'installazione di C-Gate?

I file .exe scaricati sono facilmente classificati come una minaccia da Windows. Per correggere la classificazione del file è possibile utilizzare il seguente comando Powershell:

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

Se l'installazione o l'esecuzione dei file di script inclusi è ancora bloccata, installare il nostro certificato Cloos nel sistema e riprovare. Assicurarsi di selezionare "Trusted Root Certification Authorities" come posizione per il certificato durante l'installazione.

Ho installato manualmente C-Gate su Windows utilizzando Docker Desktop. Come faccio a migrare i miei dati alla nuova versione con il programma di installazione di C-Gate?

Il nuovo programma di installazione C-Gate per Windows rileva automaticamente una precedente installazione con Docker Desktop e importa i dati durante l'installazione. Dopo l'installazione, verificare che l'installazione di C-Gate funzioni come di consueto. In seguito, eliminare il contenitore C-Gate da Docker Desktop, in modo che non venga riavviato automaticamente dopo un riavvio.

L'aggiornamento della mia installazione di C-Gate in Windows segnala un errore con i dati di accesso. Come posso risolvere questo problema?

Con una vecchia installazione di C-Gate in Windows, i dati di accesso al repository Docker di CLOOS non erano in parte memorizzati in modo permanente. Per risolvere il problema, eseguire il seguente comando nell'installazione di WSL (Ubuntu) e inserire i dati di accesso ricevuti con la licenza C-Gate:

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