Assistenza agli utenti

L'interfaccia web offre diverse opzioni per la visualizzazione dei dati e la gestione di C-Gate. Questo può essere richiamato con tutti i browser web attuali con l'indirizzo associato. Se il vostro browser non è compatibile, ne sarete informati sull'interfaccia web e riceverete una raccomandazione.

I dati di processo possono essere visualizzati solo se si dispone di un programma Carola con il vecchio concetto di elenco o se si lavora con il nuovo concetto di elenco QTI e la versione del software di controllo è QS2.8 o più recente.

Confrontate le procedure del vostro programma MASTER con la documentazione e adattatela di conseguenza. Assicurarsi di utilizzare le procedure SEAMSTRT e SEAMEND se si utilizza il modulo C-Gate.QM.

L'efficacia complessiva delle apparecchiature (OEE) è composta dalle metriche disponibilità, prestazioni e qualità. La produttività di QINEO consiste nelle metriche disponibilità e prestazioni. Il calcolo esatto è riportato nella documentazione corrispondente.

La disponibilità metrica dipende dalla pianificazione della capacità, che corrisponde al tempo di lavoro pianificato. Ad esempio, non appena l'impianto o l'apparecchiatura viene spenta, l'impianto viene considerato non disponibile. Per la metrica delle prestazioni, è importante che i programmi dei componenti siano dotati delle istruzioni documentate di Carola e che i tempi target siano stati inseriti in modo appropriato nei modelli dei componenti. La metrica della qualità viene determinata automaticamente, tramite i dati di processo, o manualmente, tramite un'immissione da parte dell'operatore sulla macchina. Per la determinazione automatica sono necessari QS2.8 o più recente, il monitoraggio QTI e SD e il modulo C-Gate.QM.

L'orario di C-Gate può essere impostato nelle impostazioni dell'interfaccia web. Sincronizzare l'ora manualmente o inserire un server orario per la sincronizzazione automatica.

Le funzioni di C-Gate sono suddivise in moduli, ognuno dei quali deve essere autorizzato. Contattare CLOOS per la licenza di ulteriori moduli o installazioni.

La gestione del programma C-Gate può essere utilizzata solo se il modulo C-Gate.PG ha una licenza per il robot corrispondente e se il robot ha impostato l'opzione 'Gestione del programma con C-Gate'. Inoltre, nel robot deve essere memorizzato l'indirizzo C-Gate IoT Connector (se disponibile) o l'indirizzo C-Gate IoT Hub . Inoltre, nelle impostazioni del robot deve essere memorizzato il token specifico del dispositivo. Il robot deve disporre almeno della versione software QS2.12. Di tanto in tanto è utile che l'indirizzo C-Gate IoT Connector del robot sia impostato come gateway predefinito nella configurazione di rete.

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

È 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).

Per impostazione predefinita, quando viene installato C-Gate viene creato un utente con il nome admin. La password per questo utente viene generata la prima volta che il contenitore Docker viene avviato 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.

È possibile forzare una nuova password di amministrazione impostando la variabile d'ambiente APP_ADMIN_PASSWORD='NewPassword' per il contenitore C-Gate. Per un'installazione Docker con Docker Compose, ad esempio, si può 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"

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.

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

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

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

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

Linux (Docker):

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

Linux (Docker-Compose):

cd /opt/cloos/cgate/
sudo docker-compose pull
sudo 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.

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

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.

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.

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

Per un'installazione offline, l'immagine Docker e il file docker-compose corrispondente possono essere scaricati e copiati sul sistema offline. Se si seguono le istruzioni passo-passo, assicurarsi di copiare il file docker-compose.yml nella directory /opt/cloos/cgate. L'immagine Docker può essere caricata con il seguente comando:

docker load -i c-gate-iot-hub.image

È quindi possibile eseguire i normali passaggi dell'installazione diC-Gate . Il comando curl e docker login nelle istruzioni passo-passo non è necessario per l'installazione offline.

Per realizzare un proxy HTTPS, è necessario impostare un reverse proxy come descritto di seguito.

1. Attivare la funzione di Windows IIS (Internet Information Services).
2. Installare i plugin ARR (Application Request Routing) e URL Rewrite per IIS.
3. Importare il certificato desiderato per il proxy HTTPS nell'interfaccia IIS.
4. Creare una nuova pagina su IIS.
5. Nella nuova pagina, selezionare il modulo URL Rewrite e aggiungere una nuova regola come reverse proxy. Configurare la connessione HTTPS e selezionare il certificato importato.

Per istruzioni più dettagliate sull'installazione e il funzionamento del reverse proxy, consultare il sito Microsoft.

In Linux, è possibile limitare il consumo di memoria inserendo i seguenti valori nel file docker-compose.yml. In questo esempio, C-Gate è configurato per utilizzare 6 GB di RAM.

services:
  cgate:
    image: ...
    ...
    deploy:
      resources:
        limits:
           memory: 6G

Attualmente non esiste un modo per limitare il consumo di memoria in Windows.