Premiers pas

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

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é.

Linux Recommandation !

  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

Windows

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é.

Problèmes lors de l'installation ?

Dans la section Assistance aux utilisateurs, vous trouverez les réponses aux questions les plus fréquemment posées ainsi que d'autres documentations.