User Support

Die Weboberfläche bietet verschiedene Möglichkeiten, um Daten zu visualisieren und C-Gate zu verwalten. Diese kann mit allen aktuellen Webbrowsern mit der zugehörigen Adresse aufgerufen werden. Falls Ihr Browser nicht kompatibel ist, werden Sie auf der Weboberfläche darauf hingewiesen und Sie erhalten eine Empfehlung.

Prozessdaten können nur angezeigt werden, wenn Sie entweder ein Carola-Programm mit dem alten Listenkonzept haben oder Sie mit dem neuen QTI-Listenkonzept arbeiten und die Steuerungssoftwareversion QS2.8 oder neuer ist.

Gleichen Sie die Prozeduren aus Ihrem MASTER-Programm mit der Dokumentation ab und passen dieses dementsprechend an. Benutzen Sie unbedingt die Prozeduren SEAMSTRT und SEAMEND, wenn Sie das Modul C-Gate.QM im Einsatz haben.

Die Gesamtanlageneffektivität (OEE) setzt sich aus den Metriken Verfügbarkeit, Leistung und Qualität zusammen. Die QINEO-Produktivität besteht aus den Metriken Verfügbarkeit und Leistung. Die genaue Berechnung können Sie der entsprechenden Dokumentation entnehmen.

Die Metrik Verfügbarkeit ist abhängig von der Kapazitätsplanung, die der geplanten Arbeitszeit entspricht. Sobald die Anlage bzw. das Gerät beispielsweise ausgeschaltet ist, wird die Anlage als nicht verfügbar bewertet. Für die Metrik Leistung ist es wichtig, dass Ihre Bauteilprogramme mit den dokumentierten Carola-Anweisungen ausgestattet sind und die Sollzeiten in den Bauteilvorlagen passend eingetragen wurden. Die Metrik Qualität wird entweder automatisch, über die Prozessdaten, oder manuell, über eine Eingabe des Werkers an der Anlage, ermittelt. Für die automatische Ermittlung werden QS2.8 oder neuer, QTI und SD-Überwachung sowie das Modul C-Gate.QM benötigt.

Die C-Gate-Zeit kann in den Einstellungen der Weboberfläche eingestellt werden. Synchronisieren Sie die Zeit entweder manuell oder tragen Sie einen Zeitserver zur automatischen Synchronisation ein.

Die Funktionen von C-Gate sind in Module aufgeteilt, die jeweils lizenziert sein müssen. Wenden Sie sich für das Lizenzieren weiterer Module bzw. Anlagen an CLOOS.

Die C-Gate Prgrammverwaltung kann nur genutzt werden, wenn für den entsprechenden Roboter das Module C-Gate.PG lizenziert ist und der Roboter die Option 'Programmverwaltung mit C-Gate' gesetzt hat. Zusätzlich muss im Roboter entweder die C-Gate IoT Connector Addresse (falls vorhanden) oder die C-Gate IoT Hub Adresse hinterlegt sein. Weiter muss das gerätespezifische Token des Roboters in der Robotereinstellungen hinterlegt sein. Der Roboter muss mindestens den Softwarestand QS2.12 haben. Von Zeit zu Zeit hilft es, wenn die Addresse des C-Gate IoT Connector im Roboter als Standard-Gateway in der Netzwerkkonfiguration gesetzt ist.

Unter Docker werden Daten üblicherweise in sogenannten Volumes abgespeichert. C-Gate verwendet für das interne Verzeichnis /data ein solches Volume.

Mit folgendem Befehlen können Sie ein Backup Ihrer Daten erstellen. Das Backup wird in dem Ordner abgelegt, in dem der Befehl ausgeführt wird.

Linux (Docker):

# Backup erstellen
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Backup wiederherstellen
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):

# Backup erstellen
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

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

Für ein tägliches Backup kann beispielsweise ein cron-job (Linux) oder ein geplanter task (Windows) verwendet werden.

Für ein konsistentes Backup wird empfohlen, die Anwendung kurzzeitig zu stoppen (docker stop cgate) und nach dem Backup wieder zu starten (docker start cgate).

Standardmäßig wird mit der Installation von C-Gate ein Benutzer mit dem Namen admin angelegt. Das Password zu diesem Benutzer wird beim ersten Start des Docker Containers generiert und auf der Kommandozeile ausgegeben. Die Ausgabe des Docker Containers können Sie sich mit dem Befehl docker logs cgate anzeigen lassen. Folgender Befehl liefert Ihnen gezielt die Ausgabe der Passwortgenerierung:

Linux (Docker):

sudo docker logs cgate | grep UserInitializer

Windows (WSL Ubuntu Shell):

podman logs cgate | grep UserInitializer

Bei der Windows-Installation werden die Zugangsdaten zusätzlich einmalig am Ende der Installation angezeigt.

Sie können ein neues Admin-Passwort erzwingen, indem Sie die Umgebungsvariable APP_ADMIN_PASSWORD='NewPassword' für Ihren C-Gate Container setzen. Bei einer Docker Installation mit Docker Compose z.B. können Sie diese Variable in der Datei docker-compose.yml unterhalb der environment Zeile setzen.

Beispiel:

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

Falls Sie C-Gate mit unserer Windows-Anleitung installiert haben, können Sie das Passwort in der Datei ~/.config/cgate/cgate.conf innerhalb der WSL mit dem Eintragen folgender Zeile setzen:

APP_ADMIN_PASSWORD="MySecretPassword"

1. Zunächst sollte eine physikalische Verbindung vorhanden sein. Für CLOOS-Roboteranlagen ist dies üblicherweise ein Netzwerkkabel verbunden mit der Robotersteuerung und Ihrem Firmennetzwerk. QINEO-Schweißgeräte können alternativ per Wifi angeschlossen werden.
2. Anschließend benötigen Ihre Geräte eine IP-Adresse und entsprechende Netzwerkeinstellungen, so dass diese von dem Server oder PC, auf denen C-Gate IoT Hub installiert ist, erreichbar sind. Wie Sie die Netzwerkeinstellungen anpassen können, entnehmen Sie bitte dem jeweiligen Gerätehandbuch. Die Netzwerkeinstellungen sollten entsprechend Ihrer IT-Richtlinien vergeben werden. Sie können die Verbindung überprüfen, indem Sie ein ping auf die Geräte-IP von dem Server oder PC mit C-Gate ausführen.
3. Folgen Sie den C-Gate-Anweisungen auf der C-Gate-Weboberfläche zur Aktivierung Ihrer Lizenz. Anschließend können Sie Ihre Geräte in der Geräte-Ansicht auf dem C-Gate konfigurieren. Tragen Sie dort die entsprechenden IP-Adressen der Geräte ein.

Ist alles richtig eingerichtet, erscheinen die Geräte in der C-Gate-Geräteansicht als Online.

Sollte dennoch keine Verbindung möglich sein, beachten Sie bitte unsere Hinweise zu Firewall-Regeln.

Folgende Ports sind für den Zugriff auf den C-Gate IoT Hub relevant:

Ohne IoT Connector baut der C-Gate IoT Hub zusätzlich zu folgenden Ports Verbindungen auf:

Mit QIROX Legacy Hardware (Hardware älter als V7) werden zusätzlich folgende Ports verwendet:

C-Gate kann mit einem neuen Container Image auf den neusten Stand gebracht werden.

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:

Im Startmenü unter dem Ordner C-Gate gibt es ein Updatescript, welches ein Update auf die aktuelle stabile Version durchführt.

Bestehende Daten werden bei einem Update der Anwendung automatisch von der Anwendung migriert. Je nach Datenmenge kann der Migrationsprozess den Start der neuen Anwendungsversion um einige Minuten verzögern. Die Anwendung steht in dieser Zeit nicht zur Verfügung.

Der C-Gate IoT Hub Container basiert auf einem aktuellen offiziellen Ubuntu Basis-Image und enthält die nachfolgenden Dienste. Nur Dienste mit entsprechender Portangabe sind von außerhalb des Containers erreichbar. Dienste ohne Portangaben sind nur innerhalb des Containers erreichbar und somit vor externen Zugriffen geschützt.

• 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

Heruntergeladene .exe Dateien werden von Windows leicht als Bedrohung eingestuft. Mit folgendem Powershell Befehl kann diese Einstufung für die Datei korrigiert werden:

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

Sollte die Installation oder Ausführung von enthaltenen Skriptdateien weiterhin blockiert werden, installieren Sie bitte unser Cloos Zertifikat in Ihrem System und versuchen Sie es erneut. Achten Sie bitte darauf bei der Installation als Speicherort für das Zertifikat "Vertrauenswürdige Stammzertifizierungsstellen" auszuwählen.

Der neue C-Gate Installer für Windows erkennt automatisch eine bisherige Installation mit Docker Desktop und importiert die Daten während der Installation. Stellen Sie bitte nach der Installation sicher, dass ihre C-Gate Installation wie gewohnt funktioniert. Anschließend löschen Sie bitte den C-Gate Container aus Docker Desktop, damit dieser nicht nach einem Neustart wieder automatisch startet.

Bei einer älteren C-Gate Installation unter Windows wurden die Zugangsdaten zum CLOOS Docker Repository zum Teil nicht permanent gespeichert. Um das Problem zu beheben, führen Sie bitte folgenden Befehl in Ihrer WSL Installation (Ubuntu) aus und geben Sie die Zugangsdaten ein, die Sie mit Ihrer C-Gate Lizenz erhalten haben:

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