Le C-Gate IoT Hub est mis à disposition sous forme de logiciel dans un format conteneur. Il est recommandé d'installer le C-Gate IoT Hub sur un serveur central par site d'entreprise. Alternativement, une installation sur un PC ordinaire est également possible.

Configuration requise

  • Environnement d'exécution des conteneurs (par ex. Docker, Kubernetes, OpenShift, Podman, ...)
  • 8 GO DE MÉMOIRE VIVE
  • 128 Go d'espace disque
  • Processeur 64 bits (4 cœurs recommandés)
  • Connexion Internet (pendant l'installation et la mise à jour)
Si plus de 25 commandes sont connectées, les conditions préalables peuvent être plus importantes.

C-Gate IoT Hub Conteneur

Le conteneur C-Gate IoT Hub est mis à disposition dans le registre Docker de CLOOS. Vous obtiendrez les données d'accès nécessaires à cet effet lors de l'achat d'un C-Gate IoT Hub .

Registre et URL de l'image

docker.cloos.de/cgate

Exemple d'environnement de test avec Docker

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

Exemple d'environnement de production avec 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:

Volumes

C-Gate place toutes les configurations et données dans le répertoire /data. Pour ce répertoire, il convient d'utiliser un volume afin de conserver les données.

Ports exposés

  • 4840 (OPC UA Server)
  • 5000/tcp (Communication robotique jusqu'à V6)
  • 5000/udp (Communication robotique jusqu'à V6)
  • 5005 (Communication robotique jusqu'à V6)
  • 5010 (Communication robotique jusqu'à V6)
  • 5679 (IoT Connector RPC)
  • 8080 (Web Interface)

Variables

APP_ADMIN_PASSWORD

Force un mot de passe pour l'utilisateur admin.

Valeur par défaut: Vide

APP_MAX_DATA_SIZE

Définit la taille maximale des données stockées par C-Gate en Go.

Valeur par défaut: 32

Instructions pas à pas

Si vous n'utilisez pas encore d'environnement d'exécution de conteneur, les instructions suivantes vous guideront à travers les étapes nécessaires pour un environnement d'exécution de conteneur de base avec C-Gate. Dans ce cas, nous vous recommandons néanmoins de vous familiariser avec votre environnement de conteneurs afin de pouvoir l'exploiter en toute sécurité.

  1. Installez Docker pour votre distribution Linux.
  2. Exécutez les commandes suivantes pour installer et démarrer 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
    # Saisissez ici les données d'accès que vous avez reçues de CLOOS.
    sudo docker compose up -d
    # Donnez à l'application quelques secondes pour démarrer.
    # Lisez le mot de passe généré pour l'utilisateur admin à l'aide de la commande suivante:
    sudo docker logs cgate | grep UserInitializer

Nous vous recommandons une installation sous un système d'exploitation Linux, car les conteneurs y sont déjà établis depuis quelques années. Sous Windows, en revanche, les conteneurs sont encore nouveaux. Il faut donc s'attendre à des changements plus fréquents, à une légère augmentation de la consommation de ressources et à davantage de défis lors de l'installation et de l'exploitation.

  1. Assurez-vous que la dernière mise à jour de Windows est installée. Vous avez besoin au minimum de Windows 10 à partir du numéro de version 2004 (build 19041) ou de Windows 11.

    Pour afficher la version de Windows, la commande suivante peut être exécutée sur la ligne de commande :
    winver
  2. Installez WSL (Windows Subsystem for Linux) en utilisant les commandes suivantes sur la ligne de commande:
    wsl --set-default-version 2
    # Choisissez ci-dessous un nom d'utilisateur et un mot de passe de votre choix.
    # Il n'est pas nécessaire d'indiquer ici les données d'accès de CLOOS.
    wsl --install -d Ubuntu
    wsl --set-default Ubuntu
  3. Installez C-Gate avec notre installateurC-Gate IoT Hub pour Windows.

Après l'installation

Vous trouverez les étapes suivantes et d'autres informations sur l'interface web C-Gate. Vous pouvez y accéder après l'installation à l'adresse http://localhost sur votre serveur ou votre PC.

Depuis un autre ordinateur, vous pouvez atteindre C-Gate à l'adresse http://[serverip], où [serverip] doit être remplacé par l'IP de votre serveur ou PC sur lequel C-Gate a été installé.

Foire aux questions

Où sont stockées mes données C-Gate?

Sous Docker, les données sont généralement stockées dans des volumes. C-Gate utilise un tel volume pour le répertoire interne /data.

Comment puis-je faire une sauvegarde de mes données C-Gate?

Les commandes suivantes vous permettent de créer une sauvegarde de vos données. La sauvegarde est placée dans le dossier dans lequel la commande est exécutée.

Linux (Docker):
# Créer une sauvegarde
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Restaurer une sauvegarde
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):
# Créer une sauvegarde
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

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

Pour une sauvegarde quotidienne, on peut par exemple utiliser une tâche cron (Linux) ou une tâche planifiée (Windows).

Pour une sauvegarde cohérente, il est recommandé d'arrêter brièvement l'application (docker stop cgate) et de la redémarrer après la sauvegarde (docker start cgate).

C-Gate me demande des données d'accès au démarrage. Que dois-je saisir ?

Par défaut, un utilisateur portant le nom admin est créé lors de l'installation de C-Gate. Le mot de passe correspondant à cet utilisateur est généré lors du premier démarrage du conteneur Docker et affiché sur la ligne de commande. Vous pouvez afficher la sortie du conteneur Docker avec la commande docker logs cgate. La commande suivante vous fournit de manière ciblée la sortie de la génération du mot de passe :

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

Lors de l'installation de Windows, les données d'accès sont en outre affichées une seule fois à la fin de l'installation.

Comment réinitialiser mon mot de passe ?

Vous pouvez forcer un nouveau mot de passe admin en définissant la variable d'environnement APP_ADMIN_PASSWORD='NewPassword' pour votre conteneur C-Gate. Pour une installation Docker avec Docker Compose par exemple, vous pouvez définir cette variable dans le fichier docker-compose.yml sous la ligne environment.

exemple :

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

Si vous avez installé C-Gate en suivant nos instructions pour Windows, vous pouvez définir le mot de passe dans le fichier ~/.config/cgate/cgate.conf à l'intérieur de la WSL en saisissant la ligne suivante:

APP_ADMIN_PASSWORD="MySecretPassword"

Comment connecter mes appareils à C-Gate?
  1. Tout d'abord, une connexion physique doit être disponible. Pour les installations robotisées CLOOS, il s'agit généralement d'un câble réseau relié à la commande du robot et au réseau de votre entreprise. Les soudeuses QINEO peuvent également être connectées par Wifi.
  2. Ensuite, vos appareils ont besoin d'une adresse IP et des paramètres réseau correspondants, afin qu'ils soient accessibles depuis le serveur ou l'ordinateur sur lequel C-Gate IoT Hub est installé. Pour savoir comment ajuster les paramètres réseau, veuillez consulter le manuel de chaque appareil. Les paramètres réseau doivent être attribués conformément à votre politique informatique. Vous pouvez vérifier la connexion en exécutant un ping sur l'IP de l'appareil à partir du serveur ou de l'ordinateur avec C-Gate. Vous pouvez également vérifier la connexion en exécutant un sur le serveur ou l'ordinateur avec .
  3. Suivez les instructions C-Gate sur l'interface web C-Gate pour activer votre licence. Vous pouvez ensuite configurer vos appareils dans l'aperçu des appareils sur C-Gate. Inscrivez-y les adresses IP correspondantes des appareils.

Si tout est correctement configuré, les appareils apparaissent comme étant en ligne dans la vue des appareils C-Gate.

Si toutefois la connexion n'est pas possible, veuillez consulter nos remarques sur les règles de pare-feu.

Quelles règles de pare-feu et quels ports doivent être respectés ?

Les ports suivants sont pertinents pour l'accès à C-Gate IoT Hub :

Entrant 80 TCP Interface web et API
Entrant 4840 TCP Serveur OPC UA pour la connexion de vos systèmes MES et ERP
Entrant 5679 TCP Interface RPC pour le site C-Gate IoT Connector

Sans IoT Connector, le site C-Gate IoT Hub établit en outre des connexions avec les ports suivants :

Sorti 48010 TCP Installations robotisées
Sorti 52341 TCP Appareils de soudage
Sorti 4840 TCP API

Avec le matériel QIROX Legacy (matériel antérieur à la V7), les ports suivants sont également utilisés :

Entrant 5000 TCP
Entrant 5000 UDP
Entrant 5005 TCP
Entrant 5010 TCP

Comment puis-je mettre à jour C-Gate IoT Hub ?

C-Gate peut être mis à jour avec une nouvelle image de conteneur.

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:

Dans le menu de démarrage, sous le dossier C-Gate, il y a un script de mise à jour qui effectue une mise à jour vers la version stable actuelle.

Les données existantes sont automatiquement migrées par l'application lors d'une mise à jour de l'application. Selon la quantité de données, le processus de migration peut retarder de quelques minutes le lancement de la nouvelle version de l'application. L'application n'est pas disponible pendant ce temps.

Que trouve-t-on à l'intérieur du conteneur C-Gate?

Le conteneur C-Gate IoT Hub est basé sur une image de base officielle actuelle d'Ubuntu et contient les services suivants. Seuls les services dont le port est indiqué sont accessibles depuis l'extérieur du conteneur. Les services sans indication de port ne sont accessibles qu'à l'intérieur du conteneur et sont donc protégés des accès externes.

  • 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

Pourquoi Windows bloque-t-il l'exécution de l'installation C-Gate?

Les fichiers .exe téléchargés sont facilement classés comme menace par Windows. La commande Powershell suivante permet de corriger cette classification pour le fichier:

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

Si l'installation ou l'exécution des fichiers scripts inclus est toujours bloquée, veuillez installer notre certificat Cloos dans votre système et réessayer. Lors de l'installation, veillez à sélectionner "Autorités de certification racines de confiance" comme emplacement pour le certificat.

J'ai installé C-Gate sous Windows manuellement avec Docker Desktop. Comment puis-je migrer mes données vers la nouvelle version avec le programme d'installation C-Gate?

Le nouvel installateur C-Gate pour Windows détecte automatiquement une installation précédente avec Docker Desktop et importe les données pendant l'installation. Après l'installation, veuillez vous assurer que votre installation C-Gate fonctionne comme d'habitude. Ensuite, veuillez supprimer le conteneur C-Gate de Docker Desktop afin qu'il ne redémarre pas automatiquement après un redémarrage.

La mise à jour de mon installation C-Gate sous Windows signale une erreur avec les données d'accès. Comment puis-je y remédier ?

Dans une ancienne installation C-Gate sous Windows, les données d'accès au CLOOS Docker Repository n'étaient parfois pas enregistrées de manière permanente. Pour remédier à ce problème, veuillez exécuter la commande suivante dans votre installation WSL (Ubuntu) et saisir les données d'accès que vous avez reçues avec votre licence C-Gate:

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