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. Veillez à ne pas installer Docker plusieurs fois (p. ex. via les gestionnaires de paquets apt-get et snap).
  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.

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. En règle générale, les versions Windows Server ne conviennent pas.

    Pour afficher la version de Windows, la commande suivante peut être exécutée sur la ligne de commande :
    winver
    L'application installée démarre avec ce que l'on appelle une "tâche Windows" après la connexion de l'utilisateur. Sélectionnez un utilisateur pour lequel vous pouvez, si nécessaire, enregistrer les données de connexion dans la "tâche Windows", afin que l'application puisse démarrer automatiquement même si l'utilisateur n'est pas connecté et qu'elle ne s'arrête pas à la déconnexion de l'utilisateur.
  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. Démarrez l'application 'Ubuntu'. Vous pouvez trouver l'application dans le menu Démarrer de Windows. Configurez un nom d'utilisateur et un mot de passe si vous y êtes invité. Fermez ensuite la fenêtre.
  4. 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.