C-Gate IoT Hub

Eerste stappen

De C-Gate IoT Hub wordt geleverd als software in een containerformaat. Het wordt aanbevolen om de C-Gate IoT Hub op een centrale server per bedrijfslocatie te installeren. Ook installatie op een standaard PC is mogelijk.

Systeemvereisten

  • Container runtime-omgeving (bijv. Docker, Kubernetes, OpenShift, Podman, ...)
  • 8 GB RAM
  • 128 GB harde schijfruimte
  • 64-bits processor (4 kernen aanbevolen)
  • Internetverbinding (tijdens installatie en update)
Indien meer dan 25 regelaars worden aangesloten, kunnen de vereisten groter zijn.

C-Gate IoT Hub Container

De C-Gate IoT Hub container is beschikbaar in de Docker Registry van CLOOS. U ontvangt de nodige toegangsgegevens bij aankoop van een C-Gate IoT Hub .

Register en beeld URL

docker.cloos.de/cgate

Voorbeeld van een testomgeving met Docker

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

Voorbeeld van een productieve omgeving met 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 slaat alle configuraties en gegevens op in de directory /data. Voor deze map moet een volume worden gebruikt om de gegevens te bewaren.

Blootliggende poorten

Variabelen

APP_ADMIN_PASSWORD

Forceert een wachtwoord voor de admin-gebruiker.

Standaardwaarde: Leeg

APP_MAX_DATA_SIZE

Stelt de maximale grootte van de totale door C-Gate opgeslagen gegevens in GB in.

Standaardwaarde: 32

Stap-voor-stap handleiding

Als u nog geen container runtime-omgeving gebruikt, leiden de volgende instructies u door de noodzakelijke stappen voor een basis container runtime-omgeving met C-Gate. In dat geval raden wij u aan u toch vertrouwd te maken met uw containeromgeving om deze veilig te kunnen bedienen.

Linux Aanbeveling!

  1. Installeer Docker voor je Linux-distributie. Let op dat je Docker niet meerdere keren installeert (bijvoorbeeld via de pakketbeheerders apt-get en snap).
  2. Voer de volgende commando's uit om C-Gate te installeren en te starten: 
    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
# Voer hier de toegangsgegevens in die u van CLOOS hebt ontvangen.
sudo docker compose up -d
# C-Gate wordt nu op de achtergrond gestart. Na 1-2 minuten heb je toegang tot C-Gate met je browser.

Windows

We raden aan om te installeren onder een Linux-besturingssysteem, omdat containers daar al enkele jaren bestaan. Onder Windows daarentegen zijn containers nog nieuw. Je kunt daarom vaker wijzigingen verwachten, een iets hoger resourceverbruik en meer uitdagingen tijdens de installatie en het gebruik.

We raden aan om te installeren onder een Linux-besturingssysteem, omdat containers daar al enkele jaren bestaan. Onder Windows daarentegen zijn containers nog nieuw. Je kunt daarom vaker wijzigingen verwachten, een iets hoger resourceverbruik en meer uitdagingen tijdens de installatie en het gebruik.

  1. Zorg ervoor dat de nieuwste update voor Windows is geïnstalleerd. Je hebt minimaal Windows 10 nodig vanaf versienummer 2004 (Build 19041) of Windows 11. In de regel zijn Windows Server-versies niet geschikt.

    Om de Windows-versie weer te geven, kan het volgende commando op de opdrachtregel worden uitgevoerd: 
    winver
    De geïnstalleerde toepassing start met een zogenaamde 'Windows-taak' nadat de gebruiker zich heeft aangemeld. Selecteer desgewenst een gebruiker voor wie je de aanmeldingsgegevens in de zogenaamde 'Windows task' kunt opslaan, zodat de toepassing ook zonder aanmelding van de gebruiker automatisch kan starten en niet opnieuw wordt gestopt als de gebruiker zich afmeldt.
  2. Installeer WSL (Windows Subsystem for Linux) met de volgende commando's op de opdrachtregel: 
    wsl --set-default-version 2
# Kies hieronder een willekeurige gebruikersnaam en wachtwoord.
# Het is niet nodig hier de CLOOS-toegangsgegevens in te voeren.
wsl --install -d Ubuntu
wsl --set-default Ubuntu
  3. Start de toepassing 'Ubuntu'. Je vindt de toepassing via het Windows Start-menu. Stel een gebruikersnaam en wachtwoord in als daarom wordt gevraagd. Sluit vervolgens het venster.
  4. Installeer C-Gate met onze C-Gate IoT Hub Installer voor Windows.

Na de installatie

De volgende stappen en verdere informatie zijn te vinden op de C-Gate webinterface. Deze is na de installatie toegankelijk via http://localhost op uw server of PC.

Vanaf een andere computer kunt u C-Gate bereiken via http://[serverip], waarbij [serverip] moet worden vervangen door het IP van uw server of PC waarop C-Gate is geïnstalleerd.

Problemen met de installatie?

Gebruikersondersteuning U vindt antwoorden op veelgestelde vragen en verdere documentatie op .